@atel-ai/runtime-core 0.1.0

package/dist/events/channel-spine.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 通道甲 —— Spine 事件订阅(/events/subscribe + /events/stream SSE)。
+ *
+ * 走 ATEL 公开面、点号领域事件,低延迟 push(START-HERE 架构正解)。
+ * 注意 5.19 prod 总结:outbox→fanout→SSE/webhook 管道已就位(metric fanout_ok),
+ * 但"投递到真实订阅者端到端"我们是第一个验证者 —— 故本通道做成可降级:
+ *   订阅成功 + SSE 连上 → 用之;SSE 401/501/断流 → 退避重连,失败则
+ *   完全依赖通道乙(relay 轮询)兜底。两通道同喂 dedup,重复无害。
+ *
+ * webhook 模式:由安装器把 callbackUrl 暴露成 HTTP,事件经 ingestWebhook 进同一 sink。
+ */
+import type { Identity } from '../identity.js';
+import type { EventSink } from './channel-relay.js';
+export interface SpineChannelOpts {
+    identity: Identity;
+    spineBaseUrl: string;
+    sink: EventSink;
+    deliveryMode: 'sse' | 'webhook';
+    callbackUrl?: string;
+    /** 可选:JWT 提供者(保留;SSE 连接用的是 stream-token,不是 JWT) */
+    tokenProvider?: () => Promise<string>;
+    log?: (msg: string) => void;
+}
+export declare class SpineChannel {
+    private readonly opts;
+    private stopped;
+    private controller?;
+    private backoffMs;
+    constructor(opts: SpineChannelOpts);
+    start(): Promise<void>;
+    stop(): void;
+    /** webhook 模式:外部 HTTP 服务收到回调后,把原始事件喂进来。 */
+    ingestWebhook(raw: unknown): Promise<void>;
+    private runSseLoop;
+    private connectSse;
+    private handleSseChunk;
+    /** 把 Spine fanout 的事件对象归一化(点号 type + payload)。 */
+    private normalizeStreamEvent;
+    private log;
+}
+//# sourceMappingURL=channel-spine.d.ts.map

package/dist/events/channel-spine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-spine.d.ts","sourceRoot":"","sources":["../../src/events/channel-spine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,KAAK,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAC,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAQ;gBAEI,IAAI,EAAE,gBAAgB;IAE7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B,IAAI,IAAI,IAAI;IAKZ,2CAA2C;IACrC,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAKlC,UAAU;YAgBV,UAAU;YAgCV,cAAc;IAkB5B,kDAAkD;IAClD,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,GAAG;CAGZ"}

package/dist/events/channel-spine.js

@@ -0,0 +1,139 @@
+import { spineSubscribe, spineStreamToken } from '../client.js';
+import { SPINE_TOPICS, normalizeEventType } from './types.js';
+import { computeDedupeKey } from './dedup.js';
+export class SpineChannel {
+    opts;
+    stopped = false;
+    controller;
+    backoffMs = 2000;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async start() {
+        this.stopped = false;
+        try {
+            const r = await spineSubscribe(this.opts.spineBaseUrl, this.opts.identity, SPINE_TOPICS, this.opts.deliveryMode, this.opts.callbackUrl);
+            if (r.ok || r.status === 409) {
+                this.log(`subscribed (${this.opts.deliveryMode}) topics=${SPINE_TOPICS.length}`);
+            }
+            else {
+                this.log(`subscribe HTTP ${r.status}: ${r.body.slice(0, 160)} — relay 兜底继续`);
+            }
+        }
+        catch (e) {
+            this.log(`subscribe failed: ${e.message} — relay 兜底继续`);
+        }
+        if (this.opts.deliveryMode === 'sse') {
+            void this.runSseLoop(); // 后台常驻,失败自重连
+        }
+    }
+    stop() {
+        this.stopped = true;
+        this.controller?.abort();
+    }
+    /** webhook 模式:外部 HTTP 服务收到回调后,把原始事件喂进来。 */
+    async ingestWebhook(raw) {
+        const ev = this.normalizeStreamEvent(raw);
+        if (ev)
+            await this.opts.sink(ev);
+    }
+    async runSseLoop() {
+        while (!this.stopped) {
+            try {
+                await this.connectSse();
+                this.backoffMs = 2000; // 正常结束(服务端关流)→ 重置退避
+            }
+            catch (e) {
+                const msg = e.message;
+                // 401/501 表示 SSE 这条暂不可用,拉长退避、降噪,继续靠 relay
+                const cold = /HTTP (401|403|404|501|502)/.test(msg);
+                this.log(`SSE ${cold ? 'unavailable' : 'error'}: ${msg}; reconnect in ${this.backoffMs}ms`);
+                await sleep(this.backoffMs);
+                this.backoffMs = Math.min(this.backoffMs * 2, cold ? 5 * 60_000 : 60_000);
+            }
+        }
+    }
+    async connectSse() {
+        // SSE 用一次性 stream-token(DID-Sig 换取,30s TTL,连上即消费),不是 Bearer JWT。
+        const { token } = await spineStreamToken(this.opts.spineBaseUrl, this.opts.identity);
+        this.controller = new AbortController();
+        const base = this.opts.spineBaseUrl.replace(/\/+$/, '');
+        const url = `${base}/events/stream?token=${encodeURIComponent(token)}`;
+        const res = await fetch(url, {
+            method: 'GET',
+            headers: { Accept: 'text/event-stream' },
+            signal: this.controller.signal,
+        });
+        if (!res.ok || !res.body) {
+            throw new Error(`HTTP ${res.status}`);
+        }
+        this.log('SSE connected');
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buf = '';
+        while (!this.stopped) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            // SSE 事件以空行分隔
+            let idx;
+            while ((idx = buf.indexOf('\n\n')) >= 0) {
+                const chunk = buf.slice(0, idx);
+                buf = buf.slice(idx + 2);
+                await this.handleSseChunk(chunk);
+            }
+        }
+    }
+    async handleSseChunk(chunk) {
+        const dataLines = chunk
+            .split('\n')
+            .filter((l) => l.startsWith('data:'))
+            .map((l) => l.slice(5).trim());
+        if (dataLines.length === 0)
+            return;
+        const data = dataLines.join('\n');
+        if (!data || data === ':' || data === 'ping')
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(data);
+        }
+        catch {
+            return; // 非 JSON 心跳行
+        }
+        const ev = this.normalizeStreamEvent(parsed);
+        if (ev)
+            await this.opts.sink(ev);
+    }
+    /** 把 Spine fanout 的事件对象归一化(点号 type + payload)。 */
+    normalizeStreamEvent(raw) {
+        if (!raw || typeof raw !== 'object')
+            return null;
+        const o = raw;
+        const rawType = String(o.event || o.eventType || o.type || o.topic || '');
+        if (!rawType)
+            return null;
+        const type = normalizeEventType(rawType);
+        const payload = o.payload && typeof o.payload === 'object' ? o.payload : o;
+        const orderId = payload.orderId || payload.order_id || o.orderId || undefined;
+        const upstreamId = o.eventId || o.id || payload.eventId;
+        return {
+            type,
+            rawType,
+            orderId,
+            eventId: upstreamId || computeDedupeKey(type, payload),
+            channel: 'spine',
+            payload,
+            receivedAt: Date.now(),
+        };
+    }
+    log(msg) {
+        if (this.opts.log)
+            this.opts.log(`[atel/spine] ${msg}`);
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=channel-spine.js.map

package/dist/events/channel-spine.js.map

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

package/dist/events/dedup.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 幂等去重 —— push + pull 双路、双通道必然送同一事件(见 6.4 §5)。
+ * 用 eventId/dedupeKey 去重;内存 LRU + TTL,容量上限防泄漏。
+ *
+ * 沿用 OpenClaw poll-loop autoActed / listener hookDedup 教训:
+ * Set 满了从头删,带 TTL 过期清理。
+ */
+export declare class Dedup {
+    private readonly ttlMs;
+    private readonly maxSize;
+    private seen;
+    constructor(ttlMs?: number, // 6h
+    maxSize?: number);
+    /** 首见返回 true(应处理);重复返回 false。 */
+    firstSeen(key: string): boolean;
+    has(key: string): boolean;
+    private prune;
+    get size(): number;
+}
+/**
+ * 给没有上游 eventId 的事件算一个稳定 dedupeKey。
+ * 用 (type + orderId + 关键字段) 组合;同一业务事件多次送达 key 一致。
+ */
+export declare function computeDedupeKey(type: string, payload: Record<string, unknown>): string;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/events/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/events/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,KAAK;IAGd,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,IAAI,CAA6B;gBAEtB,KAAK,SAAqB,EAAE,KAAK;IACjC,OAAO,SAAO;IAGjC,iCAAiC;IACjC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAW/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,OAAO,CAAC,KAAK;IAQb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAMvF"}

package/dist/events/dedup.js

@@ -0,0 +1,56 @@
+/**
+ * 幂等去重 —— push + pull 双路、双通道必然送同一事件(见 6.4 §5)。
+ * 用 eventId/dedupeKey 去重;内存 LRU + TTL,容量上限防泄漏。
+ *
+ * 沿用 OpenClaw poll-loop autoActed / listener hookDedup 教训:
+ * Set 满了从头删,带 TTL 过期清理。
+ */
+export class Dedup {
+    ttlMs;
+    maxSize;
+    seen = new Map();
+    constructor(ttlMs = 6 * 60 * 60 * 1000, // 6h
+    maxSize = 5000) {
+        this.ttlMs = ttlMs;
+        this.maxSize = maxSize;
+    }
+    /** 首见返回 true(应处理);重复返回 false。 */
+    firstSeen(key) {
+        this.prune();
+        if (this.seen.has(key))
+            return false;
+        this.seen.set(key, Date.now());
+        if (this.seen.size > this.maxSize) {
+            const oldest = this.seen.keys().next().value;
+            if (oldest !== undefined)
+                this.seen.delete(oldest);
+        }
+        return true;
+    }
+    has(key) {
+        return this.seen.has(key);
+    }
+    prune() {
+        const now = Date.now();
+        for (const [k, ts] of this.seen) {
+            if (now - ts > this.ttlMs)
+                this.seen.delete(k);
+            else
+                break; // Map 保插入序,遇到未过期即可停
+        }
+    }
+    get size() {
+        return this.seen.size;
+    }
+}
+/**
+ * 给没有上游 eventId 的事件算一个稳定 dedupeKey。
+ * 用 (type + orderId + 关键字段) 组合;同一业务事件多次送达 key 一致。
+ */
+export function computeDedupeKey(type, payload) {
+    const orderId = payload.orderId || payload.order_id || '';
+    const idx = payload.index ?? payload.milestoneIndex ?? payload.milestone_index ?? '';
+    const ref = payload.txHash || payload.id || payload.messageId || '';
+    return `${type}|${orderId}|${idx}|${ref}`;
+}
+//# sourceMappingURL=dedup.js.map

package/dist/events/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../src/events/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,KAAK;IAGG;IACA;IAHX,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,YACmB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK;IACjC,UAAU,IAAI;QADd,UAAK,GAAL,KAAK,CAAqB;QAC1B,YAAO,GAAP,OAAO,CAAO;IAC9B,CAAC;IAEJ,iCAAiC;IACjC,SAAS,CAAC,GAAW;QACnB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC7C,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAEO,KAAK;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;;gBAC1C,MAAM,CAAC,oBAAoB;QAClC,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAgC;IAC7E,MAAM,OAAO,GAAI,OAAO,CAAC,OAAkB,IAAK,OAAO,CAAC,QAAmB,IAAI,EAAE,CAAC;IAClF,MAAM,GAAG,GACP,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;IAC3E,MAAM,GAAG,GAAI,OAAO,CAAC,MAAiB,IAAK,OAAO,CAAC,EAAa,IAAK,OAAO,CAAC,SAAoB,IAAI,EAAE,CAAC;IACxG,OAAO,GAAG,IAAI,IAAI,OAAO,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;AAC5C,CAAC"}

package/dist/events/mapping.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 事件 → 角色 → 唤醒动作 映射(6.4 §4 两张表)。
+ *
+ * 设计原则(对齐 feedback_everything_agent / feedback_no_confirm_buttons /
+ * feedback_no_rule_engine_prompts):
+ *   - companion 不替 agent 做业务决策、不做规则引擎绕过。它只负责把"发生了什么 +
+ *     你是什么角色 + 该看哪个单"塞进 prompt,唤醒 agent,由 agent 调工具决定。
+ *   - prompt 给上下文 + 一个明确动作 + "先拉单状态再动",不写死 PASS/REJECT 清单
+ *     (那是 agent + 平台 verifier 的事)。
+ *   - 唯一不经 agent 的是超时/卡死安全网(refundExpired、死信报警),在 autonomy.ts,
+ *     仅当 agent 路径已超期/失败才触发,不是事件→规则绕过。
+ */
+import type { CanonicalEvent, NormalizedEvent } from './types.js';
+import type { OrderRole } from './roles.js';
+export interface WakePlan {
+    orderId?: string;
+    eventType: CanonicalEvent;
+    role: OrderRole;
+    /** 给 agent 的聚焦指令(自然语言 = 意图) */
+    prompt: string;
+    /** 同一订单串行的 key;无 orderId 的用事件本身 */
+    serialKey: string;
+}
+/** 从事件 payload 推断"对本 DID 而言"的角色(角色缓存未命中时的兜底)。 */
+export declare function deriveRole(ev: NormalizedEvent, ourDid: string): OrderRole;
+/**
+ * 从事件类型推断角色 —— 平台按角色定向投递,所以"我收到了什么事件"本身就暗示我的角色
+ * (沿用 OpenClaw role cache 教训:event type + target_did 推断)。
+ * 仅当 payload / 缓存都拿不到角色时用,避免 role=unknown 导致一条事件同时触发雇主+接活方两路。
+ */
+export declare function inferRoleFromEvent(type: CanonicalEvent): OrderRole;
+/**
+ * 把归一化事件 + 已解析角色映射成一个唤醒计划。
+ * 返回 null = 该事件对本角色无需动作(只记账/无关)。
+ */
+export declare function mapEventToAction(ev: NormalizedEvent, role: OrderRole): WakePlan | null;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/events/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/events/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,cAAc,CAAC;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAOzE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,CAelE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAsNtF"}

package/dist/events/mapping.js

@@ -0,0 +1,212 @@
+const TAG = '[ATEL companion]';
+/** 从事件 payload 推断"对本 DID 而言"的角色(角色缓存未命中时的兜底)。 */
+export function deriveRole(ev, ourDid) {
+    const p = ev.payload;
+    const exec = p.executorDid || p.executor_did || p.executor;
+    const req = p.requesterDid || p.requester_did || p.requester;
+    if (exec === ourDid)
+        return 'executor';
+    if (req === ourDid)
+        return 'requester';
+    return 'unknown';
+}
+/**
+ * 从事件类型推断角色 —— 平台按角色定向投递,所以"我收到了什么事件"本身就暗示我的角色
+ * (沿用 OpenClaw role cache 教训:event type + target_did 推断)。
+ * 仅当 payload / 缓存都拿不到角色时用,避免 role=unknown 导致一条事件同时触发雇主+接活方两路。
+ */
+export function inferRoleFromEvent(type) {
+    switch (type) {
+        case 'order.created': // 有人雇我 → 我是接活方
+        case 'milestone.verified': // 我的交付被验收 → 我是接活方
+        case 'milestone.rejected': // 我的交付被驳回 → 我是接活方
+        case 'milestone.plan_confirmed': // 计划已确认,该我交付 → 接活方
+        case 'escrow.confirmed':
+            return 'executor';
+        case 'order.accepted': // 我的单被接受 → 我是雇主
+        case 'milestone.submitted': // 接活方交了,等我验收 → 我是雇主
+        case 'milestone.plan_rejected':
+            return 'requester';
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * 把归一化事件 + 已解析角色映射成一个唤醒计划。
+ * 返回 null = 该事件对本角色无需动作(只记账/无关)。
+ */
+export function mapEventToAction(ev, role) {
+    const orderId = ev.orderId;
+    const oid = orderId ? `订单 ${orderId}` : '该业务';
+    const head = (line) => `${TAG} ${line}`;
+    const readFirst = orderId
+        ? `先调 atel_order_get {"orderId":"${orderId}"} 读当前状态,再决定下一步。`
+        : `先用相关 ATEL 工具读取当前状态,再决定下一步。`;
+    const mk = (prompt) => ({
+        orderId,
+        eventType: ev.type,
+        role,
+        prompt,
+        serialKey: orderId || `${ev.type}:${ev.eventId}`,
+    });
+    switch (ev.type) {
+        // ── 通道甲 A2A ──────────────────────────────────────────────
+        case 'order.created':
+            // 接活方收到:决定是否接单。雇主(自己刚下单)无需被唤醒。
+            if (role === 'requester')
+                return null;
+            return mk([
+                head(`有一单指向你(接活方):${oid} 刚创建。`),
+                `${readFirst} 若你有能力且愿意承接,调 atel_order_accept {"orderId":"${orderId}"}。`,
+                `能否承接由你判断 —— 不合适可以不接。完成后回 NO_REPLY。`,
+            ].join('\n'));
+        case 'order.accepted':
+            // 雇主收到:接活方已接,确认里程碑计划。
+            if (role === 'executor')
+                return null;
+            return mk([
+                head(`接活方已接受 ${oid}(你是雇主)。`),
+                `${readFirst} 若平台要求确认里程碑计划,调 atel_milestone_plan_feedback {"orderId":"${orderId}","approved":true};否则等待首个里程碑提交。`,
+                `完成后回 NO_REPLY。`,
+            ].join('\n'));
+        case 'milestone.review':
+            // 计划评审阶段:雇主确认计划。接活方此时一般等待。
+            if (role === 'executor')
+                return null;
+            return mk([
+                head(`${oid} 进入里程碑计划评审(你是雇主)。`),
+                `${readFirst} 用 atel_milestone_list 看计划;合理则 atel_milestone_plan_feedback {"orderId":"${orderId}","approved":true}。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'milestone.plan_confirmed':
+            // 计划已确认 → 接活方提交首个里程碑。
+            if (role === 'requester')
+                return null;
+            return mk([
+                head(`${oid} 里程碑计划已确认(你是接活方),开始交付。`),
+                `${readFirst} 用 atel_milestone_list 找第一个未提交里程碑,产出贴合其标题与订单描述的真实交付内容,`,
+                `调 atel_milestone_submit 提交。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'milestone.plan_rejected':
+            if (role === 'executor')
+                return null;
+            return mk([
+                head(`${oid} 里程碑计划被打回(你是雇主)。`),
+                `${readFirst} 与接活方对齐后重新评审计划。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'escrow.confirmed':
+            // escrow 锁定确认 → 接活方可推进(若计划已定则提交)。
+            if (role === 'requester')
+                return null;
+            return mk([
+                head(`${oid} 托管已确认(你是接活方)。`),
+                `${readFirst} 若里程碑计划已就绪,提交下一个未交付里程碑;否则等待计划确认。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'milestone.submitted':
+            // 雇主收到:接活方提交了里程碑,需要验收(通过/驳回)。
+            if (role === 'executor')
+                return null;
+            return mk([
+                head(`${oid} 有里程碑被提交(你是雇主),需要你验收。`),
+                `${readFirst} 用 atel_milestone_list 读该里程碑的标题与提交内容,结合订单描述判断是否达标。`,
+                `达标 → atel_milestone_verify;不达标 → atel_milestone_reject 并写明缺什么。由你判断,回 NO_REPLY。`,
+            ].join('\n'));
+        case 'milestone.verified':
+            // 接活方收到:上一里程碑通过,交下一个或收尾。
+            if (role === 'requester')
+                return null;
+            return mk([
+                head(`${oid} 一个里程碑已通过(你是接活方)。`),
+                `${readFirst} 用 atel_milestone_list 找到下一个未提交的里程碑,产出符合其标题与订单描述的真实交付内容,`,
+                `调 atel_milestone_submit 提交。若全部已完成则无需动作。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'milestone.rejected':
+            // 接活方收到:被驳回,修订重交。
+            if (role === 'requester')
+                return null;
+            return mk([
+                head(`${oid} 有里程碑被驳回(你是接活方)。`),
+                `${readFirst} 读驳回理由,针对性修订交付内容,重新 atel_milestone_submit。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'milestone.arbitration_passed':
+            return mk([
+                head(`${oid} 仲裁通过。`),
+                `${readFirst} 按裁决结果继续推进流程(接活方交付 / 雇主验收)。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'milestone.arbitration_failed':
+            return mk([
+                head(`${oid} 仲裁未通过。`),
+                `${readFirst} 按裁决结果收尾(可能退款 / 终止)。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'order.dispute.resolved':
+            return mk([
+                head(`${oid} 争议已裁决。`),
+                `${readFirst} 按裁决结果入账或退款收尾。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'order.settled':
+        case 'order.completed':
+            return mk([
+                head(`${oid} 已结算完成。`),
+                `${readFirst} 确认入账并收尾。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'order.expired':
+            return mk([
+                head(`${oid} 已过期。`),
+                `${readFirst} 确认状态;若有托管未退,触发过期退款。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'order.cancelled':
+            return mk([
+                head(`${oid} 已取消。`),
+                `${readFirst} 确认状态并收尾(如有应退款项,确认已退)。回 NO_REPLY。`,
+            ].join('\n'));
+        // ── 通道乙 A2B / transfer / 消息 ────────────────────────────
+        case 'a2b.order_created':
+        case 'a2b.payment_confirmed':
+        case 'a2b.delivery_completed':
+            return mk([
+                head(`A2B ${oid}:${a2bHint(ev.type)}(你是买家)。`),
+                `${readFirst} 推进购买流程;若交付完成,入账兑换码。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'a2b.delivery_failed':
+        case 'a2b.invoice_failed':
+            return mk([
+                head(`A2B ${oid}:${a2bHint(ev.type)}(你是买家)。`),
+                `${readFirst} 视情况重试或走退款流程。回 NO_REPLY。`,
+            ].join('\n'));
+        case 'transfer.received': {
+            const amt = ev.payload.amount ?? '';
+            const from = ev.payload.fromDid || ev.payload.from || '';
+            return mk([
+                head(`收到转账${amt ? ` ${amt}` : ''}${from ? ` 来自 ${from}` : ''}。`),
+                `如需处理(入账/回执),用 ATEL 工具确认。回 NO_REPLY。`,
+            ].join('\n'));
+        }
+        case 'message.received': {
+            const text = ev.payload.text || ev.payload.message || '';
+            return mk([
+                head(`收到一条 P2P 消息${text ? `:${text.slice(0, 500)}` : ''}。`),
+                `按需用 ATEL 工具处理或回复。回 NO_REPLY。`,
+            ].join('\n'));
+        }
+        default:
+            // 兜底:订单相关但未专门映射/未识别的事件,不要静默卡死 —— 唤醒 agent 读状态推进
+            // (信任 agent;防止平台新增事件名导致 A2A 链路在某一步断掉)。
+            if (orderId) {
+                return mk([
+                    head(`${oid} 有状态更新(${ev.rawType})。`),
+                    `${readFirst} 按你的角色推进当前该做的一步:接活方提交待交付里程碑,雇主验收已提交里程碑或确认计划。无事可做回 NO_REPLY。`,
+                ].join('\n'));
+            }
+            return null;
+    }
+}
+function a2bHint(t) {
+    switch (t) {
+        case 'a2b.order_created': return '订单已创建';
+        case 'a2b.payment_confirmed': return '付款已确认';
+        case 'a2b.delivery_completed': return '交付完成';
+        case 'a2b.delivery_failed': return '交付失败';
+        case 'a2b.invoice_failed': return '开票失败';
+        default: return '状态更新';
+    }
+}
+//# sourceMappingURL=mapping.js.map

package/dist/events/mapping.js.map

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

package/dist/events/roles.d.ts

@@ -0,0 +1,21 @@
+export type OrderRole = 'executor' | 'requester' | 'unknown';
+interface RoleEntry {
+    executorDid?: string;
+    requesterDid?: string;
+    updatedAt: number;
+}
+export declare class OrderRoleCache {
+    private readonly filePath;
+    private cache;
+    constructor(filePath: string);
+    private load;
+    private save;
+    /** 从事件 payload 学习并合并角色信息。 */
+    observe(orderId: string, payload: Record<string, unknown>): void;
+    /** 显式写入(如 atel_order_get 拉回后回填)。 */
+    set(orderId: string, executorDid?: string, requesterDid?: string): void;
+    roleOf(orderId: string, ourDid: string): OrderRole;
+    get(orderId: string): RoleEntry | undefined;
+}
+export {};
+//# sourceMappingURL=roles.d.ts.map

package/dist/events/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/events/roles.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7D,UAAU,SAAS;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,KAAK,CAAiC;gBAEjB,QAAQ,EAAE,MAAM;IAI7C,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,IAAI;IASZ,6BAA6B;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAgBhE,oCAAoC;IACpC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAWvE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS;IAQlD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;CAG5C"}