@migor/agentia 0.2.1 → 0.2.2

package/dist/transport/sse.js

@@ -0,0 +1,51 @@
+/** 缺省积压上限：8 MiB —— 一条 8 MiB 都没被读走的流，已经不是「慢」而是「断了」 */
+export const SSE_DEFAULT_MAX_BUFFERED_BYTES = 8 * 1024 * 1024;
+export function sseWriter(res, opts = {}) {
+    const limitBytes = opts.maxBufferedBytes ?? SSE_DEFAULT_MAX_BUFFERED_BYTES;
+    let closed = false;
+    res.writeHead(200, {
+        'content-type': 'text/event-stream; charset=utf-8',
+        'cache-control': 'no-cache, no-transform',
+        connection: 'keep-alive',
+        // 关掉 nginx 一类反代的响应缓冲（否则事件被攒着一起发，流式就没意义了）
+        'x-accel-buffering': 'no',
+    });
+    /** 未落盘字节数；假 res（测试替身）没有该属性时按 0 处理 */
+    const buffered = () => (typeof res.writableLength === 'number' ? res.writableLength : 0);
+    const emit = (frame) => {
+        if (closed)
+            return;
+        const pending = buffered();
+        if (pending > limitBytes) {
+            // 下游消费不动：先收口，再通知（通知抛错也不改变「已收口」这个事实）
+            closed = true;
+            try {
+                opts.onBackpressure?.({ bufferedBytes: pending, limitBytes });
+            }
+            catch {
+                /* 通知是副作用，不该把收口变崩溃 */
+            }
+            res.end();
+            return;
+        }
+        res.write(frame);
+    };
+    return {
+        get closed() {
+            return closed;
+        },
+        event(name, data) {
+            emit(`event: ${name}\ndata: ${JSON.stringify(data)}\n\n`);
+        },
+        comment(text) {
+            emit(`: ${text}\n\n`);
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            res.end();
+        },
+    };
+}
+//# sourceMappingURL=sse.js.map

package/dist/transport/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/transport/sse.ts"],"names":[],"mappings":"AAwCA,qDAAqD;AACrD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9D,MAAM,UAAU,SAAS,CAAC,GAAmB,EAAE,IAAI,GAAqB,EAAE;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,IAAI,8BAA8B,CAAC;IAC3E,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,cAAc,EAAE,kCAAkC;QAClD,eAAe,EAAE,wBAAwB;QACzC,UAAU,EAAE,YAAY;QACxB,yCAAyC;QACzC,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;IAEH,qCAAqC;IACrC,MAAM,QAAQ,GAAG,GAAW,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjG,MAAM,IAAI,GAAG,CAAC,KAAa,EAAQ,EAAE;QACnC,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;YACzB,oCAAoC;YACpC,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,CAAC;gBACH,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;YACD,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,MAAM;YACR,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,CAAC,IAAY,EAAE,IAAa;YAC/B,IAAI,CAAC,UAAU,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,CAAC,IAAY;YAClB,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;QACxB,CAAC;QACD,KAAK;YACH,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/{run → transport}/transport.d.ts

@@ -1,5 +1,5 @@
 import type { AppCallable } from './async.js';
-import type { RunInvocationOptions } from './spec.js';
+import type { RunInvocationOptions } from '../engine/spec.js';
 /**
  * Agentia —— 同步 RPC 传输（spec §6.3 同步请求 / §6.6 v1 边界）。
  * 纯适配层：把「任意任务入参 → messages」接 app.run。宿主（HTTP 路由 /

package/dist/{run → transport}/transport.js

@@ -1,4 +1,4 @@
-import { normalizeMessages } from './spec.js';
+import { normalizeMessages } from '../engine/spec.js';
 /**
  * Agentia —— 同步 RPC 传输（spec §6.3 同步请求 / §6.6 v1 边界）。
  * 纯适配层：把「任意任务入参 → messages」接 app.run。宿主（HTTP 路由 /

package/dist/transport/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;GAKG;AAEH,gCAAgC;AAChC,MAAM,UAAU,OAAO,CACrB,GAAgB,EAChB,KAAc,EACd,IAA2B;IAE3B,OAAO,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,iBAAiB,CAC/B,GAAgB;IAEhB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@migor/agentia",
-  "version": "0.2.1",
-  "description": "面向应用开发者的声明式 agent 服务开发框架：装饰器 + DI 声明 tool/skill/subagent/prompt 单元，主 agent 编排执行，最终形态为流水线（pipeline）服务。",
+  "version": "0.2.2",
+  "description": "面向应用开发的声明式 agent 服务开发框架：装饰器 + DI 声明四类能力，主 agent 编排执行；每次 run 产出结构化结果与可观测调用树（trace、成本、指标），交付可直接上线的服务。",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,6 +9,11 @@
     "dist"
   ],
   "repository": "retrychx/agentia",
+  "homepage": "https://agentia-web.pages.dev",
+  "bugs": {
+    "url": "https://github.com/retrychx/agentia/issues"
+  },
+  "license": "MIT",
   "keywords": [
     "agent",
     "llm",
@@ -28,17 +33,27 @@
     "packages/*"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "build:cli": "tsc -p packages/cli/tsconfig.json",
-    "deploy:website": "npx wrangler pages deploy packages/website/public --project-name=agentia-web",
-    "prepublishOnly": "npm run build",
+    "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: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",
     "dev": "tsx watch src/index.ts",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "node --import tsx --test \"tests/**/*.test.ts\"",
-    "e2e": "npm run build && npm run build:cli && tsx scripts/e2e-cli.ts"
+    "typecheck:tests": "tsc --noEmit -p tsconfig.tests.json",
+    "typecheck:types": "tsc --noEmit -p tsconfig.types.json",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "test": "node --import tsx --test \"tests/**/*.test.ts\" && node --test \"packages/cli/test/*.test.mjs\" && node --test \"packages/trace-view/test/*.test.js\"",
+    "e2e": "npm run build && npm run build:cli && tsx scripts/e2e-cli.ts && tsx scripts/e2e-examples.ts",
+    "e2e:examples": "npm run build && tsx scripts/e2e-examples.ts",
+    "e2e:live": "tsx scripts/e2e-live.ts",
+    "e2e:mcp": "npm run build:cli && tsx scripts/e2e-mcp.ts"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@biomejs/biome": "^2.5.13",
+    "@types/node": "^26.5.1",
     "tsx": "^4.19.0",
     "typescript": "^7.0.2",
     "zod": "^4.6.1"

package/dist/engine/context.js

@@ -1,146 +0,0 @@
-/**
- * Agentia —— 长上下文策略的纯函数层（spec §5/§6：compaction / context editing 分清）。
- *
- * 三策略不混：
- * - **context editing**（`trimToolPairs`）：清旧 tool_use→tool_result 对，不掉内容、不额外调模型；
- * - **compaction**（`compactMessages`）：把旧消息前缀做**服务端摘要**（摘要器由上层注入，可走模型），
- *   只保留最近 N 条 + 一段摘要 —— 新的消息数组仍保证角色交替合法；
- * - **客户端剪裁** = 子 agent 的独立上下文（见 toolkit/subagent.ts）。
- *
- * 不在此自研 token 计数黑名单：`estimateMessages` 只是预算策略的默认启发式
- * （CJK 感知估算，明确标注为估算），上层可注入真实 count_tokens 结果。
- */
-/**
- * 默认估算（仅预算决策用，非精确记账）：CJK 字符按 ~1.5 字/token，
- * 其余（ASCII/拉丁）按 ~4 字符/token。纯字符/4 对中文系统性高估，
- * 会让预算护栏过早触发压缩。
- */
-export function defaultEstimateTokens(text) {
-    let cjk = 0;
-    for (const ch of text) {
-        const cp = ch.codePointAt(0);
-        if ((cp >= 0x3400 && cp <= 0x9fff) || // CJK 统一表意文字（扩展A + 基本区）
-            (cp >= 0xf900 && cp <= 0xfaff) || // 兼容表意文字
-            (cp >= 0x20000 && cp <= 0x2a6df) || // 扩展B
-            (cp >= 0x3000 && cp <= 0x30ff) || // 日文假名 + CJK 标点
-            (cp >= 0xff00 && cp <= 0xffef) // 全角字符
-        ) {
-            cjk++;
-        }
-    }
-    const other = text.length - cjk; // 非 BMP 字符按 UTF-16 长度计，属可接受偏差
-    return Math.max(1, Math.ceil(cjk / 1.5 + other / 4));
-}
-export function isToolResultMessage(msg) {
-    if (msg.role !== 'user')
-        return false;
-    if (typeof msg.content === 'string')
-        return false;
-    return msg.content.length > 0 && msg.content.every((b) => b.type === 'tool_result');
-}
-function hasToolUse(msg) {
-    if (msg.role !== 'assistant')
-        return false;
-    if (typeof msg.content === 'string')
-        return false;
-    return msg.content.some((b) => b.type === 'tool_use');
-}
-function contentToText(content) {
-    if (typeof content === 'string')
-        return content;
-    return content
-        .map((b) => {
-        switch (b.type) {
-            case 'text':
-                return b.text;
-            case 'tool_use':
-                return `${b.name}(${JSON.stringify(b.input)})`;
-            case 'tool_result':
-                return JSON.stringify(b.content);
-            default:
-                return JSON.stringify(b);
-        }
-    })
-        .join('\n');
-}
-function contentTokens(content, estimate) {
-    if (typeof content === 'string')
-        return estimate(content);
-    let n = 0;
-    for (const b of content) {
-        n += 1; // block 自身开销
-        n += estimate(contentToText([b]));
-    }
-    return n;
-}
-/** 整组消息的估算 token（含每条 role 开销）。 */
-export function estimateMessages(messages, estimate = defaultEstimateTokens) {
-    let n = 0;
-    for (const m of messages) {
-        n += estimate(m.role);
-        n += contentTokens(m.content, estimate);
-    }
-    return n;
-}
-/** 把消息渲染成可喂给摘要器的纯文本（role: content）。 */
-export function renderMessages(messages) {
-    return messages.map((m) => `${m.role}: ${contentToText(m.content)}`).join('\n\n');
-}
-/**
- * context editing：丢弃旧的 tool_use→tool_result 对（超出 keepRecent 的），
- * 保留最近 N 对以及所有非工具消息。逐对整体移除，保角色交替合法。
- * 返回原数组引用（若无需裁剪）或新数组。
- */
-export function trimToolPairs(messages, opts = {}) {
-    const keep = Math.max(0, opts.keepRecent ?? 1);
-    const pairs = [];
-    for (let i = 0; i + 1 < messages.length; i++) {
-        if (hasToolUse(messages[i]) && isToolResultMessage(messages[i + 1])) {
-            pairs.push([i, i + 1]);
-            i += 1;
-        }
-    }
-    if (pairs.length <= keep)
-        return messages; // 无需裁剪（或本就留得下）
-    // 丢掉最旧的 (pairs.length - keep) 对，最近的 keep 对与所有非工具消息保留
-    const drop = new Set();
-    for (let k = 0; k < pairs.length - keep; k++) {
-        drop.add(pairs[k][0]);
-        drop.add(pairs[k][1]);
-    }
-    const out = messages.filter((_, i) => !drop.has(i));
-    return out.length === messages.length ? messages : out;
-}
-/**
- * compaction：把 messages 里“除最近 keepRecent 条”的旧前缀做摘要，替换成一段
- * 摘要消息，尾部保留。产出保证：
- * - 不拆散 (assistant tool_use → user tool_result) 对 —— cut 落到对中间时整体后移；
- * - 角色交替合法 —— 尾段首条是普通 user 时摘要并入之；否则摘要以 user 角色放最前。
- */
-export async function compactMessages(messages, opts) {
-    const keepRecent = Math.max(1, opts.keepRecent ?? 20);
-    if (messages.length <= keepRecent)
-        return messages;
-    let cut = messages.length - keepRecent;
-    // cut 若落在一对 tool_result 的开头（前一条是带 tool_use 的 assistant），整对后移进保留段
-    while (cut > 1 && cut < messages.length && isToolResultMessage(messages[cut])) {
-        cut -= 1;
-    }
-    const prefix = messages.slice(0, cut);
-    const tail = messages.slice(cut);
-    const summary = await opts.summarize(renderMessages(prefix));
-    const label = `[此前对话摘要]\n${summary}`;
-    if (tail.length === 0)
-        return [{ role: 'user', content: label }];
-    const [first, ...rest] = tail;
-    if (first.role === 'user' && !isToolResultMessage(first)) {
-        // 并入首条普通 user 消息，保持 user→assistant 交替
-        const merged = typeof first.content === 'string'
-            ? { ...first, content: `${label}\n\n${first.content}` }
-            : { ...first, content: [{ type: 'text', text: label }, ...first.content] };
-        return [merged, ...rest];
-    }
-    // 尾段以 assistant 开头：摘要作首条 user（user→assistant 交替合法）
-    return [{ role: 'user', content: label }, ...tail];
-}
-//# sourceMappingURL=context.js.map

package/dist/engine/context.js.map

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

package/dist/run/async.d.ts

@@ -1,59 +0,0 @@
-import type Anthropic from '@anthropic-ai/sdk';
-import type { ModelClient } from '../core/tool.js';
-import type { AgentRunResult } from '../engine/types.js';
-import type { RunStatus } from './types.js';
-import type { RunInvocationOptions } from './spec.js';
-import type { MaybePromise, TaskRecord, TaskStore } from './store.js';
-export interface AsyncRunnerOptions {
-    client?: ModelClient;
-    store?: TaskStore;
-    /** 同时执行的任务上限；缺省不限。超出部分排队等槽位（状态保持 queued） */
-    concurrency?: number;
-}
-/** 应用最小调用面（agent 装配无关，避免 run 层向上依赖 toolkit） */
-export interface AppCallable {
-    readonly name: string;
-    run(messages: Anthropic.MessageParam[], opts?: RunInvocationOptions): Promise<{
-        run: {
-            runId: string;
-            status: RunStatus;
-        };
-        result: AgentRunResult;
-    }>;
-}
-export declare class AsyncRunner {
-    #private;
-    private readonly app;
-    readonly store: TaskStore;
-    private readonly client?;
-    private readonly concurrency;
-    private running;
-    private readonly waitQueue;
-    constructor(app: AppCallable, opts?: AsyncRunnerOptions);
-    /**
-     * 提交一次异步任务。入参可为 string / messages / {prompt|text|messages}。
-     * 幂等键存在且上一任务未失败 → 直接返回既有记录（去重）；失败的同键可产生新任务。
-     * 同步门面：同步 store 下立即去重并返回快照；异步 store 下 save 在后台完成、
-     * 去重推迟到执行前（见 #execute），返回新建任务的提交时刻快照。
-     */
-    submit(input: unknown, opts?: {
-        idempotencyKey?: string;
-        source?: string;
-        options?: RunInvocationOptions;
-    }): TaskRecord;
-    /** 查任务当前记录（异步 store 下返回 Promise，调用方 await） */
-    poll(taskId: string): MaybePromise<TaskRecord | undefined>;
-    byIdempotency(key: string): MaybePromise<TaskRecord | undefined>;
-    list(): MaybePromise<TaskRecord[]>;
-    /** 等到任务终态；超时抛错。 */
-    awaitTask(taskId: string, opts?: {
-        timeoutMs?: number;
-        intervalMs?: number;
-    }): Promise<TaskRecord>;
-    /**
-     * 宿主重启续跑：把 store 里 queued | running 的记录重新派发执行
-     * （running 视为进程中断）。返回重派数量（异步 store 下返回 Promise<number>）。
-     * 幂等键去重照常生效。
-     */
-    resumePending(): number | Promise<number>;
-}

package/dist/run/async.js

@@ -1,201 +0,0 @@
-import { classifyError } from '../engine/errors.js';
-import { normalizeMessages } from './spec.js';
-import { InMemoryTaskStore } from './store.js';
-/**
- * Agentia —— 异步任务宿主（spec §6.3 异步 / §6.5 确定性 / §6.6 换宿主不换语义）。
- *
- * - submit 即回（queued），后台驱动状态机 queued → running → succeeded/failed；
- * - **at-least-once 去重**：同一 idempotencyKey 重复 submit，若上一任务仍在
- *   queued/running/succeeded 则直接返回既有记录，不重复执行（失败可重试新任务）；
- * - run 记录落 TaskStore（v1 InMemoryTaskStore），trace 随 result 一同保留；
- *   DB/队列宿主只需实现 TaskStore。
- *
- * 异步 TaskStore（R6，TaskStore 方法返回 MaybePromise）：
- * - 内部执行路径（#execute / awaitTask / resumePending）全部 await 化，两种 store 通吃；
- * - submit/poll/byIdempotency/list 是**同步门面**，为同步 store 保持原有用法与返回类型
- *   （http/scheduler/既有调用方零改动）。接异步 store 时：submit 的即时去重无法进行
- *   （推迟到 #execute：同键已有 succeeded 记录则采纳其结果、不重复执行），poll 等
- *   返回 Promise 需调用方自行 await。
- */
-/** store 返回值可能是同步值或 Promise —— 区分用（同步门面只在同步值上工作） */
-function isThenable(x) {
-    return !!x && typeof x.then === 'function';
-}
-export class AsyncRunner {
-    app;
-    store;
-    client;
-    concurrency;
-    running = 0;
-    waitQueue = [];
-    constructor(app, opts = {}) {
-        this.app = app;
-        this.app = app;
-        this.store = opts.store ?? new InMemoryTaskStore();
-        this.client = opts.client;
-        this.concurrency = opts.concurrency ?? Number.POSITIVE_INFINITY;
-        if (!(this.concurrency > 0)) {
-            throw new Error(`concurrency 必须为正数，收到 ${opts.concurrency}`);
-        }
-    }
-    /**
-     * 提交一次异步任务。入参可为 string / messages / {prompt|text|messages}。
-     * 幂等键存在且上一任务未失败 → 直接返回既有记录（去重）；失败的同键可产生新任务。
-     * 同步门面：同步 store 下立即去重并返回快照；异步 store 下 save 在后台完成、
-     * 去重推迟到执行前（见 #execute），返回新建任务的提交时刻快照。
-     */
-    submit(input, opts = {}) {
-        const messages = normalizeMessages(input);
-        if (opts.idempotencyKey) {
-            const existing = this.store.byIdempotency(opts.idempotencyKey);
-            // 异步 store 返回 Promise —— 同步门面无法 await，去重交给 #execute
-            if (existing && !isThenable(existing) && existing.status !== 'failed') {
-                return { ...existing }; // at-least-once 去重：不重复执行
-            }
-        }
-        const rec = {
-            taskId: InMemoryTaskStore.nextTaskId(),
-            status: 'queued',
-            idempotencyKey: opts.idempotencyKey,
-            spec: { messages, options: opts.options, source: opts.source ?? 'async' },
-            createdAt: Date.now(),
-        };
-        const saved = this.store.save(rec);
-        if (isThenable(saved)) {
-            // 异步落库失败：尽力把任务标记为 failed 重存，避免静默吞错 / unhandled rejection
-            saved.catch((e) => {
-                rec.status = 'failed';
-                rec.error = classifyError(e);
-                rec.finishedAt = Date.now();
-                void Promise.resolve(this.store.save(rec)).catch(() => { });
-            });
-        }
-        void this.#execute(rec);
-        // 返回浅拷贝：记录会被后台状态机原地推进，调用方拿到的是提交时刻的快照
-        return { ...rec };
-    }
-    /** 查任务当前记录（异步 store 下返回 Promise，调用方 await） */
-    poll(taskId) {
-        return this.store.get(taskId);
-    }
-    byIdempotency(key) {
-        return this.store.byIdempotency(key);
-    }
-    list() {
-        return this.store.list();
-    }
-    /** 等到任务终态；超时抛错。 */
-    async awaitTask(taskId, opts = {}) {
-        const timeoutMs = opts.timeoutMs ?? 30_000;
-        const intervalMs = opts.intervalMs ?? 5;
-        const start = Date.now();
-        for (;;) {
-            const rec = await this.store.get(taskId);
-            if (!rec)
-                throw new Error(`task 不存在: ${taskId}`);
-            if (rec.status === 'succeeded' || rec.status === 'failed')
-                return rec;
-            if (Date.now() - start > timeoutMs) {
-                throw new Error(`task ${taskId} 等待超时（${rec.status}）`);
-            }
-            await new Promise((r) => setTimeout(r, intervalMs));
-        }
-    }
-    /**
-     * 宿主重启续跑：把 store 里 queued | running 的记录重新派发执行
-     * （running 视为进程中断）。返回重派数量（异步 store 下返回 Promise<number>）。
-     * 幂等键去重照常生效。
-     */
-    resumePending() {
-        const listed = this.store.list();
-        if (isThenable(listed))
-            return listed.then((recs) => this.#redispatch(recs));
-        return this.#redispatch(listed);
-    }
-    #redispatch(recs) {
-        const pending = recs.filter((r) => r.status === 'queued' || r.status === 'running');
-        for (const rec of pending) {
-            rec.status = 'queued'; // 重新入队，由 #execute 统一推进
-            void this.#execute(rec);
-        }
-        return pending.length;
-    }
-    async #execute(rec) {
-        // 顶层容错：异步 store（网络客户端）任何一处 reject 都不得逃逸成
-        // unhandled rejection（Node ≥15 默认终止进程）——任务标记失败尽力落库。
-        try {
-            // 异步 store 的幂等去重在此补齐（submit 同步门面无法 await）：
-            // 同键已有 succeeded 记录 → 采纳其结果，不重复执行；queued/running 不采纳 ——
-            // 重复执行本就是 at-least-once 允许的行为。同步 store 下 submit 已完成去重，
-            // 这里查到的一般是 rec 自身（taskId 相同，直接放行）。
-            // 注意（load-bearing）：该去重依赖 store.save 先写记录、后写 idem 索引的顺序
-            // （见 redisStore 头注释）——索引指向自身时上面的 taskId 相等判断放行。
-            if (rec.idempotencyKey) {
-                const existing = await this.store.byIdempotency(rec.idempotencyKey);
-                if (existing && existing.taskId !== rec.taskId && existing.status === 'succeeded') {
-                    rec.status = 'succeeded';
-                    rec.runId = existing.runId;
-                    rec.result = existing.result;
-                    rec.error = existing.error;
-                    rec.finishedAt = Date.now();
-                    await this.store.save(rec);
-                    return;
-                }
-            }
-            await this.#acquireSlot();
-            try {
-                rec.status = 'running';
-                rec.startedAt = Date.now();
-                await this.store.save(rec);
-                try {
-                    const callOpts = {
-                        ...(rec.spec.options ?? {}),
-                        client: rec.spec.options?.client ?? this.client,
-                        idempotencyKey: rec.idempotencyKey,
-                        rethrow: false, // 硬失败也以 failed 记录落库
-                    };
-                    const out = await this.app.run(rec.spec.messages, callOpts);
-                    rec.runId = out.run.runId;
-                    rec.status = out.run.status;
-                    rec.result = out.result;
-                    rec.error = out.result.error;
-                }
-                catch (e) {
-                    rec.error = classifyError(e);
-                    rec.status = 'failed';
-                }
-            }
-            finally {
-                rec.finishedAt = Date.now();
-                // 落库失败不遮罩、槽位必须释放
-                await Promise.resolve(this.store.save(rec)).catch(() => { });
-                this.#releaseSlot();
-            }
-        }
-        catch (e) {
-            rec.status = 'failed';
-            rec.error = classifyError(e);
-            rec.finishedAt = Date.now();
-            await Promise.resolve(this.store.save(rec)).catch(() => { });
-            console.error(`[agentia] task ${rec.taskId} 执行异常:`, e);
-        }
-    }
-    /** 并发槽位：超限则排队等待（任务记录保持 queued，由 store 可见） */
-    #acquireSlot() {
-        if (this.running < this.concurrency) {
-            this.running++;
-            return Promise.resolve();
-        }
-        return new Promise((resolve) => this.waitQueue.push(resolve));
-    }
-    #releaseSlot() {
-        const next = this.waitQueue.shift();
-        if (next) {
-            next(); // 槽位直接移交给等待者，running 计数不变
-        }
-        else {
-            this.running--;
-        }
-    }
-}
-//# sourceMappingURL=async.js.map

package/dist/run/async.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"async.js","sourceRoot":"","sources":["../../src/run/async.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C;;;;;;;;;;;;;;;GAeG;AAEH,oDAAoD;AACpD,SAAS,UAAU,CAAI,CAAkB;IACvC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAQ,CAAgB,CAAC,IAAI,KAAK,UAAU,CAAC;AAC7D,CAAC;AAkBD,MAAM,OAAO,WAAW;IAQH,GAAG;IAPb,KAAK,CAAY;IACT,MAAM,CAAe;IACrB,WAAW,CAAS;IAC7B,OAAO,GAAG,CAAC,CAAC;IACH,SAAS,GAAsB,EAAE,CAAC;IAEnD,YACmB,GAAgB,EACjC,IAAI,GAAuB,EAAE;mBADZ,GAAG;QAGpB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACnD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,iBAAiB,CAAC;QAChE,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CACJ,KAAc,EACd,IAAI,GAAiF,EAAE;QAEvF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC/D,oDAAoD;YACpD,IAAI,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACtE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,yBAAyB;YACnD,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAe;YACtB,MAAM,EAAE,iBAAiB,CAAC,UAAU,EAAE;YACtC,MAAM,EAAE,QAAQ;YAChB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO,EAAE;YACzE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,yDAAyD;YACzD,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;gBAChB,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC;gBACtB,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;gBAC7B,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC5B,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC7D,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACxB,qCAAqC;QACrC,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,8CAA8C;IAC9C,IAAI,CAAC,MAAc;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,aAAa,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,SAAS,CACb,MAAc,EACd,IAAI,GAAgD,EAAE;QAEtD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,SAAS,CAAC;YACR,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;YACjD,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO,GAAG,CAAC;YACtE,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;YACxD,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,WAAW,CAAC,IAAkB;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QACpF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,uBAAuB;YAC9C,KAAK,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAe;QAC5B,yCAAyC;QACzC,oDAAoD;QACpD,IAAI,CAAC;YACH,2CAA2C;YAC3C,wDAAwD;YACxD,uDAAuD;YACvD,mCAAmC;YACnC,uDAAuD;YACvD,gDAAgD;YAChD,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBACpE,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAClF,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;oBACzB,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;oBAC3B,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;oBAC7B,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;oBAC3B,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC5B,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC3B,OAAO;gBACT,CAAC;YACH,CAAC;YAED,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;gBACvB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAE3B,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAyB;wBACrC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;wBAC3B,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM;wBAC/C,cAAc,EAAE,GAAG,CAAC,cAAc;wBAClC,OAAO,EAAE,KAAK,EAAE,oBAAoB;qBACrC,CAAC;oBACF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;oBAC5D,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;oBAC1B,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;oBAC5B,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;oBACxB,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC/B,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;oBAC7B,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC;gBACxB,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC5B,iBAAiB;gBACjB,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC5D,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC;YACtB,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC7B,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC5D,OAAO,CAAC,KAAK,CAAC,kBAAkB,GAAG,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,YAAY;QACV,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,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,YAAY;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAC,CAAC,0BAA0B;QACpC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;CACF"}

package/dist/run/context.d.ts

@@ -1,16 +0,0 @@
-import type { Run } from './run.js';
-/** 在指定 ctx 下执行（executeRun 内部使用）；当前上下文对外以 current() 读取 */
-export declare function withRunContext<T>(ctx: RunContext, fn: () => T | Promise<T>): Promise<T>;
-export declare class RunContext {
-    readonly run: Run;
-    private readonly blackboard;
-    constructor(run: Run);
-    /** 当前 run 的上下文。不在 run 内调用时返回 undefined。 */
-    static current(): RunContext | undefined;
-    get runId(): string;
-    get<T>(key: string): T | undefined;
-    set(key: string, value: unknown): this;
-    has(key: string): boolean;
-    delete(key: string): boolean;
-    keys(): string[];
-}

package/dist/run/context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/run/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;;;GASG;AACH,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAElD,yDAAyD;AACzD,MAAM,UAAU,cAAc,CAAI,GAAe,EAAE,EAAwB;IACzE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAe,CAAC;AAC1C,CAAC;AAED,MAAM,OAAO,UAAU;IAGA,GAAG;IAFP,UAAU,GAAG,IAAI,GAAG,EAAmB,CAAC;IAEzD,YAAqB,GAAQ;mBAAR,GAAG;IAAQ,CAAC;IAEjC,2CAA2C;IAC3C,MAAM,CAAC,OAAO;QACZ,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,GAAG,CAAI,GAAW;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;IACnD,CAAC;IACD,GAAG,CAAC,GAAW,EAAE,KAAc;QAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/run/fsStore.js.map

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

package/dist/run/http.d.ts

@@ -1,47 +0,0 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import type { SpanError, Trace } from '../core/trace.js';
-import type { AgentStopReason } from '../engine/types.js';
-import { AsyncRunner } from './async.js';
-import type { AppCallable } from './async.js';
-import type { RunInvocationOptions } from './spec.js';
-import type { RunStatus } from './types.js';
-/**
- * Agentia —— HTTP 宿主（spec §6.6：换宿主不换语义，roadmap R3）。
- *
- * 只产出一个 (req, res) handler，不做 listen —— 交给用户
- * `http.createServer(createHttpHandler(app)).listen(...)`，可挂进任意 Node HTTP 框架。
- *
- * 端点契约（全部 JSON）：
- * - POST /run        同步 RPC。body = RunInput（string / messages / {prompt|text|messages}），
- *                    走 normalizeMessages 规整后同步执行；200 { runId, status, stopReason,
- *                    finalText, typed?, trace, error? }。status=failed 也照返 200
- *                    （rethrow:false 语义：硬失败以 error 字段返回，不用 HTTP 错误码表达）；
- *                    输入无法规整为 messages → 400 { error }。
- * - POST /tasks      异步任务。body { input, idempotencyKey?, options? } →
- *                    AsyncRunner.submit → 202 TaskRecord（queued，幂等键去重照常生效）。
- * - GET  /tasks/<id> 轮询任务记录 → 200 TaskRecord；不存在 → 404。
- *
- * 方法不符 405；路径不符 404；body 非法 JSON 400。runner 缺省内部 new AsyncRunner(app)。
- */
-/** POST /run 的响应形态 */
-export interface RunHttpResponse {
-    runId: string;
-    status: RunStatus;
-    stopReason: AgentStopReason;
-    finalText: string;
-    /** 结构化结果（R2 起应用可携带；无则省略） */
-    typed?: unknown;
-    trace: Trace;
-    error?: SpanError;
-}
-/** POST /tasks 的请求体形态 */
-export interface TaskSubmitBody {
-    input: unknown;
-    idempotencyKey?: string;
-    options?: RunInvocationOptions;
-}
-export interface HttpHandlerOptions {
-    /** 异步任务宿主；缺省 new AsyncRunner(app)（InMemoryTaskStore） */
-    runner?: AsyncRunner;
-}
-export declare function createHttpHandler(app: AppCallable, opts?: HttpHandlerOptions): (req: IncomingMessage, res: ServerResponse) => Promise<void>;