@yss123/cage-connectors 0.2.0 → 0.3.1

package/README.md

@@ -1,19 +1,104 @@
 # @yss123/cage-connectors
 
-第三方连接器原语与运行时
+Cage 的外部系统连接层。声明允许的主机、操作、请求/响应 schema、密钥名称和重试策略，把领域事件映射为出站请求，并把成功回执或验签回调映射回领域命令。适用于 ERP、外部接口和模型适配器的 IO 边界。
 
-Cage 是通过 TypeScript 声明业务、由框架统一执行权限和数据规则的中后台框架。此包是框架的一部分。
+## 安装
 
-## 使用
+需要 Node.js 24+，与其他 Cage 包保持同版本。在 domain 包安装：
 
 ```powershell
-pnpm add @yss123/cage-connectors
+pnpm add @yss123/cage-connectors zod
 ```
 
-首次使用建议通过脚手架创建完整项目，所需依赖由模板统一配置。需要 Node.js 24 或更新版本。
+## 声明外部协议
 
-- [完整使用说明](https://github.com/shunshunyue/cage/blob/main/docs/使用说明.md)
-- [框架源码与范例](https://github.com/shunshunyue/cage)
-- [问题反馈](https://github.com/shunshunyue/cage/issues)
+以下文件可放入 `packages/domain/src/integrations/erp.ts`。声明时不访问网络或读取密钥；`example.com` 主机需要替换为实际服务，并验证远端幂等协议。
 
-许可证：[MIT](https://github.com/shunshunyue/cage/blob/main/LICENSE)。
+```ts
+/** ERP 协议声明；只列出允许传出的字段，实际 IO 交给 worker。 */
+import { connector, op } from '@yss123/cage-connectors';
+import { z } from 'zod';
+
+/** 外部单据写操作；retryableWrite 要求对方按请求幂等键去重。 */
+export const erp = connector('erp', {
+  hosts: { test: 'erp-sandbox.example.com', prod: 'erp.example.com' },
+  secret: 'ERP_API_TOKEN',
+  timeoutMs: 5000,
+  operations: {
+    pushOrder: op({
+      effect: 'retryableWrite',
+      method: 'POST',
+      path: '/api/purchase-orders',
+      request: z.object({
+        externalId: z.string(),
+        lines: z.array(z.object({ sku: z.string(), qty: z.number() })),
+      }),
+      response: z.object({ erpNo: z.string() }),
+    }),
+  },
+});
+```
+
+在采购模板中可以继续加入事件映射；这里的事件和命令来自现有采购模块：
+
+```ts
+import { outbound } from '@yss123/cage-connectors';
+import { OrderApproved, recordErpNo } from '../modules/purchase/index.js';
+
+/** 审批事件提交后出站，回执通过 external 命令回写，不直接改表。 */
+export const pushToErp = outbound(OrderApproved, erp.operations.pushOrder, {
+  idempotencyKey: (event) => `po-${event.orderId}`,
+  map: (event) => ({
+    externalId: event.orderId,
+    lines: event.items.map((item) => ({ sku: item.sku, qty: item.qty })),
+  }),
+  onSuccess: {
+    command: recordErpNo,
+    map: (response, event) => ({ id: event.orderId, erpNo: response.erpNo }),
+  },
+});
+```
+
+将声明从 domain 根入口导出，运行 `cage check/gen`，按需迁移后启动 API 与 worker。部署通过环境或 `SecretProvider` 提供 `ERP_API_TOKEN` 的真实值；源码只保留密钥名称。
+
+## 本地 fake 与真实环境
+
+worker 启动入口注册模拟实现，业务声明仍使用同一协议：
+
+```ts
+import { fakeConnector, stage } from '@yss123/cage-connectors';
+import * as domain from '@app/domain';
+
+// 仅 fake 阶段使用固定响应；test/prod 阶段按声明连接真实主机。
+if (stage() === 'fake') {
+  fakeConnector(domain.erp, {
+    pushOrder: (request) => ({ erpNo: `DEMO-${request.externalId}` }),
+  });
+}
+```
+
+通过 `CAGE_STAGE` 选择阶段。fake 不代表第三方联调通过，生产必须验证协议、验签、超时和幂等性。密钥与本机日志不提交到源码。
+
+## 公开入口与保证范围
+
+| 入口 | 用途 |
+| --- | --- |
+| `connector`、`op` | 主机白名单、操作 schema、超时、限流和重试声明 |
+| `outbound` | 领域事件到事务外操作的映射，成功回写调用命令 |
+| `inbound`、`hmacSha256` | 原始正文验签、载荷校验及外部命令调用 |
+| `fakeConnector`、`fakeCalls` | 注册模拟处理器与检查模拟调用 |
+| `SecretProvider`、`setSecretProvider` | 替换服务端密钥来源，不能在浏览器调用 |
+| `call`、`streamJson` | 受控服务端适配器的外呼与流读取，不用于业务 handler 直接 IO |
+| `ConnectorError` | 区分外部协议、网络和执行失败 |
+
+`effect: 'read'`、`'retryableWrite'`、`'write'` 分别表示读取、远端支持幂等的可重试写、不可安全重试写。不要为方便重试而把任意写标为 `retryableWrite`。
+
+出站 IO 与业务数据库不共享事务，框架保存执行租约和回执以支持恢复，但不能回滚远端。结果未知的不可安全重试写会隔离；当前没有通用确认远端回执或解除 unknown 的管理接口，普通死信重放不能替代业务核对。连接器限流是每进程预算，多实例共享限流需另行设计。
+
+## 文档
+
+- [事件、出站与事务边界](https://github.com/shunshunyue/cage/blob/main/docs/ai/architecture.md)
+- [采购 ERP 完整声明](https://github.com/shunshunyue/cage/blob/main/examples/purchase-admin/packages/domain/src/integrations/erp.ts)
+- [排错方法](https://github.com/shunshunyue/cage/blob/main/docs/ai/troubleshooting.md)
+
+源码与反馈：[GitHub](https://github.com/shunshunyue/cage)。许可证：[MIT](https://github.com/shunshunyue/cage/blob/main/LICENSE)。

package/dist/index.d.ts

@@ -1,2 +1,7 @@
+/**
+ * 声明入口提供外部协议与事件映射，运行入口负责真实 IO/fake 和恢复协议。
+ * 业务 handler 不直接调用此包的网络接口；异步写入通过 outbound，入站结果通过领域命令落实。
+ */
+export { streamJson } from './stream.js';
 export { connector, op, outbound, inbound, hmacSha256, type Connector, type ConnectorDef, type Op, type OpDef, type Effect, type Outbound, type Inbound, type Verifier, } from './primitives.js';
 export { call, stage, secrets, setSecretProvider, fakeConnector, fakeCalls, sampleFromSchema, outboundConsumer, ConnectorError, type SecretProvider, } from './runtime.js';

package/dist/index.js

@@ -1,4 +1,9 @@
 // @yss123/cage-connectors：第三方连接器原语与运行时。
+/**
+ * 声明入口提供外部协议与事件映射，运行入口负责真实 IO/fake 和恢复协议。
+ * 业务 handler 不直接调用此包的网络接口；异步写入通过 outbound，入站结果通过领域命令落实。
+ */
+export { streamJson } from './stream.js';
 export { connector, op, outbound, inbound, hmacSha256, } from './primitives.js';
 export { call, stage, secrets, setSecretProvider, fakeConnector, fakeCalls, sampleFromSchema, outboundConsumer, ConnectorError, } from './runtime.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EACL,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAE7C,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,GAEtH,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAE7C,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,GAEtH,MAAM,cAAc,CAAC"}

package/dist/primitives.d.ts

@@ -3,6 +3,7 @@ import type { EventConsumer } from '@yss123/cage-kernel/worker';
 import { z } from 'zod';
 /** 副作用等级：read 只读；retryableWrite 可重试写（对方按幂等键去重）；write 不可重试写（失败直接进死信，人工处理） */
 export type Effect = 'read' | 'retryableWrite' | 'write';
+/** 声明单次外部协议；effect 必须反映远端真实幂等保证，不能仅为方便重试而标 retryableWrite。 */
 export interface OpDef<Req extends z.ZodObject<any> = z.ZodObject<any>, Res extends z.ZodType = z.ZodType> {
     effect: Effect;
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
@@ -16,7 +17,9 @@ export interface Op<Req extends z.ZodObject<any> = z.ZodObject<any>, Res extends
     readonly name: string;
     readonly connector: Connector;
 }
+/** 保存操作规格并检查绝对路径形式；此时没有连接器环境/密钥，也不会发出请求。 */
 export declare function op<Req extends z.ZodObject<any>, Res extends z.ZodType>(def: OpDef<Req, Res>): OpDef<Req, Res>;
+/** 外部系统的固定边界；hosts 按运行阶段选择，密钥仅声明名字，超时毫秒、限流每秒请求数。 */
 export interface ConnectorDef<Ops extends Record<string, OpDef<any, any>>> {
     /** 地址白名单：按环境各一个，代码里写不了任意地址 */
     hosts: {
@@ -53,6 +56,10 @@ export interface Connector<Ops extends Record<string, OpDef<any, any>> = Record<
         readonly [K in keyof Ops]: Op<Ops[K]['request'], Ops[K]['response']>;
     };
 }
+/**
+ * 校验名称、超时、限流与主机形式，冻结操作并回链到所属连接器。
+ * hosts 不含路径/协议，运行时按阶段选择；构造不读取密钥或访问网络，便于静态抽取与离线检查。
+ */
 export declare function connector<Ops extends Record<string, OpDef<any, any>>>(name: string, def: ConnectorDef<Ops>): Connector<Ops>;
 export interface Outbound<E extends AnyEvent = AnyEvent, O extends Op = Op> {
     readonly [OUTBOUND]: true;
@@ -70,6 +77,10 @@ export interface Outbound<E extends AnyEvent = AnyEvent, O extends Op = Op> {
     readonly fields?: readonly string[];
     readonly [CONSUMERS]: (k: Kernel) => EventConsumer[];
 }
+/**
+ * 把领域事件映射为事务外写操作；只读操作不允许挂出站，成功回写必须指向领域命令。
+ * map 返回 null 可跳过当前事件，幂等键需要跨重投稳定；消费器由 CONSUMERS 在 worker 装配。
+ */
 export declare function outbound<E extends AnyEvent, O extends Op>(ev: E, operation: O, def: {
     idempotencyKey: (e: PayloadOf<E>) => string;
     map: (e: PayloadOf<E>) => z.input<O['request']> | null;
@@ -79,12 +90,14 @@ export declare function outbound<E extends AnyEvent, O extends Op>(ev: E, operat
     };
     fields?: string[];
 }): Outbound<E, O>;
+/** 入站原始字节验签协议；secret 是注入名称，verify 不解析业务载荷或决定其领域权限。 */
 export interface Verifier {
     readonly kind: string;
     readonly secret: string;
     verify(rawBody: string, headers: Record<string, string | string[] | undefined>, secretValue: string): boolean;
 }
 /** HMAC-SHA256 验签：签名放在请求头（默认 x-signature），值为 hex 或 sha256=hex */
+/** 签名基于原始正文计算，接受 hex 或 sha256=hex；长度校验后恒定时间比较，不能对解析后 JSON 重算。 */
 export declare function hmacSha256(secret: string, opts?: {
     header?: string;
 }): Verifier;
@@ -99,6 +112,10 @@ export interface Inbound<P extends z.ZodType = z.ZodType> {
     readonly command: AnyCommand;
     readonly map: (p: z.output<P>) => unknown;
 }
+/**
+ * 声明验签后的回调映射，HTTP 适配器校验载荷后以 external 身份执行目标命令。
+ * 事件名决定自动路由；这里不注册服务器，也不因签名通过而绕过命令状态、版本或业务约束。
+ */
 export declare function inbound<P extends z.ZodType>(conn: Connector<any>, eventName: string, def: {
     verify: Verifier;
     payload: P;

package/dist/primitives.js

@@ -2,14 +2,25 @@
 import { createHmac, timingSafeEqual } from 'node:crypto';
 import { CONNECTOR, CONSUMERS, INBOUND, OUTBOUND, declError, } from '@yss123/cage-kernel';
 import { outboundConsumer } from './runtime.js';
+/** 保存操作规格并检查绝对路径形式；此时没有连接器环境/密钥，也不会发出请求。 */
 export function op(def) {
     if (!def.path.startsWith('/'))
         throw declError('CAGE-CONN-002', `操作路径 ${def.path} 必须以 / 开头`);
     return def;
 }
+/**
+ * 校验名称、超时、限流与主机形式，冻结操作并回链到所属连接器。
+ * hosts 不含路径/协议，运行时按阶段选择；构造不读取密钥或访问网络，便于静态抽取与离线检查。
+ */
 export function connector(name, def) {
     if (!/^[a-z][a-z0-9-]*$/.test(name))
         throw declError('CAGE-CONN-001', `连接器名 ${name} 必须是小写短横线`);
+    if (def.timeoutMs !== undefined && (!Number.isSafeInteger(def.timeoutMs) || def.timeoutMs <= 0 || def.timeoutMs > 300_000)) {
+        throw declError('CAGE-CONN-015', '连接器 timeoutMs 必须是 1～300000 毫秒的整数');
+    }
+    if (def.rateLimit && (!Number.isFinite(def.rateLimit.perSecond) || def.rateLimit.perSecond <= 0)) {
+        throw declError('CAGE-CONN-015', '连接器 rateLimit.perSecond 必须为有限正数');
+    }
     for (const h of Object.values(def.hosts)) {
         if (h && /[/:\s]/.test(h.replace(/:\d+$/, '')))
             throw declError('CAGE-CONN-003', `地址白名单只能写主机名（可带端口）：${h}`);
@@ -26,6 +37,10 @@ export function connector(name, def) {
     c.operations = Object.freeze(Object.fromEntries(Object.entries(def.operations).map(([k, o]) => [k, Object.freeze({ ...o, name: k, connector: c })])));
     return Object.freeze(c);
 }
+/**
+ * 把领域事件映射为事务外写操作；只读操作不允许挂出站，成功回写必须指向领域命令。
+ * map 返回 null 可跳过当前事件，幂等键需要跨重投稳定；消费器由 CONSUMERS 在 worker 装配。
+ */
 export function outbound(ev, operation, def) {
     if (operation.effect === 'read')
         throw declError('CAGE-CONN-004', '只读操作不能用于出站映射');
@@ -42,6 +57,7 @@ export function outbound(ev, operation, def) {
     return Object.freeze(o);
 }
 /** HMAC-SHA256 验签：签名放在请求头（默认 x-signature），值为 hex 或 sha256=hex */
+/** 签名基于原始正文计算，接受 hex 或 sha256=hex；长度校验后恒定时间比较，不能对解析后 JSON 重算。 */
 export function hmacSha256(secret, opts = {}) {
     const header = (opts.header ?? 'x-signature').toLowerCase();
     return Object.freeze({
@@ -56,6 +72,10 @@ export function hmacSha256(secret, opts = {}) {
         },
     });
 }
+/**
+ * 声明验签后的回调映射，HTTP 适配器校验载荷后以 external 身份执行目标命令。
+ * 事件名决定自动路由；这里不注册服务器，也不因签名通过而绕过命令状态、版本或业务约束。
+ */
 export function inbound(conn, eventName, def) {
     if (!/^[a-z][A-Za-z0-9]*$/.test(eventName))
         throw declError('CAGE-CONN-005', `入站事件名 ${eventName} 必须是小驼峰`);

package/dist/primitives.js.map

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

package/dist/runtime.d.ts

@@ -4,15 +4,25 @@ import { z } from 'zod';
 import type { Connector, Op, Outbound } from './primitives.js';
 /** 运行阶段：fake（本地与 CI，不访问网络）、test（第三方沙箱）、prod */
 export declare function stage(): string;
+/** 运行时秘密读取接口；实现可接环境变量或密钥服务，调用者不得把返回值写入日志。 */
 export interface SecretProvider {
     get(name: string): Promise<string>;
 }
+/** 替换进程级秘密提供器；动态多租户模型应使用单次 credential 回调，避免改变全局配置串用凭据。 */
 export declare function setSecretProvider(p: SecretProvider): void;
 export declare const secrets: {
     get: (name: string) => Promise<string>;
 };
-export declare function take(c: Connector<any>): Promise<void>;
-type FakeHandler = (req: any) => unknown | Promise<unknown>;
+/**
+ * 按连接器名维护单进程令牌桶，等待时间算入上层超时并支持取消。
+ * perSecond 可小于 1，但桶至少容纳一次请求；此预算不协调多个 API/worker 进程。
+ */
+export declare function take(c: Connector<any>, signal?: AbortSignal): Promise<void>;
+type FakeHandler = (req: any, context: {
+    key: string;
+    signal: AbortSignal;
+}) => unknown | Promise<unknown>;
+/** fake 阶段的内存调用轨迹，供测试断言；不是生产录制平台，测试需要自行管理累计记录。 */
 export declare const fakeCalls: {
     connector: string;
     operation: string;
@@ -23,16 +33,29 @@ export declare const fakeCalls: {
 export declare function fakeConnector(c: Connector<any>, handlers: Record<string, FakeHandler>): void;
 /** 没有注册 fake 时按响应 schema 造一个示例值 */
 export declare function sampleFromSchema(schema: z.ZodType, seed?: string): unknown;
+/**
+ * retryable 表示协议允许自动再试；outcome 区分已知拒绝和远端结果未知，二者不可互相推断。
+ * status=null 表示未取得 HTTP 状态，providerCode 仅携带已筛选稳定错误码，不存原始响应正文。
+ */
 export declare class ConnectorError extends Error {
     readonly status: number | null;
     readonly retryable: boolean;
-    constructor(message: string, status: number | null, retryable: boolean);
+    readonly outcome: 'rejected' | 'unknown';
+    readonly providerCode?: string | undefined;
+    constructor(message: string, status: number | null, retryable: boolean, outcome?: 'rejected' | 'unknown', providerCode?: string | undefined);
 }
 /** 调用一个连接器操作。白名单外的字段直接报错，不会被悄悄发出去。 */
+/**
+ * 先严格校验请求白名单，再按阶段走 fake 或真实主机；真实请求携带同一个幂等键和按需密钥。
+ * 总超时包含令牌等待、请求和响应读取；响应必须符合 schema 才交付，失败归一为 ConnectorError。
+ * 本函数只做一次调用，不自行重试；外部副作用能否重试由 effect 与 outbox 消费策略共同决定。
+ */
 export declare function call(o: Op, payload: unknown, key: string, opts?: {
     kernel?: Kernel;
     tenantId?: string;
+    signal?: AbortSignal;
 }): Promise<any>;
-/** 出站映射的事件消费者：调用第三方，成功后以 external 身份执行回写命令，和去重登记同一个事务 */
+/** 出站网络执行与短事务回写分离；回写命令与 processed_event 去重登记共同提交。 */
+/** prepare 完成网络/回执，handle 仅做短事务命令回写；不可重试异常明确标永久错误进入死信。 */
 export declare function outboundConsumer(k: Kernel, ob: Outbound): EventConsumer;
 export {};

package/dist/runtime.js

@@ -1,5 +1,7 @@
 // 连接器运行时：每一道管控都在这里发生——字段白名单、地址白名单、密钥、限流、超时、调用记录、响应校验。
 import { systemCtx } from '@yss123/cage-kernel';
+import { createHash, randomUUID } from 'node:crypto';
+import { setTimeout as delay } from 'node:timers/promises';
 import { sql } from 'kysely';
 import { z } from 'zod';
 /** 运行阶段：fake（本地与 CI，不访问网络）、test（第三方沙箱）、prod */
@@ -14,20 +16,27 @@ let secretProvider = {
         return v;
     },
 };
+/** 替换进程级秘密提供器；动态多租户模型应使用单次 credential 回调，避免改变全局配置串用凭据。 */
 export function setSecretProvider(p) {
     secretProvider = p;
 }
 export const secrets = { get: (name) => secretProvider.get(name) };
 // ---------------- 限流 ----------------
 const buckets = new Map();
-export async function take(c) {
+/**
+ * 按连接器名维护单进程令牌桶，等待时间算入上层超时并支持取消。
+ * perSecond 可小于 1，但桶至少容纳一次请求；此预算不协调多个 API/worker 进程。
+ */
+export async function take(c, signal) {
     const rate = c.rateLimit?.perSecond;
     if (!rate)
         return;
+    const capacity = Math.max(1, rate); // 低于每秒一次时仍需容纳一个完整令牌。
     for (;;) {
+        signal?.throwIfAborted();
         const now = Date.now();
-        const b = buckets.get(c.name) ?? { tokens: rate, at: now };
-        b.tokens = Math.min(rate, b.tokens + ((now - b.at) / 1000) * rate);
+        const b = buckets.get(c.name) ?? { tokens: capacity, at: now };
+        b.tokens = Math.min(capacity, b.tokens + ((now - b.at) / 1000) * rate);
         b.at = now;
         if (b.tokens >= 1) {
             b.tokens -= 1;
@@ -35,10 +44,11 @@ export async function take(c) {
             return;
         }
         buckets.set(c.name, b);
-        await new Promise((r) => setTimeout(r, Math.ceil(((1 - b.tokens) / rate) * 1000)));
+        await delay(Math.ceil(((1 - b.tokens) / rate) * 1000), undefined, { signal });
     }
 }
 const fakes = new Map();
+/** fake 阶段的内存调用轨迹，供测试断言；不是生产录制平台，测试需要自行管理累计记录。 */
 export const fakeCalls = [];
 /** 注册 fake 实现：fakeConnector(erp, { pushOrder: (req) => ({ erpNo: 'FAKE-' + req.externalId }) }) */
 export function fakeConnector(c, handlers) {
@@ -76,16 +86,25 @@ export function sampleFromSchema(schema, seed = 'fake') {
     return gen(js);
 }
 // ---------------- 调用 ----------------
+/**
+ * retryable 表示协议允许自动再试；outcome 区分已知拒绝和远端结果未知，二者不可互相推断。
+ * status=null 表示未取得 HTTP 状态，providerCode 仅携带已筛选稳定错误码，不存原始响应正文。
+ */
 export class ConnectorError extends Error {
     status;
     retryable;
-    constructor(message, status, retryable) {
+    outcome;
+    providerCode;
+    constructor(message, status, retryable, outcome = 'rejected', providerCode) {
         super(message);
         this.status = status;
         this.retryable = retryable;
+        this.outcome = outcome;
+        this.providerCode = providerCode;
         this.name = 'ConnectorError';
     }
 }
+/** 同步记录供运维查看，失败仅告警；可靠成功回执另存 connector_execution，不能依赖本日志恢复去重。 */
 async function recordCall(k, o, key, tenantId, status, httpStatus, request, response, error) {
     if (!k)
         return;
@@ -95,87 +114,179 @@ async function recordCall(k, o, key, tenantId, status, httpStatus, request, resp
         tenant_id: tenantId, connector: o.connector.name, operation: o.name, idempotency_key: key, ref_id: key, status,
         http_status: httpStatus, request: JSON.stringify(request), response: response === undefined ? null : JSON.stringify(response), error: error ?? null,
     })
-        .onConflict((oc) => oc.columns(['connector', 'operation', 'idempotency_key']).doUpdateSet({
+        .onConflict((oc) => oc.columns(['tenant_id', 'connector', 'operation', 'idempotency_key']).doUpdateSet({
         status, http_status: httpStatus, attempts: sql `sys.sync_record.attempts + 1`, response: response === undefined ? null : JSON.stringify(response),
         error: error ?? null, updated_at: sql `now()`,
     }))
         .execute()
         .catch((e) => k.log.warn({ err: String(e) }, '同步记录写入失败'));
 }
+/** 将取消与实际 Promise 竞争，确保 fake 也遵守调用超时；底层工作仍应主动监听 signal 释放资源。 */
+async function abortable(signal, run) {
+    signal.throwIfAborted();
+    let onAbort = () => { };
+    const aborted = new Promise((_resolve, reject) => {
+        onAbort = () => reject(signal.reason);
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+    try {
+        return await Promise.race([run(), aborted]);
+    }
+    finally {
+        signal.removeEventListener('abort', onAbort);
+    }
+}
 /** 调用一个连接器操作。白名单外的字段直接报错，不会被悄悄发出去。 */
+/**
+ * 先严格校验请求白名单，再按阶段走 fake 或真实主机；真实请求携带同一个幂等键和按需密钥。
+ * 总超时包含令牌等待、请求和响应读取；响应必须符合 schema 才交付，失败归一为 ConnectorError。
+ * 本函数只做一次调用，不自行重试；外部副作用能否重试由 effect 与 outbox 消费策略共同决定。
+ */
 export async function call(o, payload, key, opts = {}) {
     const body = o.request.strict().parse(payload);
-    const st = stage();
-    if (st === 'fake') {
-        const h = fakes.get(`${o.connector.name}.${o.name}`);
-        const res = h ? await h(body) : sampleFromSchema(o.response, o.connector.name);
-        fakeCalls.push({ connector: o.connector.name, operation: o.name, request: body, key });
-        const parsed = o.response.parse(res);
-        await recordCall(opts.kernel, o, key, opts.tenantId ?? null, 'ok', 200, body, parsed);
-        return parsed;
-    }
-    const host = o.connector.hosts[st];
-    if (!host)
-        throw new ConnectorError(`[CAGE-CONN-007] 连接器 ${o.connector.name} 没有 ${st} 环境的地址`, null, false);
-    const token = o.connector.secret ? await secrets.get(o.connector.secret) : undefined;
-    await take(o.connector);
-    const url = new URL(o.path, `https://${host}`);
-    if (o.method === 'GET')
-        for (const [k, v] of Object.entries(body))
-            url.searchParams.set(k, String(v));
-    let res;
+    const timeout = AbortSignal.timeout(o.connector.timeoutMs);
+    const signal = opts.signal ? AbortSignal.any([opts.signal, timeout]) : timeout;
+    let httpStatus = null;
     try {
-        // 生产环境出站流量经过出口代理：设置 HTTPS_PROXY 与 NODE_USE_ENV_PROXY=1
-        res = await fetch(url, {
-            method: o.method,
-            headers: {
-                'content-type': 'application/json',
-                ...(token ? { authorization: `Bearer ${token}` } : {}),
-                'idempotency-key': key,
-            },
-            body: o.method === 'GET' ? undefined : JSON.stringify(body),
-            signal: AbortSignal.timeout(o.connector.timeoutMs),
+        const parsed = await abortable(signal, async () => {
+            const st = stage();
+            if (st === 'fake') {
+                const h = fakes.get(`${o.connector.name}.${o.name}`);
+                fakeCalls.push({ connector: o.connector.name, operation: o.name, request: body, key });
+                const response = h ? await h(body, { key, signal }) : sampleFromSchema(o.response, o.connector.name);
+                httpStatus = 200;
+                return o.response.parse(response);
+            }
+            const host = o.connector.hosts[st];
+            if (!host)
+                throw new ConnectorError(`[CAGE-CONN-007] 连接器 ${o.connector.name} 没有 ${st} 环境的地址`, null, false);
+            const token = o.connector.secret ? await secrets.get(o.connector.secret) : undefined;
+            await take(o.connector, signal);
+            const url = new URL(o.path, `https://${host}`);
+            if (o.method === 'GET')
+                for (const [field, value] of Object.entries(body))
+                    url.searchParams.set(field, String(value));
+            // 超时覆盖限流等待、请求和响应体读取，关闭 worker 同样能取消在途网络 IO。
+            const res = await fetch(url, {
+                method: o.method,
+                headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}), 'idempotency-key': key },
+                body: o.method === 'GET' ? undefined : JSON.stringify(body), signal,
+            });
+            httpStatus = res.status;
+            const text = await res.text();
+            let json = null;
+            try {
+                json = text ? JSON.parse(text) : null;
+            }
+            catch { /* 无效响应由下方 schema 统一诊断，不记录原文。 */ }
+            if (!res.ok)
+                throw new ConnectorError(`[CAGE-CONN-009] ${o.connector.name}.${o.name} 返回 ${res.status}`, res.status, o.effect !== 'write' && (res.status >= 500 || res.status === 429), res.status >= 500 ? 'unknown' : 'rejected');
+            const result = o.response.safeParse(json);
+            if (!result.success)
+                throw new ConnectorError(`[CAGE-CONN-010] ${o.connector.name}.${o.name} 的响应格式与声明不符`, res.status, false, 'unknown');
+            return result.data;
         });
+        await recordCall(opts.kernel, o, key, opts.tenantId ?? null, 'ok', httpStatus, body, parsed);
+        return parsed;
     }
     catch (e) {
-        await recordCall(opts.kernel, o, key, opts.tenantId ?? null, 'failed', null, body, undefined, String(e));
-        throw new ConnectorError(`[CAGE-CONN-008] 调用 ${o.connector.name}.${o.name} 失败：${String(e)}`, null, true);
+        const err = e instanceof ConnectorError ? e : new ConnectorError(`[CAGE-CONN-008] 调用 ${o.connector.name}.${o.name} 失败：${e?.name ?? 'Error'}`, httpStatus, o.effect !== 'write', 'unknown');
+        await recordCall(opts.kernel, o, key, opts.tenantId ?? null, 'failed', httpStatus, body, undefined, err.message);
+        throw err;
     }
-    const text = await res.text();
-    let json = null;
+}
+/** 对对象键排序、保留数组次序以生成请求摘要，拒绝同一业务幂等键被不同请求内容复用。 */
+function canonical(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    return `{${Object.keys(value).sort().filter((key) => value[key] !== undefined).map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`).join(',')}}`;
+}
+/** 先持久化意图，释放连接后才外呼；成功回执先提交，后续本地回写失败不再外呼。 */
+/**
+ * 短事务内声明执行意图并领取租约：摘要不符拒绝，已有成功直接复用回执，unknown 隔离禁止重发。
+ * 不可重试写的过期 calling 租约也转 unknown，因为进程中断不能证明远端未执行。
+ * 释放数据库连接后外呼，成功用租约 token 条件保存回执；后续本地回写失败可重放回执而无需重复外呼。
+ * 远端成功但回执未落库的窗口仍依赖远端幂等协议，不能宣称任意外部系统恰好一次。
+ */
+async function prepareOutbound(k, ob, row, consumer, signal) {
+    const mapped = ob.map(row.payload);
+    if (mapped === null || mapped === undefined)
+        return { skipped: true };
+    const body = ob.op.request.strict().parse(mapped);
+    const key = ob.idempotencyKey(row.payload);
+    if (!key || typeof key !== 'string')
+        throw new ConnectorError('[CAGE-CONN-013] 出站幂等键必须为非空字符串', null, false);
+    const requestHash = createHash('sha256').update(canonical(body)).digest('hex');
+    const identity = { tenant_id: row.tenant_id, connector: ob.op.connector.name, operation: ob.op.name, idempotency_key: key };
+    const locate = (db) => db.selectFrom('sys.connector_execution').selectAll()
+        .where('tenant_id', '=', identity.tenant_id).where('connector', '=', identity.connector)
+        .where('operation', '=', identity.operation).where('idempotency_key', '=', identity.idempotency_key);
+    const token = randomUUID();
+    const claim = await k.app.transaction().execute(async (tx) => {
+        await tx.insertInto('sys.connector_execution').values({ ...identity, request_hash: requestHash, status: 'planned', outbox_id: row.id, consumer })
+            .onConflict((oc) => oc.columns(['tenant_id', 'connector', 'operation', 'idempotency_key']).doNothing()).execute();
+        const previous = await locate(tx).forUpdate().executeTakeFirstOrThrow();
+        if (previous.request_hash !== requestHash)
+            return { kind: 'conflict' };
+        if (previous.status === 'succeeded')
+            return { kind: 'receipt', response: previous.response };
+        if (previous.status === 'unknown')
+            return { kind: 'unknown' };
+        if (previous.status === 'calling' && previous.lease_until && new Date(previous.lease_until).getTime() > Date.now())
+            return { kind: 'busy' };
+        if (previous.status === 'calling' && ob.op.effect === 'write') {
+            await tx.updateTable('sys.connector_execution').set({ status: 'unknown', error: '执行租约中断，远端结果需人工核对', updated_at: sql `now()` })
+                .where('tenant_id', '=', identity.tenant_id).where('connector', '=', identity.connector).where('operation', '=', identity.operation).where('idempotency_key', '=', key).execute();
+            return { kind: 'unknown' };
+        }
+        await tx.updateTable('sys.connector_execution')
+            .set({ status: 'calling', lease_token: token, lease_until: new Date(Date.now() + ob.op.connector.timeoutMs + 30_000), attempts: sql `attempts + 1`, error: null, updated_at: sql `now()` })
+            .where('tenant_id', '=', identity.tenant_id).where('connector', '=', identity.connector).where('operation', '=', identity.operation).where('idempotency_key', '=', key).execute();
+        return { kind: 'claimed' };
+    });
+    if (claim.kind === 'conflict')
+        throw new ConnectorError(`[CAGE-CONN-013] ${consumer} 同一幂等键对应不同请求；禁止覆盖已有执行`, null, false);
+    if (claim.kind === 'unknown')
+        throw new ConnectorError(`[CAGE-CONN-014] ${consumer} 的不可重试调用结果未知；人工核对远端后再恢复`, null, false, 'unknown');
+    if (claim.kind === 'busy')
+        throw new ConnectorError(`${consumer} 的调用仍由其他执行者持有`, null, true);
+    if (claim.kind === 'receipt')
+        return { skipped: false, response: ob.op.response.parse(claim.response) };
+    let response;
     try {
-        json = text ? JSON.parse(text) : null;
-    }
-    catch {
-        json = { raw: text.slice(0, 500) };
-    }
-    if (!res.ok) {
-        await recordCall(opts.kernel, o, key, opts.tenantId ?? null, 'failed', res.status, body, json);
-        const retryable = o.effect === 'retryableWrite' || o.effect === 'read' ? res.status >= 500 || res.status === 429 : false;
-        throw new ConnectorError(`[CAGE-CONN-009] ${o.connector.name}.${o.name} 返回 ${res.status}`, res.status, retryable);
+        // 回调声明的业务键可能只在租户内唯一；外发键补租户命名空间，重试始终复用。
+        response = await call(ob.op, body, `${row.tenant_id}:${key}`, { signal });
     }
-    const parsed = o.response.safeParse(json);
-    if (!parsed.success) {
-        await recordCall(opts.kernel, o, key, opts.tenantId ?? null, 'failed', res.status, body, json, '响应格式不符合声明');
-        throw new ConnectorError(`[CAGE-CONN-010] ${o.connector.name}.${o.name} 的响应格式与声明不符`, res.status, false);
+    catch (e) {
+        const err = e;
+        const unknown = ob.op.effect === 'write' && err.outcome === 'unknown';
+        await k.app.updateTable('sys.connector_execution')
+            .set({ status: unknown ? 'unknown' : 'failed', error: String(err.message), lease_token: null, lease_until: null, updated_at: sql `now()` })
+            .where('tenant_id', '=', identity.tenant_id).where('connector', '=', identity.connector).where('operation', '=', identity.operation).where('idempotency_key', '=', key).where('lease_token', '=', token).execute();
+        await recordCall(k, ob.op, key, row.tenant_id, 'failed', err.status, body, undefined, err.message);
+        throw err;
     }
-    await recordCall(opts.kernel, o, key, opts.tenantId ?? null, 'ok', res.status, body, parsed.data);
-    return parsed.data;
+    // 此处崩溃仍只能依靠远端幂等协议。不可重试写的租约超期会进入 unknown，不盲目重发。
+    const saved = await k.app.updateTable('sys.connector_execution')
+        .set({ status: 'succeeded', response: JSON.stringify(response), error: null, lease_token: null, lease_until: null, updated_at: sql `now()` })
+        .where('tenant_id', '=', identity.tenant_id).where('connector', '=', identity.connector).where('operation', '=', identity.operation).where('idempotency_key', '=', key).where('lease_token', '=', token).executeTakeFirst();
+    if (Number(saved.numUpdatedRows) !== 1)
+        throw new ConnectorError(`${consumer} 执行租约已失效，未提交本地回写`, null, true, 'unknown');
+    await recordCall(k, ob.op, key, row.tenant_id, 'ok', 200, body, response);
+    return { skipped: false, response };
 }
-/** 出站映射的事件消费者：调用第三方，成功后以 external 身份执行回写命令，和去重登记同一个事务 */
+/** 出站网络执行与短事务回写分离；回写命令与 processed_event 去重登记共同提交。 */
+/** prepare 完成网络/回执，handle 仅做短事务命令回写；不可重试异常明确标永久错误进入死信。 */
 export function outboundConsumer(k, ob) {
     const name = `outbound:${ob.op.connector.name}.${ob.op.name}:${ob.event.name}`;
     return {
         name,
         event: ob.event.name,
-        async handle(row, tx) {
-            const req = ob.map(row.payload);
-            if (req === null || req === undefined)
-                return;
-            const key = ob.idempotencyKey(row.payload);
-            let res;
+        async prepare(row, _kernel, { signal }) {
             try {
-                res = await call(ob.op, req, key, { kernel: k, tenantId: row.tenant_id });
+                return await prepareOutbound(k, ob, row, name, signal);
             }
             catch (e) {
                 if (e instanceof ConnectorError && !e.retryable) {
@@ -184,8 +295,15 @@ export function outboundConsumer(k, ob) {
                 }
                 throw e;
             }
+        },
+        async handle(row, tx, _kernel, prepared) {
+            if (!prepared)
+                throw new Error('[CAGE-WORKER-002] 出站消费者必须经 worker prepare 阶段执行');
+            const result = prepared;
+            if (result.skipped)
+                return;
             if (ob.onSuccess) {
-                const input = ob.onSuccess.map(res, row.payload);
+                const input = ob.onSuccess.map(result.response, row.payload);
                 const ctx = systemCtx({ kind: 'external', name: ob.op.connector.name, tenantId: row.tenant_id, capabilities: [k.registry.capabilityOf(ob.onSuccess.command)], requestId: row.request_id ?? undefined });
                 await k.executeIn(tx, ob.onSuccess.command, input, ctx, 0);
             }

package/dist/runtime.js.map

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

package/dist/stream.d.ts

@@ -0,0 +1,12 @@
+import type { Connector } from './primitives.js';
+/** 模型等流式协议共用连接器的地址、密钥、限流和取消边界。响应正文不写通用日志。 */
+/**
+ * 只向所选白名单主机 POST，禁止重定向和 fake 外呼；凭据可按本次调用独立读取。
+ * 逐块 UTF-8 解码并按 SSE 空行合并多个 data 行，await onData 提供消费背压；总响应上限 4 MiB。
+ * 取消、超限或回调失败都向上传播，finally 取消 reader 并释放锁；HTTP 错误只保留状态和稳定供应商码。
+ */
+export declare function streamJson(connector: Connector, path: string, body: unknown, signal: AbortSignal, onData: (data: string) => Promise<void>, options?: {
+    environment?: string;
+    protocol?: 'http:' | 'https:';
+    credential?: () => Promise<string>;
+}): Promise<void>;

package/dist/stream.js

@@ -0,0 +1,84 @@
+/**
+ * 模型等 SSE 请求的传输适配：复用连接器主机、密钥、限流和超时边界，只传递 data 帧文本。
+ * JSON 业务解析与模型语义由上层负责，本层不记录提示词、响应正文或多租户凭据。
+ */
+import { ConnectorError, secrets, stage, take } from './runtime.js';
+/** 模型等流式协议共用连接器的地址、密钥、限流和取消边界。响应正文不写通用日志。 */
+/**
+ * 只向所选白名单主机 POST，禁止重定向和 fake 外呼；凭据可按本次调用独立读取。
+ * 逐块 UTF-8 解码并按 SSE 空行合并多个 data 行，await onData 提供消费背压；总响应上限 4 MiB。
+ * 取消、超限或回调失败都向上传播，finally 取消 reader 并释放锁；HTTP 错误只保留状态和稳定供应商码。
+ */
+export async function streamJson(connector, path, body, signal, onData, options = {}) {
+    const environment = options.environment ?? stage(), protocol = options.protocol ?? 'https:';
+    if (!path.startsWith('/') || path.startsWith('//'))
+        throw new ConnectorError('流式操作需要同主机绝对路径', null, false);
+    const host = connector.hosts[environment];
+    if (environment === 'fake')
+        throw new ConnectorError('fake 环境必须显式配置模型 fake，禁止外呼', null, false);
+    if (!host)
+        throw new ConnectorError('当前阶段未配置连接器地址', null, false);
+    const abort = AbortSignal.any([signal, AbortSignal.timeout(connector.timeoutMs)]);
+    await take(connector, abort);
+    // 每次调用独立提供凭据，动态模型不得改动全局 SecretProvider 而串用其他租户密钥。
+    const token = options.credential ? await options.credential() : connector.secret ? await secrets.get(connector.secret) : undefined;
+    const url = new URL(path, `${protocol}//${host}`);
+    if (url.host !== host || url.protocol !== protocol || !['http:', 'https:'].includes(protocol))
+        throw new ConnectorError('流式地址超出连接器白名单', null, false);
+    const response = await fetch(url, { method: 'POST', redirect: 'error', signal: abort,
+        headers: { 'content-type': 'application/json', accept: 'text/event-stream', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+        body: JSON.stringify(body) });
+    if (!response.ok || !response.body) {
+        // 只提取供应商的稳定错误码/特定兼容性标记，不把响应正文写入日志或 Cage 运行记录。
+        let providerCode;
+        try {
+            const payload = await response.clone().json(), message = String(payload?.message ?? payload?.error?.message ?? '');
+            const code = payload?.code ?? payload?.error?.code;
+            if (typeof code === 'string' && /^[A-Za-z0-9_.-]{1,100}$/.test(code))
+                providerCode = code;
+            if (/previous_response_id\s+requires/i.test(message))
+                providerCode = 'PREVIOUS_RESPONSE_ID_UNSUPPORTED';
+        }
+        catch { /* 非 JSON 错误只保留 HTTP 状态 */ }
+        await response.body?.cancel();
+        throw new ConnectorError(`模型连接器返回 ${response.status}`, response.status, response.status === 429 || response.status >= 500, 'rejected', providerCode);
+    }
+    const reader = response.body.getReader(), decoder = new TextDecoder();
+    let buffer = '', bytes = 0, data = [];
+    const line = async (value) => {
+        if (!value) {
+            if (data.length)
+                await onData(data.join('\n'));
+            data = [];
+        }
+        else if (value.startsWith('data:'))
+            data.push(value.slice(5).replace(/^ /, ''));
+    };
+    try {
+        for (;;) {
+            abort.throwIfAborted();
+            const chunk = await reader.read();
+            if (chunk.done)
+                break;
+            bytes += chunk.value.byteLength;
+            if (bytes > 4 * 1024 * 1024)
+                throw new ConnectorError('模型响应超过 4 MiB', response.status, false);
+            buffer += decoder.decode(chunk.value, { stream: true });
+            let end;
+            while ((end = buffer.indexOf('\n')) >= 0) {
+                const value = buffer.slice(0, end).replace(/\r$/, '');
+                buffer = buffer.slice(end + 1);
+                await line(value);
+            }
+        }
+        buffer += decoder.decode();
+        if (buffer)
+            await line(buffer.replace(/\r$/, ''));
+        await line('');
+    }
+    finally {
+        await reader.cancel().catch(() => { });
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yss123/cage-connectors",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "第三方连接器原语与运行时",
   "type": "module",
   "main": "dist/index.js",
@@ -17,7 +17,7 @@
   "dependencies": {
     "zod": "^4.1.5",
     "kysely": "^0.28.5",
-    "@yss123/cage-kernel": "0.2.0"
+    "@yss123/cage-kernel": "0.3.1"
   },
   "license": "MIT",
   "repository": {