@migor/agentia 0.7.2 → 0.8.1

package/dist/transport/slot-pool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 并发槽位池 —— 从 AsyncRunner 里抽出的第一个协作件（纯原语、零依赖）。
+ *
+ * 为什么单独成件：AsyncRunner 一个类同时扛状态机/并发/幂等/恢复/审批/session/超时/持久化，
+ * 并发槽位是其中**唯一不碰 store、不碰引擎**的一块 —— 先把它抽出来并配单测，后续抽块才有基线。
+ *
+ * 语义与原 `#acquireSlot` / `#releaseSlot` **逐字一致**：
+ * - 超限时 `acquire()` 的 promise 进 FIFO 队列等（此时任务记录仍由调用方留在 store 里为 queued）；
+ * - `release()` **把槽位直接移交**给队首等待者（不是先减再让等待者自增）—— 移交期间计数不变，
+ *   所以「同时最多 limit 个」这条不变量在中间态也成立；
+ * - 没有等待者时才真正归还计数。
+ */
+export declare class SlotPool {
+    private readonly limit;
+    private running;
+    private readonly waitQueue;
+    constructor(limit: number);
+    /** 取槽位：未到上限立刻兑现，否则排队 */
+    acquire(): Promise<void>;
+    /** 还槽位：有等待者则移交（计数不变），否则归还 */
+    release(): void;
+    /** 当前占用数（测试用；AsyncRunner 对外暴露的是 active，不是它） */
+    get inUse(): number;
+}

package/dist/transport/slot-pool.js

@@ -0,0 +1,43 @@
+/**
+ * 并发槽位池 —— 从 AsyncRunner 里抽出的第一个协作件（纯原语、零依赖）。
+ *
+ * 为什么单独成件：AsyncRunner 一个类同时扛状态机/并发/幂等/恢复/审批/session/超时/持久化，
+ * 并发槽位是其中**唯一不碰 store、不碰引擎**的一块 —— 先把它抽出来并配单测，后续抽块才有基线。
+ *
+ * 语义与原 `#acquireSlot` / `#releaseSlot` **逐字一致**：
+ * - 超限时 `acquire()` 的 promise 进 FIFO 队列等（此时任务记录仍由调用方留在 store 里为 queued）；
+ * - `release()` **把槽位直接移交**给队首等待者（不是先减再让等待者自增）—— 移交期间计数不变，
+ *   所以「同时最多 limit 个」这条不变量在中间态也成立；
+ * - 没有等待者时才真正归还计数。
+ */
+export class SlotPool {
+    limit;
+    running = 0;
+    waitQueue = [];
+    constructor(limit) {
+        this.limit = limit;
+    }
+    /** 取槽位：未到上限立刻兑现，否则排队 */
+    acquire() {
+        if (this.running < this.limit) {
+            this.running++;
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => this.waitQueue.push(resolve));
+    }
+    /** 还槽位：有等待者则移交（计数不变），否则归还 */
+    release() {
+        const next = this.waitQueue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.running--;
+        }
+    }
+    /** 当前占用数（测试用；AsyncRunner 对外暴露的是 active，不是它） */
+    get inUse() {
+        return this.running;
+    }
+}
+//# sourceMappingURL=slot-pool.js.map

package/dist/transport/slot-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-pool.js","sourceRoot":"","sources":["../../src/transport/slot-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,QAAQ;IAIU,KAAK;IAH1B,OAAO,GAAG,CAAC,CAAC;IACH,SAAS,GAAsB,EAAE,CAAC;IAEnD,YAA6B,KAAa;qBAAb,KAAK;IAAW,CAAC;IAE9C,wBAAwB;IACxB,OAAO;QACL,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,6BAA6B;IAC7B,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;QACT,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/transport/task-waiters.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 任务终态等待表 —— 从 AsyncRunner 里抽出的第五个（也是最后一个）协作件
+ * （slot-pool → approval-policy → drain-gate → resume-policy → 这里）。
+ *
+ * 为什么单独成件：`awaitTask` 是**双通道**的 —— 主路径是事件唤醒（本进程把任务写到终态时
+ * 主动叫醒），兜底是轮询（他进程写终态时唤不醒，只能靠间隔唤醒后自己重读 store）。
+ * 两条通道各自的语义、以及"超时到底算 resolve 还是 reject"这类边界，混在 900 行的类里
+ * 只能透过 `awaitTask` 的整体行为间接观察；抽出来后可以直接打在表本身。
+ *
+ * ⚠️ 覆盖范围（这是本模块最重要的一条约束）：**只覆盖本进程写终态**。他进程写的终态唤不醒
+ * 这里的等待者 —— 那是 `awaitTask` 用 `intervalMs` 兜底轮询的原因，不是缺陷。
+ *
+ * `wait()` 到期是 **resolve 而不是 reject**：它只是"该醒来看一眼了"，超时的判定权在
+ * `awaitTask` 的循环里（它重读 store、算 deadline、再决定继续等还是抛错）。
+ */
+export declare class TaskWaiters {
+    /** taskId → 等待者；仅覆盖本进程写终态（他进程写靠兜底轮询） */
+    private readonly waiters;
+    /** 任务终态唤醒：本进程写终态的统一出口调用（成功 / 失败 / 采纳既有结果各路径） */
+    notify(taskId: string): void;
+    /** 等「本进程把该任务写到终态」或被 timeoutMs 兜底唤醒（二者先到先返回） */
+    wait(taskId: string, timeoutMs: number): Promise<void>;
+    /** 当前登记的等待者总数（单测与诊断用） */
+    get count(): number;
+}

package/dist/transport/task-waiters.js

@@ -0,0 +1,63 @@
+/**
+ * 任务终态等待表 —— 从 AsyncRunner 里抽出的第五个（也是最后一个）协作件
+ * （slot-pool → approval-policy → drain-gate → resume-policy → 这里）。
+ *
+ * 为什么单独成件：`awaitTask` 是**双通道**的 —— 主路径是事件唤醒（本进程把任务写到终态时
+ * 主动叫醒），兜底是轮询（他进程写终态时唤不醒，只能靠间隔唤醒后自己重读 store）。
+ * 两条通道各自的语义、以及"超时到底算 resolve 还是 reject"这类边界，混在 900 行的类里
+ * 只能透过 `awaitTask` 的整体行为间接观察；抽出来后可以直接打在表本身。
+ *
+ * ⚠️ 覆盖范围（这是本模块最重要的一条约束）：**只覆盖本进程写终态**。他进程写的终态唤不醒
+ * 这里的等待者 —— 那是 `awaitTask` 用 `intervalMs` 兜底轮询的原因，不是缺陷。
+ *
+ * `wait()` 到期是 **resolve 而不是 reject**：它只是"该醒来看一眼了"，超时的判定权在
+ * `awaitTask` 的循环里（它重读 store、算 deadline、再决定继续等还是抛错）。
+ */
+export class TaskWaiters {
+    /** taskId → 等待者；仅覆盖本进程写终态（他进程写靠兜底轮询） */
+    waiters = new Map();
+    /** 任务终态唤醒：本进程写终态的统一出口调用（成功 / 失败 / 采纳既有结果各路径） */
+    notify(taskId) {
+        const waiters = this.waiters.get(taskId);
+        if (!waiters || waiters.length === 0)
+            return;
+        this.waiters.delete(taskId);
+        for (const w of waiters)
+            w();
+    }
+    /** 等「本进程把该任务写到终态」或被 timeoutMs 兜底唤醒（二者先到先返回） */
+    wait(taskId, timeoutMs) {
+        return new Promise((resolve) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                const waiters = this.waiters.get(taskId);
+                if (waiters) {
+                    const i = waiters.indexOf(finish);
+                    if (i >= 0)
+                        waiters.splice(i, 1);
+                    if (waiters.length === 0)
+                        this.waiters.delete(taskId);
+                }
+                resolve();
+            };
+            const timer = setTimeout(finish, timeoutMs);
+            const waiters = this.waiters.get(taskId);
+            if (waiters)
+                waiters.push(finish);
+            else
+                this.waiters.set(taskId, [finish]);
+        });
+    }
+    /** 当前登记的等待者总数（单测与诊断用） */
+    get count() {
+        let n = 0;
+        for (const list of this.waiters.values())
+            n += list.length;
+        return n;
+    }
+}
+//# sourceMappingURL=task-waiters.js.map

package/dist/transport/task-waiters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-waiters.js","sourceRoot":"","sources":["../../src/transport/task-waiters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,WAAW;IACtB,wCAAwC;IACvB,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEhE,gDAAgD;IAChD,MAAM,CAAC,MAAc;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,CAAC,EAAE,CAAC;IAC/B,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC,MAAc,EAAE,SAAiB;QACpC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,MAAM,GAAG,GAAS,EAAE;gBACxB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACzC,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC;wBAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;wBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACxD,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;gBAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yBAAyB;IACzB,IAAI,KAAK;QACP,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@migor/agentia",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "description": "面向应用开发的声明式 agent 服务开发框架：装饰器 + DI 声明四类能力，主 agent 编排执行；每次 run 产出结构化结果与可观测调用树（trace、成本、指标），交付可直接上线的服务。",
   "type": "module",
   "main": "dist/index.js",
@@ -35,7 +35,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json && node scripts/copy-assets.mjs",
-    "build:cli": "npm run build -w @migor/trace-view && tsc -p packages/cli/tsconfig.json && node packages/cli/scripts/copy-assets.mjs",
+    "build:cli": "npm run build -w @migor/trace-view && tsc -p packages/cli/tsconfig.json && tsc --noEmit -p packages/cli/tsconfig.templates.json && node packages/cli/scripts/copy-assets.mjs",
     "build:website": "npm run build -w @migor/trace-view && npm run build -w @migor/website",
     "deploy:website": "npm run build:website && npx --yes wrangler@4.131.0 pages deploy packages/website/dist --project-name=agentia-web",
     "prepublishOnly": "node scripts/check-release.mjs && npm run build",
@@ -57,10 +57,11 @@
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.126.0",
-    "@biomejs/biome": "^2.5.13",
+    "@biomejs/biome": "^2.5.14",
     "@grpc/grpc-js": "^1.14.5",
     "@grpc/proto-loader": "^0.8.1",
     "@types/node": "^26.5.1",
+    "c8": "^10.1.3",
     "tsx": "^4.19.0",
     "typescript": "^7.0.2",
     "zod": "^4.6.1"