@migor/agentia 0.10.4 → 0.10.6

package/dist/transport/run-outcome.js

@@ -34,6 +34,23 @@ export async function readClaimed(store, rec) {
  * `suspendedReason` / `wakeAt`，所以必须在本件**之后**调用 —— 顺序是承重的）。
  */
 export function applySuspendedOutcome(rec, result, suspendedMessages, ctx) {
+    // 同一轮等待的判定（2026-11-07 深评 F2）：事件投递会把 approval 挂起的任务叫醒，但
+    // 引擎发现决定仍不齐会**原样再挂起**（同一批 pending）。若无条件把 suspendedSince
+    // 刷成 now，每 < approvalTimeoutMs 投一条事件就能把审批超时永久推迟。
+    // 只有「新的一轮等待」（非续跑 / 待决集合变了 / 原因变了）才重置计时基准。
+    const previousPending = rec.pendingApprovals;
+    const samePendingSet = previousPending !== undefined &&
+        result.pendingApprovals !== undefined &&
+        previousPending.length === result.pendingApprovals.length &&
+        previousPending.every((id, i) => id === result.pendingApprovals[i]);
+    const sameWait = ctx.isResume &&
+        rec.suspendedReason === result.suspendedReason &&
+        (result.suspendedReason !== 'approval' ||
+            (samePendingSet &&
+                // 只要旧决定还在，就不能沿用 since：那条决定可能**已经被上一段消费**，
+                // 沿用会让这一次同名等待直接复用它（审批绕过）。F2 要保留的是「纯事件唤醒、
+                // 一个决定都还没做」的时钟。
+                previousPending?.every((id) => rec.approvals?.[id] === undefined) === true));
     // HITL 挂起不是终态：槽位照常释放、onFinished 不触发、finishedAt 不置 —— 那三件事各自
     // 在自己的出口判（`#execute` 的 finally），这里只负责把记录改成「在等」的样子。
     rec.status = 'suspended';
@@ -44,11 +61,14 @@ export function applySuspendedOutcome(rec, result, suspendedMessages, ctx) {
     const snapshot = !ctx.isResume && rec.spec.options?.sessionId !== undefined && ctx.hasSessionStore
         ? rec.spec.messages
         : undefined;
+    // 快照同时进记录：内存 Map 只是本进程快路，重启后由它接着补写会话。
+    if (snapshot !== undefined)
+        rec.sessionInput = snapshot;
     // 扩展后的消息历史（末尾是含未决 tool_use 的 assistant 消息）与待决清单、挂起时刻一起落库
     // —— approve / 惰性超时 / 重启后都靠它们。
     rec.spec = { ...rec.spec, messages: suspendedMessages };
     rec.pendingApprovals = result.pendingApprovals;
-    rec.suspendedSince = ctx.now;
+    rec.suspendedSince = sameWait && rec.suspendedSince !== undefined ? rec.suspendedSince : ctx.now;
     // 挂起原因：从结果形状里取，**不写死** —— 写死成 'approval' 会让将来新增的挂起原因在落库
     // 这一步被悄悄改写成审批。
     rec.suspendedReason = result.suspendedReason;

package/dist/transport/run-outcome.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-outcome.js","sourceRoot":"","sources":["../../src/transport/run-outcome.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA6CjD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAgB,EAChB,GAAe;IAEf,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAeD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAe,EACf,MAAsB,EACtB,iBAAiC,EACjC,GAA4B;IAE5B,4DAA4D;IAC5D,mDAAmD;IACnD,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;IACzB,kEAAkE;IAClE,yDAAyD;IACzD,oDAAoD;IACpD,qCAAqC;IACrC,MAAM,QAAQ,GACZ,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,eAAe;QAC/E,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ;QACnB,CAAC,CAAC,SAAS,CAAC;IAChB,yDAAyD;IACzD,+BAA+B;IAC/B,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IACxD,GAAG,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAC/C,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC;IAC7B,wDAAwD;IACxD,eAAe;IACf,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;IAC7C,mCAAmC;IACnC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,iDAAiD;IACjD,0CAA0C;IAC1C,sCAAsC;IACtC,IAAI,MAAM,CAAC,eAAe;QAAE,GAAG,CAAC,aAAa,GAAG,SAAS,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAaD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAe,EACf,GAAe,EACf,GAA2B;IAE3B,gEAAgE;IAChE,6BAA6B;IAC7B,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;IAC1D,yDAAyD;IACzD,2DAA2D;IAC3D,iBAAiB;IACjB,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,YAAY,EAAE,CAAC;IACzE,mCAAmC;IACnC,GAAG,CAAC,gBAAgB,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,cAAc,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,eAAe,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;IACvB,kDAAkD;IAClD,kDAAkD;IAClD,mDAAmD;IACnD,2DAA2D;IAC3D,uDAAuD;IACvD,wDAAwD;IACxD,4BAA4B;IAC5B,GAAG,CAAC,aAAa,GAAG,SAAS,CAAC;IAC9B,OAAO,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC;AACxD,CAAC"}
+{"version":3,"file":"run-outcome.js","sourceRoot":"","sources":["../../src/transport/run-outcome.ts"],"names":[],"mappings":"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"}

package/dist/transport/serve.js

@@ -59,6 +59,16 @@ export function gracefulShutdown(opts) {
                 }
                 for (const s of signals)
                     process.off(s, onSignal);
+                // Node 的默认终止动作是在**信号投递那一刻**按「有没有监听者」决定的；在 handler
+                // 里替当前信号摘监听不会补做默认动作 ⇒ 第二次信号被吞掉，必须第三次才死
+                // （2026-11-07 深评 F10，实测第 2 次 SIGTERM 后进程仍存活）。重新投递一次。
+                //
+                // ⚠️ 前提收紧（2026-11-09 深评 P3-5）：这里能走默认终止，是因为**本件的**监听已经
+                // 摘掉。宿主若为同一信号另注册了 handler，重新投递会交给它的 handler —— 它不退出
+                // 就还是不终止（`process.kill` 的返回值看不出这件事）。要在任何宿主下都保证「第二次
+                // 必死」，用 `onSecondSignal` 自己 `process.exit(128 + n)`；本件不替宿主决定这件事，
+                // 因为它可能还有自己的最后一跳要跑。
+                process.kill(process.pid, signal);
                 return;
             }
             first = false;

package/dist/transport/serve.js.map

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

package/dist/transport/signal-supervisor.d.ts

@@ -27,6 +27,7 @@
 import type { TaskEvent } from '../core/run.js';
 import type { TaskRecord, TaskStore } from '../store/store.js';
 import type { ApprovalSupervisor } from './approval-supervisor.js';
+import { TaskWakeGate } from './task-wake-gate.js';
 /**
  * `signalTask` 的失败：带 HTTP 语义的状态码（404 = 任务不存在，409 = 任务当前不在
  * `suspended` 状态 / 同 eventId 已投递）。形状与 `async.ts` 的 `TaskCancelError` 同款
@@ -45,6 +46,8 @@ export interface SignalSupervisorDeps {
     approvals: ApprovalSupervisor;
     /** 派发入口（`AsyncRunner.#dispatch`：停机闸 + 唯一派发点 + 停机窗口里的一次告警） */
     dispatch(rec: TaskRecord): void;
+    /** 跨唤醒路径的 per-task 互斥闸（2026-11-07 深评 P1，与 approve / wakeDue 共用） */
+    wakeGate?: TaskWakeGate;
     /**
      * cancel 的 per-task 在飞闸读数（2026-10-13 ref-run-root-close）：投递进入前等它收口再重判
      * （否则事件落库与 cancelled 落库互相覆盖，两边都说了假话）。

package/dist/transport/signal-supervisor.js

@@ -1,3 +1,4 @@
+import { TaskWakeGate } from './task-wake-gate.js';
 /**
  * `signalTask` 的失败：带 HTTP 语义的状态码（404 = 任务不存在，409 = 任务当前不在
  * `suspended` 状态 / 同 eventId 已投递）。形状与 `async.ts` 的 `TaskCancelError` 同款
@@ -39,8 +40,11 @@ export class SignalSupervisor {
     /** 同一任务的在飞事件投递（`signalTask` 的重入闸，见下） */
     #inflight = new Map();
     #deps;
+    /** 共享闸；单测可省略（省略时本件自建一把，跨路径互斥只在 AsyncRunner 注入时生效） */
+    #wakeGate;
     constructor(deps) {
         this.#deps = deps;
+        this.#wakeGate = deps.wakeGate ?? new TaskWakeGate();
     }
     /**
      * 投递一个事件给**挂起**的任务（2026-09-28 ref-run-event-input，run 事件投入口；
@@ -86,7 +90,7 @@ export class SignalSupervisor {
         const prev = this.#inflight.get(taskId);
         const run = Promise.resolve(prev)
             .catch(() => undefined) // 前一次的 reject 已由它自己的调用方接走，这里只排队
-            .then(() => this.#signalInner(taskId, event))
+            .then(() => this.#wakeGate.run(taskId, () => this.#signalInner(taskId, event)))
             .finally(() => {
             // 只摘自己：链上可能已有更新的节点（无条件 delete 会摘掉别人的）
             if (this.#inflight.get(taskId) === run)

package/dist/transport/signal-supervisor.js.map

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

package/dist/transport/stream-janitor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 跨进程 SSE 流的**兜底收口**（2026-11-07 深评 F5；2026-11-09 深评 P2-1 提到 runner 级）。
+ *
+ * 本进程的 `TaskEventStreams.markDone` 只覆盖「本进程把任务写到终态」；任务在**别的进程**
+ * 被 approve / 到期唤醒并跑完时，本进程那条流既没有 `push` 也没有 `markDone`，只剩心跳。
+ * 这个纯件做低频 store 轮询：终态 → 交给调用方 markDone（由 onDone 发 end）；
+ * 记录消失 / 已换主 → 发流级 closed。
+ *
+ * **为什么是「一组」而不是「一条流一个 janitor」**（P2-1）：此前每个 SSE 订阅各建一个
+ * `setInterval`、每拍各 `store.get` 一次 —— N 个并发连接就是 N 个定时器 + N/5 QPS（SQLite 下
+ * 是 N/5 次读锁），而 `unref()` 只保证不挂住进程、不减少读放大。同一个 taskId 的多个订阅
+ * 本来该看**同一份**记录，现在由 runner 持有一个扫描器：一拍里每个**任务**只读一次 store，
+ * 再把结论分发给该任务的各个订阅。单连接仍是「登记 / 注销」。
+ *
+ * 不碰 store、不认识 trace：poll / isTerminal / 收口都以回调注入，单测可直接驱动
+ * （喂一个假 poll + 假计时，不碰真 store）。
+ */
+/** 轮询只需要这两个字段：本进程归属 + 是否终态（由 `isTerminal` 判） */
+export interface StreamJanitorRecord {
+    ownerId?: string | undefined;
+}
+/** 一条流的收口回调（同一任务的多个订阅各有一份） */
+export interface StreamJanitorTarget {
+    isTerminal: (rec: StreamJanitorRecord) => boolean;
+    /** 任务已终态：调用方负责 markDone（终态帧由既有 onDone 发） */
+    onTerminal: () => void;
+    /** 任务记录消失 / 后续段在别的进程：发流级 closed 并收口 */
+    onClosed: () => void;
+}
+export interface StreamJanitorGroupDeps {
+    /** 读一条记录；同步 store 抛错、异步 store reject 都按「这一拍读不动，下一拍再试」处理 */
+    poll: (taskId: string) => Promise<StreamJanitorRecord | undefined>;
+    /** 本进程 ownerId */
+    ownerId: string;
+    /** 扫描间隔（毫秒）；<= 0 = 不启动定时器 */
+    pollMs: number;
+}
+export interface StreamJanitorGroup {
+    /** 登记一条流；返回注销函数（幂等） */
+    add(taskId: string, target: StreamJanitorTarget): () => void;
+    /** 停掉定时器并清空登记（runner 停机 / 测试收尾） */
+    close(): void;
+}
+/** 启动（或复用）扫描器。定时器**有登记才存在**：没有订阅时零成本。 */
+export declare function createStreamJanitorGroup(deps: StreamJanitorGroupDeps): StreamJanitorGroup;

package/dist/transport/stream-janitor.js

@@ -0,0 +1,137 @@
+/**
+ * 跨进程 SSE 流的**兜底收口**（2026-11-07 深评 F5；2026-11-09 深评 P2-1 提到 runner 级）。
+ *
+ * 本进程的 `TaskEventStreams.markDone` 只覆盖「本进程把任务写到终态」；任务在**别的进程**
+ * 被 approve / 到期唤醒并跑完时，本进程那条流既没有 `push` 也没有 `markDone`，只剩心跳。
+ * 这个纯件做低频 store 轮询：终态 → 交给调用方 markDone（由 onDone 发 end）；
+ * 记录消失 / 已换主 → 发流级 closed。
+ *
+ * **为什么是「一组」而不是「一条流一个 janitor」**（P2-1）：此前每个 SSE 订阅各建一个
+ * `setInterval`、每拍各 `store.get` 一次 —— N 个并发连接就是 N 个定时器 + N/5 QPS（SQLite 下
+ * 是 N/5 次读锁），而 `unref()` 只保证不挂住进程、不减少读放大。同一个 taskId 的多个订阅
+ * 本来该看**同一份**记录，现在由 runner 持有一个扫描器：一拍里每个**任务**只读一次 store，
+ * 再把结论分发给该任务的各个订阅。单连接仍是「登记 / 注销」。
+ *
+ * 不碰 store、不认识 trace：poll / isTerminal / 收口都以回调注入，单测可直接驱动
+ * （喂一个假 poll + 假计时，不碰真 store）。
+ */
+/** 启动（或复用）扫描器。定时器**有登记才存在**：没有订阅时零成本。 */
+export function createStreamJanitorGroup(deps) {
+    const targets = new Map();
+    let timer;
+    let closed = false;
+    let ticking = false;
+    const stopTimer = () => {
+        if (timer === undefined)
+            return;
+        clearInterval(timer);
+        timer = undefined;
+    };
+    const ensureTimer = () => {
+        if (closed || timer !== undefined || deps.pollMs <= 0)
+            return;
+        timer = setInterval(() => void tick(), deps.pollMs);
+        timer.unref?.();
+    };
+    const safe = (fn) => {
+        try {
+            fn();
+        }
+        catch {
+            /* 收口回调自己的错不得变成 unhandled（观测不击穿业务） */
+        }
+    };
+    /** 一拍只读一次 store：同任务的多个订阅共用这次结果 */
+    const checkOne = async (taskId) => {
+        const first = targets.get(taskId);
+        if (first === undefined)
+            return;
+        let rec;
+        try {
+            rec = await deps.poll(taskId);
+        }
+        catch {
+            // 同步 store（已 close）的 poll 可能同步抛、异步 store 可能 reject：
+            // 两种都按「这一拍读不动」处理 —— 定时器回调里逃出去就是 uncaughtException。
+            return;
+        }
+        if (closed)
+            return;
+        // poll 期间流可能已经关掉 / 换主：重新取一次，别拿过期快照去调回调
+        const live = targets.get(taskId);
+        if (live === undefined)
+            return;
+        for (const target of [...live]) {
+            if (!live.has(target))
+                continue;
+            if (rec === undefined) {
+                live.delete(target);
+                safe(target.onClosed);
+                continue;
+            }
+            if (target.isTerminal(rec)) {
+                live.delete(target);
+                safe(target.onTerminal);
+                continue;
+            }
+            if (rec.ownerId !== undefined && rec.ownerId !== deps.ownerId) {
+                live.delete(target);
+                safe(target.onClosed);
+            }
+        }
+        if (live.size === 0)
+            targets.delete(taskId);
+    };
+    /** 扫描一拍。上一拍还没跑完（poll 慢）⇒ 跳过，不叠请求 */
+    const tick = async () => {
+        if (closed || ticking || targets.size === 0)
+            return;
+        ticking = true;
+        try {
+            await Promise.all([...targets.keys()].map((taskId) => checkOne(taskId)));
+        }
+        catch {
+            // 一拍里的意外不得外逃：`setInterval` 回调里的 rejection 就是 unhandledRejection
+            // （Node ≥15 终止宿主）—— 观测路径不允许有这种出口。下一拍照常继续。
+        }
+        finally {
+            ticking = false;
+            if (targets.size === 0)
+                stopTimer();
+        }
+    };
+    return {
+        add(taskId, target) {
+            if (closed)
+                return () => { };
+            let set = targets.get(taskId);
+            if (set === undefined) {
+                set = new Set();
+                targets.set(taskId, set);
+            }
+            set.add(target);
+            ensureTimer();
+            let removed = false;
+            return () => {
+                if (removed)
+                    return; // 幂等：调用方可能在连接关闭路径上重复调
+                removed = true;
+                const live = targets.get(taskId);
+                if (live === undefined)
+                    return;
+                live.delete(target);
+                if (live.size === 0)
+                    targets.delete(taskId);
+                // 最后一条流也走了 ⇒ 定时器不必再跑（下一个订阅到来时重新起）
+                if (targets.size === 0)
+                    stopTimer();
+            };
+        },
+        close() {
+            closed = true;
+            targets.clear();
+            stopTimer();
+        },
+    };
+}
+//# sourceMappingURL=stream-janitor.js.map

package/dist/transport/stream-janitor.js.map

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

package/dist/transport/task-wake-gate.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 每条任务的**唤醒互斥闸**（approve / signalTask / 审批超时 / 到期唤醒共用）。
+ *
+ * 为什么需要它（2026-11-07 深度评审 P1）：四条唤醒路径各自有「在飞闸」，但**互不登记、互不查看**。
+ * `approve` 与 `wakeDue` 靠挂起原因天然互斥；而 `signalTask` 对两种挂起原因都放行 ⇒
+ * `approve × signalTask`、`wakeDue × signalTask` 可以并发。两边都先 `get` 到同一份 suspended
+ * 快照，再各自 `status='running'` + `save` + `dispatch` ⇒ 同一任务被 `#execute` 两次，
+ * 后写的那份记录还可能把已完成的段覆盖回 suspended、丢掉审批决定。
+ *
+ * 语义：**同一 taskId 上，进入本闸的唤醒路径串行**。最后一个登记的 tail 会在它及其之前
+ * 所有路径收口后才 resolve，所以 `cancel` 只要 `await gate.tail(taskId)` 就能等到
+ * 「此刻已登记的全部唤醒」—— 不需要知道它具体是 approve 还是 signal。
+ *
+ * 与各监督件自己的 `#inflight` 的关系：那些闸仍保留（approve 的「并发重入共享同一次」
+ * 语义依赖它；signal 的事件串行链也依赖它），本闸只负责**跨路径**互斥。两边在同一同步段
+ * 登记，先登记者赢。
+ *
+ * 纯件：不碰 store、不认识记录，只做「同一 key 的 Promise 串行」。单测见
+ * `tests/transport/task-wake-gate.test.ts`。
+ *
+ * ⚠️ **隐含前提：`fn` 必须最终 settle**（2026-11-09 深评「待确认」）。等待链**没有超时** ——
+ * 若某条路径的 `fn` 永远挂着（典型：宿主 store 的 `save` 不返回），同任务后续所有唤醒会
+ * 永久排队，`cancel` 的 `await tail` 也会一起挂住。当前四个调用点的 `fn` 只碰 store，
+ * 属于「宿主必须把 store 实现成会 settle」的契约；要打破它得在闸上加超时，而超时语义
+ * （「超时后放行」= 互斥失效）比挂住更危险，所以这里选择写明前提而不是加计时器。
+ */
+export declare class TaskWakeGate {
+    #private;
+    /** 该任务上是否已有登记（排队中或执行中）——惰性路径据此跳过本轮 */
+    busy(taskId: string): boolean;
+    /** 该任务上全部已登记路径的收口 Promise；没有则为 undefined */
+    tail(taskId: string): Promise<unknown> | undefined;
+    /**
+     * 串行执行：前一条（若存在）收口后才开始 `fn`。
+     *
+     * `fn` 的同步前段（第一个 await 之前）在**调用者的同步段**里执行 —— 与不加闸时
+     * 的时序一致，既有「进闸后立刻重读」的测试不会因为多了一个微任务而变味。
+     */
+    run<T>(taskId: string, fn: () => Promise<T>): Promise<T>;
+}

package/dist/transport/task-wake-gate.js

@@ -0,0 +1,69 @@
+/**
+ * 每条任务的**唤醒互斥闸**（approve / signalTask / 审批超时 / 到期唤醒共用）。
+ *
+ * 为什么需要它（2026-11-07 深度评审 P1）：四条唤醒路径各自有「在飞闸」，但**互不登记、互不查看**。
+ * `approve` 与 `wakeDue` 靠挂起原因天然互斥；而 `signalTask` 对两种挂起原因都放行 ⇒
+ * `approve × signalTask`、`wakeDue × signalTask` 可以并发。两边都先 `get` 到同一份 suspended
+ * 快照，再各自 `status='running'` + `save` + `dispatch` ⇒ 同一任务被 `#execute` 两次，
+ * 后写的那份记录还可能把已完成的段覆盖回 suspended、丢掉审批决定。
+ *
+ * 语义：**同一 taskId 上，进入本闸的唤醒路径串行**。最后一个登记的 tail 会在它及其之前
+ * 所有路径收口后才 resolve，所以 `cancel` 只要 `await gate.tail(taskId)` 就能等到
+ * 「此刻已登记的全部唤醒」—— 不需要知道它具体是 approve 还是 signal。
+ *
+ * 与各监督件自己的 `#inflight` 的关系：那些闸仍保留（approve 的「并发重入共享同一次」
+ * 语义依赖它；signal 的事件串行链也依赖它），本闸只负责**跨路径**互斥。两边在同一同步段
+ * 登记，先登记者赢。
+ *
+ * 纯件：不碰 store、不认识记录，只做「同一 key 的 Promise 串行」。单测见
+ * `tests/transport/task-wake-gate.test.ts`。
+ *
+ * ⚠️ **隐含前提：`fn` 必须最终 settle**（2026-11-09 深评「待确认」）。等待链**没有超时** ——
+ * 若某条路径的 `fn` 永远挂着（典型：宿主 store 的 `save` 不返回），同任务后续所有唤醒会
+ * 永久排队，`cancel` 的 `await tail` 也会一起挂住。当前四个调用点的 `fn` 只碰 store，
+ * 属于「宿主必须把 store 实现成会 settle」的契约；要打破它得在闸上加超时，而超时语义
+ * （「超时后放行」= 互斥失效）比挂住更危险，所以这里选择写明前提而不是加计时器。
+ */
+export class TaskWakeGate {
+    /**
+     * 每个 taskId 的**队列尾**。它 resolve 的条件是「本路径之后才登记的路径也都已完成」，
+     * 因此它同时可当 `cancel` 的等待句柄。
+     */
+    #tails = new Map();
+    /** 该任务上是否已有登记（排队中或执行中）——惰性路径据此跳过本轮 */
+    busy(taskId) {
+        return this.#tails.has(taskId);
+    }
+    /** 该任务上全部已登记路径的收口 Promise；没有则为 undefined */
+    tail(taskId) {
+        return this.#tails.get(taskId);
+    }
+    /**
+     * 串行执行：前一条（若存在）收口后才开始 `fn`。
+     *
+     * `fn` 的同步前段（第一个 await 之前）在**调用者的同步段**里执行 —— 与不加闸时
+     * 的时序一致，既有「进闸后立刻重读」的测试不会因为多了一个微任务而变味。
+     */
+    async run(taskId, fn) {
+        const prev = this.#tails.get(taskId);
+        let release;
+        const gate = new Promise((resolve) => {
+            release = resolve;
+        });
+        // tail 必须把 gate 串在 prev 之后：等待者拿到 tail 时，等待的是「这条路径也结束」。
+        const tail = prev === undefined ? gate : prev.catch(() => undefined).then(() => gate);
+        this.#tails.set(taskId, tail);
+        if (prev !== undefined)
+            await prev.catch(() => undefined);
+        try {
+            return await fn();
+        }
+        finally {
+            release();
+            // 只摘自己：若后面又排了新的 tail，留给它自己摘（无条件 delete 会摘掉别人的）。
+            if (this.#tails.get(taskId) === tail)
+                this.#tails.delete(taskId);
+        }
+    }
+}
+//# sourceMappingURL=task-wake-gate.js.map

package/dist/transport/task-wake-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-wake-gate.js","sourceRoot":"","sources":["../../src/transport/task-wake-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,YAAY;IACvB;;;OAGG;IACM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEtD,sCAAsC;IACtC,IAAI,CAAC,MAAc;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,MAAc;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAI,MAAc,EAAE,EAAoB;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,OAAoB,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACzC,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,uDAAuD;QACvD,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;YACV,gDAAgD;YAChD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@migor/agentia",
-  "version": "0.10.4",
+  "version": "0.10.6",
   "description": "Declarative agent service framework for TypeScript: decorators + DI declare four capability kinds, durable runs, and per-run traces, cost and metrics. Zero runtime dependencies.",
   "type": "module",
   "main": "dist/index.js",
@@ -82,7 +82,7 @@
     "bench:otlp": "tsx scripts/bench-otlp-snapshot.ts"
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "^0.134.0",
+    "@anthropic-ai/sdk": "^1.3.0",
     "@biomejs/biome": "^2.5.14",
     "@grpc/grpc-js": "^1.14.6",
     "@grpc/proto-loader": "^0.8.1",