@atel-ai/runtime-core 0.1.0

package/dist/companion.js

@@ -0,0 +1,224 @@
+/**
+ * Companion 编排器 —— 把两路入站、去重、角色映射、串行队列、唤醒、失败自治、
+ * 可观测串成一台无人值守的机器(6.5 §A / 测试 D)。
+ *
+ * 数据流:
+ *   通道甲 SpineChannel ┐
+ *                        ├─► dedup ─► role 解析 ─► mapEventToAction ─► SerialQueue(按订单) ─► Waker
+ *   通道乙 RelayChannel ┘                                                         │
+ *   autonomy 定时器(超时/驳回) ─────────────────────────────────────────────┘  └─► 失败 → DeadLetterQueue
+ *
+ * push+pull 双路同喂 dedup,重复无害;同一订单串行,避免竞态/重复提交。
+ */
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { AuthManager } from './auth.js';
+import { Dedup } from './events/dedup.js';
+import { OrderRoleCache } from './events/roles.js';
+import { mapEventToAction, deriveRole, inferRoleFromEvent } from './events/mapping.js';
+import { RelayChannel } from './events/channel-relay.js';
+import { SpineChannel } from './events/channel-spine.js';
+import { SerialQueue } from './queue.js';
+import { OrderTracker } from './tracker.js';
+import { DeadLetterQueue } from './deadletter.js';
+const WAKE_MAX_ATTEMPTS = 2; // 一次唤醒失败重试 1 次,再失败进死信
+export class Companion {
+    opts;
+    auth;
+    dedup = new Dedup();
+    roles;
+    tracker;
+    queue = new SerialQueue();
+    dlq;
+    relay;
+    spine;
+    autonomyTimer;
+    stats = {
+        received: 0,
+        deduped: 0,
+        woken: 0,
+        wakeOk: 0,
+        wakeFail: 0,
+        deadLetters: 0,
+        activeOrders: 0,
+    };
+    constructor(opts) {
+        this.opts = opts;
+        const { identity, config } = opts;
+        this.roles = new OrderRoleCache(path.join(config.dataDir, 'order-roles.json'));
+        this.tracker = new OrderTracker(path.join(config.dataDir, 'orders.json'));
+        this.auth = new AuthManager(identity, config.spineBaseUrl, opts.authHooks, config.jwtRefreshLeadMs);
+        this.dlq = new DeadLetterQueue({
+            identity,
+            spineBaseUrl: config.spineBaseUrl,
+            filePath: path.join(config.dataDir, 'dead-letters.jsonl'),
+            log: opts.log,
+        });
+    }
+    async start() {
+        const { identity, config } = this.opts;
+        // 1) 先把 JWT 拿到并落进 MCP 配置(防 401),排自动续期
+        await this.auth.start();
+        // 2) 两路入站,同一 sink
+        const sink = (ev) => this.onEvent(ev);
+        this.relay = new RelayChannel({
+            identity,
+            platformBaseUrl: config.platformBaseUrl,
+            sink,
+            intervalMs: config.relayPollIntervalMs,
+            log: this.opts.log,
+        });
+        this.spine = new SpineChannel({
+            identity,
+            spineBaseUrl: config.spineBaseUrl,
+            sink,
+            deliveryMode: config.spineDeliveryMode,
+            callbackUrl: config.callbackUrl,
+            tokenProvider: () => this.auth.ensureFresh(),
+            log: this.opts.log,
+        });
+        this.relay.start();
+        await this.spine.start();
+        // 3) 失败自治定时器(超时退款兜底 + 驳回转仲裁)
+        this.autonomyTimer = setInterval(() => this.runAutonomy(), 5 * 60 * 1000);
+        if (this.autonomyTimer.unref)
+            this.autonomyTimer.unref();
+        this.log('companion started (relay + spine + autonomy)');
+    }
+    stop() {
+        this.auth.stop();
+        this.relay?.stop();
+        this.spine?.stop();
+        if (this.autonomyTimer)
+            clearInterval(this.autonomyTimer);
+    }
+    /** webhook 模式入口:外部 HTTP 服务把回调事件喂进来。 */
+    async ingestWebhook(raw) {
+        await this.spine.ingestWebhook(raw);
+    }
+    getStats() {
+        return { ...this.stats, activeOrders: this.tracker.all().filter((o) => !o.terminal).length };
+    }
+    // ── 事件处理 ───────────────────────────────────────────────────
+    async onEvent(ev) {
+        this.stats.received++;
+        // 双路 + 双通道去重(eventId 优先,否则内容 dedupeKey)
+        if (!this.dedup.firstSeen(ev.eventId)) {
+            this.stats.deduped++;
+            return;
+        }
+        // 角色学习 + 订单记账
+        if (ev.orderId) {
+            this.roles.observe(ev.orderId, ev.payload);
+            this.tracker.observe(ev.orderId, ev.type);
+        }
+        // 角色解析优先级:角色缓存 → 事件 payload → 事件类型推断(平台按角色定向投递)。
+        let role = ev.orderId ? this.roles.roleOf(ev.orderId, this.opts.identity.did) : 'unknown';
+        if (role === 'unknown')
+            role = deriveRole(ev, this.opts.identity.did);
+        if (role === 'unknown')
+            role = inferRoleFromEvent(ev.type);
+        // 推断出的角色回填缓存,后续同单事件直接命中
+        if (role !== 'unknown' && ev.orderId) {
+            const ourDid = this.opts.identity.did;
+            this.roles.set(ev.orderId, role === 'executor' ? ourDid : undefined, role === 'requester' ? ourDid : undefined);
+        }
+        const plan = mapEventToAction(ev, role);
+        if (!plan) {
+            this.log(`event ${ev.type} order=${ev.orderId || '-'} role=${role} → no action`);
+            return;
+        }
+        // 同一订单串行推进
+        this.queue.run(plan.serialKey, () => this.executePlan(plan, ev));
+    }
+    async executePlan(plan, ev) {
+        this.stats.woken++;
+        // 热会话:同一订单复用同一 sessionId 以 resume(避免冷启)。
+        // 用确定性 UUID(从 serialKey 派生):跨重启稳定,且满足 claude --session-id 的 UUID 格式要求。
+        const sessionId = deterministicUuid(plan.serialKey);
+        let lastErr = '';
+        for (let attempt = 0; attempt < WAKE_MAX_ATTEMPTS; attempt++) {
+            const res = await this.opts.waker.wake({ prompt: plan.prompt, sessionId });
+            if (res.ok) {
+                this.stats.wakeOk++;
+                this.log(`woke ${plan.eventType} order=${plan.orderId || '-'} role=${plan.role} ok dur=${res.durationMs}ms`);
+                return;
+            }
+            lastErr = res.error || 'unknown';
+            this.log(`wake failed ${plan.eventType} order=${plan.orderId || '-'} attempt=${attempt + 1}: ${lastErr.slice(0, 160)}`);
+            if (attempt < WAKE_MAX_ATTEMPTS - 1)
+                await sleep(15_000);
+        }
+        // 反复失败 → 死信 + 报警给主人
+        this.stats.wakeFail++;
+        this.stats.deadLetters++;
+        await this.dlq.record({
+            orderId: plan.orderId,
+            eventType: plan.eventType,
+            reason: 'wake_failed',
+            detail: lastErr,
+            attempts: WAKE_MAX_ATTEMPTS,
+        });
+    }
+    // ── 失败自治 ───────────────────────────────────────────────────
+    runAutonomy() {
+        // 超时:escrow 到 deadline 仍非终态 → 唤醒 agent 处理过期(退款兜底)。
+        // 走 agent(SKILL.md 教它调对应工具),不在 companion 里硬编码合约/端点
+        // (遵 feedback_everything_agent;refundExpired 任何人可触发但动作仍由 agent 调)。
+        for (const o of this.tracker.staleOrders(this.opts.config.escrowDeadlineMs, 'expire_refund')) {
+            this.tracker.markFired(o.orderId, 'expire_refund');
+            const prompt = `[ATEL companion · 自治] 订单 ${o.orderId} 已超过 escrow deadline 仍未结算。` +
+                `先调 atel_order_get {"orderId":"${o.orderId}"} 确认状态;若确已过期,调用对应的过期退款工具触发退款。回 NO_REPLY。`;
+            this.queue.run(o.orderId, () => this.opts.waker.wake({ prompt, sessionId: deterministicUuid(o.orderId) }).then((r) => {
+                if (!r.ok) {
+                    this.stats.deadLetters++;
+                    return this.dlq.record({
+                        orderId: o.orderId,
+                        eventType: 'autonomy.expire',
+                        reason: 'expire_wake_failed',
+                        detail: r.error,
+                        attempts: 1,
+                    });
+                }
+            }));
+        }
+        // 驳回 ≥ threshold → 唤醒 agent 转 dispute。
+        for (const o of this.tracker.rejectThresholdHits(this.opts.config.disputeRejectThreshold, 'escalate_dispute')) {
+            this.tracker.markFired(o.orderId, 'escalate_dispute');
+            const prompt = `[ATEL companion · 自治] 订单 ${o.orderId} 里程碑已被驳回 ${o.rejectCount} 次(达阈值)。` +
+                `先调 atel_order_get {"orderId":"${o.orderId}"} 确认;若僵持,调 atel_dispute_create 发起仲裁。回 NO_REPLY。`;
+            this.queue.run(o.orderId, () => this.opts.waker.wake({ prompt, sessionId: deterministicUuid(o.orderId) }).then((r) => {
+                if (!r.ok) {
+                    this.stats.deadLetters++;
+                    return this.dlq.record({
+                        orderId: o.orderId,
+                        eventType: 'autonomy.dispute',
+                        reason: 'dispute_wake_failed',
+                        detail: r.error,
+                        attempts: 1,
+                    });
+                }
+            }));
+        }
+    }
+    log(msg) {
+        if (this.opts.log)
+            this.opts.log(`[atel/companion] ${msg}`);
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/** 从任意字符串派生确定性 UUID v4 形态(跨重启稳定,满足 claude --session-id)。 */
+function deterministicUuid(key) {
+    const h = createHash('sha1').update(`atel:${key}`).digest('hex');
+    // 拼成 8-4-4-4-12,并把 version/variant 位钉成 4/8(格式合法即可)
+    return [
+        h.slice(0, 8),
+        h.slice(8, 12),
+        '4' + h.slice(13, 16),
+        '8' + h.slice(17, 20),
+        h.slice(20, 32),
+    ].join('-');
+}
+//# sourceMappingURL=companion.js.map

package/dist/companion.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,35 @@
+export interface RuntimeConfig {
+    /** 适配器 id:openclaw | claude-code | codex | hermes | qwen-agent | gemini-cli | <custom> */
+    runtime: string;
+    /** identity.json 路径(含 did + secretKey) */
+    identityPath: string;
+    /** Spine 公开面基址(通道甲 + JWT 换取) */
+    spineBaseUrl: string;
+    /** platform 基址(通道乙 relay 长轮询 /relay/v1/poll、/ack) */
+    platformBaseUrl: string;
+    /** agent 连的 MCP server URL(写进该 runtime 的 MCP 配置) */
+    mcpUrl: string;
+    /** 内核数据目录(角色缓存、死信、session 映射) */
+    dataDir: string;
+    /** 通道甲投递模式:sse | webhook */
+    spineDeliveryMode: 'sse' | 'webhook';
+    /** webhook 模式下 companion 暴露的回调 URL(deliveryMode=webhook 必填) */
+    callbackUrl?: string;
+    /** relay 长轮询间隔(ms) */
+    relayPollIntervalMs: number;
+    /** JWT 到期前多久重签(ms) */
+    jwtRefreshLeadMs: number;
+    /** A2A escrow 默认 deadline(ms),用于超时退款兜底判断 */
+    escrowDeadlineMs: number;
+    /** 驳回多少次转 dispute(平台 threshold=3) */
+    disputeRejectThreshold: number;
+}
+export declare const PROD_DEFAULTS: {
+    spineBaseUrl: string;
+    platformBaseUrl: string;
+    mcpUrl: string;
+};
+export declare function defaultConfig(partial: Partial<RuntimeConfig> & {
+    runtime: string;
+}): RuntimeConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,iBAAiB,EAAE,KAAK,GAAG,SAAS,CAAC;IACrC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,aAAa;;;;CAIzB,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAgBlG"}

package/dist/config.js

@@ -0,0 +1,29 @@
+/**
+ * 内核运行配置。安装器写出、companion 读入。
+ * 端点默认值取自 6.4 / 5.19 prod 实测路径。
+ */
+import os from 'node:os';
+import path from 'node:path';
+export const PROD_DEFAULTS = {
+    spineBaseUrl: 'https://api.atelai.xyz/spine/v1',
+    platformBaseUrl: 'https://api.atelai.xyz',
+    mcpUrl: 'https://atelai.xyz/mcp',
+};
+export function defaultConfig(partial) {
+    const dataDir = partial.dataDir || path.join(os.homedir(), '.atel');
+    return {
+        runtime: partial.runtime,
+        identityPath: partial.identityPath || path.join(dataDir, 'identity.json'),
+        spineBaseUrl: partial.spineBaseUrl || PROD_DEFAULTS.spineBaseUrl,
+        platformBaseUrl: partial.platformBaseUrl || PROD_DEFAULTS.platformBaseUrl,
+        mcpUrl: partial.mcpUrl || PROD_DEFAULTS.mcpUrl,
+        dataDir,
+        spineDeliveryMode: partial.spineDeliveryMode || 'sse',
+        callbackUrl: partial.callbackUrl,
+        relayPollIntervalMs: partial.relayPollIntervalMs ?? 30_000,
+        jwtRefreshLeadMs: partial.jwtRefreshLeadMs ?? 60 * 60 * 1000, // 1h before expiry
+        escrowDeadlineMs: partial.escrowDeadlineMs ?? 7 * 24 * 60 * 60 * 1000, // 7d
+        disputeRejectThreshold: partial.disputeRejectThreshold ?? 3,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AA6B7B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,YAAY,EAAE,iCAAiC;IAC/C,eAAe,EAAE,wBAAwB;IACzC,MAAM,EAAE,wBAAwB;CACjC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,OAAqD;IACjF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACpE,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC;QACzE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,aAAa,CAAC,YAAY;QAChE,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,aAAa,CAAC,eAAe;QACzE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM;QAC9C,OAAO;QACP,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,KAAK;QACrD,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,MAAM;QAC1D,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,mBAAmB;QACjF,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK;QAC5E,sBAAsB,EAAE,OAAO,CAAC,sBAAsB,IAAI,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/deadletter.d.ts

@@ -0,0 +1,31 @@
+import type { Identity } from './identity.js';
+export interface DeadLetter {
+    at: string;
+    orderId?: string;
+    eventType: string;
+    reason: string;
+    detail?: string;
+    attempts: number;
+}
+export interface DeadLetterOpts {
+    identity: Identity;
+    spineBaseUrl: string;
+    filePath: string;
+    /** 报警接收方 DID;默认 = agent 自己(经 relay 浮给主人) */
+    alertDid?: string;
+    /** 同一 (orderId+reason) 报警去抖窗口,避免刷屏 */
+    alertDebounceMs?: number;
+    log?: (msg: string) => void;
+}
+export declare class DeadLetterQueue {
+    private readonly opts;
+    private lastAlert;
+    private readonly debounceMs;
+    constructor(opts: DeadLetterOpts);
+    /** 记一条死信并尝试报警。 */
+    record(dl: Omit<DeadLetter, 'at'>): Promise<void>;
+    private persist;
+    private alert;
+    private log;
+}
+//# sourceMappingURL=deadletter.d.ts.map

package/dist/deadletter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadletter.d.ts","sourceRoot":"","sources":["../src/deadletter.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAEP,IAAI,EAAE,cAAc;IAIjD,kBAAkB;IACZ,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD,OAAO,CAAC,OAAO;YASD,KAAK;IA0BnB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/deadletter.js

@@ -0,0 +1,67 @@
+/**
+ * 死信队列 + 报警(可观测,6.5 §6-4)。
+ *
+ * 无人值守 + 真金,卡住不能静默烂掉。当:agent 不响应 / LLM 挂 / 工具反复报错 /
+ * 单超期无人推时 —— 把卡住的单 + 原因落盘成死信,并通过 relay/notify 推给 agent 主人
+ * (notify 到 agent 自己的 DID → 经 relay 浮到主人的原生渠道,沿用 OpenClaw notifyAgent 机制)。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { spineRelayNotify } from './client.js';
+export class DeadLetterQueue {
+    opts;
+    lastAlert = new Map();
+    debounceMs;
+    constructor(opts) {
+        this.opts = opts;
+        this.debounceMs = opts.alertDebounceMs ?? 10 * 60 * 1000;
+    }
+    /** 记一条死信并尝试报警。 */
+    async record(dl) {
+        const entry = { ...dl, at: new Date().toISOString() };
+        this.persist(entry);
+        this.log(`DEAD-LETTER order=${dl.orderId || '-'} reason=${dl.reason} attempts=${dl.attempts}`);
+        await this.alert(entry);
+    }
+    persist(entry) {
+        try {
+            fs.mkdirSync(path.dirname(this.opts.filePath), { recursive: true });
+            fs.appendFileSync(this.opts.filePath, JSON.stringify(entry) + '\n');
+        }
+        catch (e) {
+            this.log(`persist failed: ${e.message}`);
+        }
+    }
+    async alert(entry) {
+        const key = `${entry.orderId || '-'}|${entry.reason}`;
+        const now = Date.now();
+        const last = this.lastAlert.get(key) || 0;
+        if (now - last < this.debounceMs)
+            return; // 去抖
+        this.lastAlert.set(key, now);
+        const toDid = this.opts.alertDid || this.opts.identity.did;
+        try {
+            const r = await spineRelayNotify(this.opts.spineBaseUrl, this.opts.identity, toDid, {
+                kind: 'atel_companion_alert',
+                text: `⚠️ ATEL companion 卡住告警\n` +
+                    `订单: ${entry.orderId || '(无)'}\n` +
+                    `事件: ${entry.eventType}\n` +
+                    `原因: ${entry.reason}\n` +
+                    `详情: ${(entry.detail || '').slice(0, 300)}\n` +
+                    `重试次数: ${entry.attempts}\n` +
+                    `时间: ${entry.at}`,
+                deadLetter: entry,
+            });
+            if (!r.ok)
+                this.log(`alert relay/notify HTTP ${r.status}: ${r.body.slice(0, 160)}`);
+        }
+        catch (e) {
+            this.log(`alert failed: ${e.message}`);
+        }
+    }
+    log(msg) {
+        if (this.opts.log)
+            this.opts.log(`[atel/deadletter] ${msg}`);
+    }
+}
+//# sourceMappingURL=deadletter.js.map

package/dist/deadletter.js.map

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

package/dist/envelope.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SignedRequest 信封 —— Spine / platform relay 的 DID-Sig 鉴权格式。
+ *
+ * 字节级对齐 atel-platform relayTokenMiddleware / DIDAuth 与
+ * OpenClaw poll-loop.js signEnvelope:
+ *   signable = serializePayload({ payload, did, timestamp })
+ *   envelope = { did, payload, timestamp, signature }
+ *
+ * 时间戳偏移会被服务端拒(见 project_sdk_relay_ack_signing 教训:/ack 漏签 → 401
+ * 循环)。所有出站请求都用 signEnvelope,不要手拼。
+ */
+import { type Identity } from './identity.js';
+export interface SignedRequest<T = unknown> {
+    did: string;
+    payload: T;
+    timestamp: string;
+    signature: string;
+}
+/** 用 identity 私钥签出一个 SignedRequest 信封。 */
+export declare function signEnvelope<T>(identity: Identity, payload: T): SignedRequest<T>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAKhF"}

package/dist/envelope.js

@@ -0,0 +1,20 @@
+/**
+ * SignedRequest 信封 —— Spine / platform relay 的 DID-Sig 鉴权格式。
+ *
+ * 字节级对齐 atel-platform relayTokenMiddleware / DIDAuth 与
+ * OpenClaw poll-loop.js signEnvelope:
+ *   signable = serializePayload({ payload, did, timestamp })
+ *   envelope = { did, payload, timestamp, signature }
+ *
+ * 时间戳偏移会被服务端拒(见 project_sdk_relay_ack_signing 教训:/ack 漏签 → 401
+ * 循环)。所有出站请求都用 signEnvelope,不要手拼。
+ */
+import { serializePayload, sign } from './identity.js';
+/** 用 identity 私钥签出一个 SignedRequest 信封。 */
+export function signEnvelope(identity, payload) {
+    const timestamp = new Date().toISOString();
+    const signable = serializePayload({ payload, did: identity.did, timestamp });
+    const signature = sign(signable, identity.secretKey);
+    return { did: identity.did, payload, timestamp, signature };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAiB,MAAM,eAAe,CAAC;AAStE,0CAA0C;AAC1C,MAAM,UAAU,YAAY,CAAI,QAAkB,EAAE,OAAU;IAC5D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACrD,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAC9D,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * 通道乙 —— platform relay 长轮询(/relay/v1/poll → 处理 → /ack)。
+ *
+ * 这是已被 OpenClaw 生产验证的路径,实测同时承载:
+ *   - 通道乙本职:a2b_* / transfer_received / P2P 消息(下划线,Spine 订阅收不到)
+ *   - 也会收到 order_created / milestone_* 等 A2A 下划线通知
+ * 所以 relay 轮询是"全量兜底";Spine 订阅(通道甲)是低延迟 push,两者同喂 dedup。
+ *
+ * 移植自 atel-mcp/openclaw-plugin poll-loop.js,标准化进内核。
+ */
+import type { Identity } from '../identity.js';
+import { type NormalizedEvent } from './types.js';
+export type EventSink = (ev: NormalizedEvent) => void | Promise<void>;
+export interface RelayChannelOpts {
+    identity: Identity;
+    platformBaseUrl: string;
+    sink: EventSink;
+    intervalMs?: number;
+    log?: (msg: string) => void;
+}
+export declare class RelayChannel {
+    private readonly opts;
+    private timer?;
+    private inFlight;
+    private readonly intervalMs;
+    constructor(opts: RelayChannelOpts);
+    start(): void;
+    stop(): void;
+    private tick;
+    private drainOnce;
+    /** 把 relay 消息归一化成 NormalizedEvent。 */
+    private normalize;
+    private log;
+}
+//# sourceMappingURL=channel-relay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-relay.d.ts","sourceRoot":"","sources":["../../src/events/channel-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAGtE,MAAM,MAAM,SAAS,GAAG,CAAC,EAAE,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,KAAK,CAAC,CAAiC;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAEP,IAAI,EAAE,gBAAgB;IAInD,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;YAKE,IAAI;YAaJ,SAAS;IAuBvB,sCAAsC;IACtC,OAAO,CAAC,SAAS;IA2BjB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/events/channel-relay.js

@@ -0,0 +1,97 @@
+import { relayPoll, relayAck } from '../client.js';
+import { normalizeEventType } from './types.js';
+import { computeDedupeKey } from './dedup.js';
+export class RelayChannel {
+    opts;
+    timer;
+    inFlight = false;
+    intervalMs;
+    constructor(opts) {
+        this.opts = opts;
+        this.intervalMs = opts.intervalMs ?? 30_000;
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.tick(); // 立即拉一次,首消息延迟不被首个 interval 卡住
+        this.timer = setInterval(() => this.tick(), this.intervalMs);
+        if (this.timer.unref)
+            this.timer.unref();
+        this.log(`relay channel started (interval ${this.intervalMs}ms)`);
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+    }
+    async tick() {
+        if (this.inFlight)
+            return; // 防重叠(慢平台时下一 tick 抢跑)
+        this.inFlight = true;
+        try {
+            const n = await this.drainOnce();
+            if (n > 0)
+                this.log(`drained ${n} relay messages`);
+        }
+        catch (e) {
+            this.log(`tick failed: ${e.message}`);
+        }
+        finally {
+            this.inFlight = false;
+        }
+    }
+    async drainOnce() {
+        const messages = await relayPoll(this.opts.platformBaseUrl, this.opts.identity);
+        if (messages.length === 0)
+            return 0;
+        const ackIds = [];
+        for (const m of messages) {
+            try {
+                const ev = this.normalize(m);
+                if (ev)
+                    await this.opts.sink(ev);
+                ackIds.push(m.id);
+            }
+            catch (e) {
+                this.log(`dispatch failed id=${m.id}: ${e.message}`);
+            }
+        }
+        if (ackIds.length > 0) {
+            // ack 必须签名,否则 401 循环(见 project_sdk_relay_ack_signing)
+            const r = await relayAck(this.opts.platformBaseUrl, this.opts.identity, ackIds);
+            if (!r.ok)
+                this.log(`ack HTTP ${r.status}: ${r.body.slice(0, 160)}`);
+        }
+        return messages.length;
+    }
+    /** 把 relay 消息归一化成 NormalizedEvent。 */
+    normalize(m) {
+        // platform 把 relay payload 包成 {body, path, method};真正内容在 body
+        const inner = m.message?.body && typeof m.message.body === 'object'
+            ? m.message.body
+            : m.message;
+        const rawType = String(inner?.event || inner?.eventType || '');
+        if (!rawType)
+            return null;
+        const type = normalizeEventType(rawType);
+        const payload = inner.payload && typeof inner.payload === 'object'
+            ? inner.payload
+            : inner;
+        const orderId = payload.orderId || payload.order_id || inner.orderId || undefined;
+        const upstreamId = inner.eventId || payload.eventId;
+        return {
+            type,
+            rawType,
+            orderId,
+            eventId: upstreamId || computeDedupeKey(type, payload),
+            channel: 'relay',
+            payload,
+            receivedAt: Date.now(),
+        };
+    }
+    log(msg) {
+        if (this.opts.log)
+            this.opts.log(`[atel/relay] ${msg}`);
+    }
+}
+//# sourceMappingURL=channel-relay.js.map

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

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