@atel-ai/runtime-core 0.1.0

package/dist/events/roles.js

@@ -0,0 +1,80 @@
+/**
+ * 订单角色缓存 —— companion 唤醒 agent 前必须知道"我在这单里是雇主还是接活方"
+ * (见 6.4 §7.1:雇主≠接活方,下一步动作完全不同)。
+ *
+ * 角色从事件 payload 推断并落盘缓存(沿用 OpenClaw listener role cache):
+ *   - order.created / order.accepted 的 payload 带 executorDid + requesterDid
+ *   - 之后的 milestone 事件可能只带 orderId,靠缓存查角色
+ * agent 无状态,companion 重启后从缓存 + atel_order_get 续上。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export class OrderRoleCache {
+    filePath;
+    cache = {};
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.load();
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.filePath)) {
+                this.cache = JSON.parse(fs.readFileSync(this.filePath, 'utf8')) || {};
+            }
+        }
+        catch {
+            this.cache = {};
+        }
+    }
+    save() {
+        try {
+            fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
+            fs.writeFileSync(this.filePath, JSON.stringify(this.cache, null, 2));
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    /** 从事件 payload 学习并合并角色信息。 */
+    observe(orderId, payload) {
+        if (!orderId)
+            return;
+        const executorDid = payload.executorDid || payload.executor_did || payload.executor;
+        const requesterDid = payload.requesterDid || payload.requester_did || payload.requester;
+        if (!executorDid && !requesterDid)
+            return;
+        const prev = this.cache[orderId] || { updatedAt: 0 };
+        this.cache[orderId] = {
+            executorDid: executorDid || prev.executorDid,
+            requesterDid: requesterDid || prev.requesterDid,
+            updatedAt: Date.now(),
+        };
+        this.save();
+    }
+    /** 显式写入(如 atel_order_get 拉回后回填)。 */
+    set(orderId, executorDid, requesterDid) {
+        if (!orderId)
+            return;
+        const prev = this.cache[orderId] || { updatedAt: 0 };
+        this.cache[orderId] = {
+            executorDid: executorDid || prev.executorDid,
+            requesterDid: requesterDid || prev.requesterDid,
+            updatedAt: Date.now(),
+        };
+        this.save();
+    }
+    roleOf(orderId, ourDid) {
+        const e = this.cache[orderId];
+        if (!e)
+            return 'unknown';
+        if (e.executorDid === ourDid)
+            return 'executor';
+        if (e.requesterDid === ourDid)
+            return 'requester';
+        return 'unknown';
+    }
+    get(orderId) {
+        return this.cache[orderId];
+    }
+}
+//# sourceMappingURL=roles.js.map

package/dist/events/roles.js.map

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

package/dist/events/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 事件 catalog —— 两条入站通道,事件名已三方核实(源码 + 测试服 DB + 生产 DB,
+ * 见 6.4 核-1)。
+ *
+ * 通道甲 · A2A 领域事件总线(点号命名):走 Spine /events/subscribe + /events/stream。
+ *   生产 event_outbox 真实出现:milestone.submitted / milestone.verified /
+ *   order.settled / order.accepted / order.created / order.cancelled /
+ *   milestone.arbitration_failed / order.dispute.resolved。
+ *   (milestone.arbitration_passed 源码有、生产暂未发生)
+ *
+ * 通道乙 · A2B + transfer + 消息(下划线命名):⚠️ 不进 outbox,Spine 订阅收不到,
+ *   走 relay 长轮询。a2b_order_created / a2b_payment_confirmed /
+ *   a2b_delivery_completed / a2b_delivery_failed / a2b_invoice_failed /
+ *   transfer_received / (P2P 文本消息)。
+ *
+ * 注意:order_created / order_accepted 等下划线名也会经 relay 推送(OpenClaw
+ * poll-loop 实测路径)。normalizeEventType 把点号/下划线统一成一种规范名,
+ * 让映射表对两条通道都成立。
+ */
+/** 规范事件名(内部统一用点号风格)。 */
+export type CanonicalEvent = 'order.created' | 'order.accepted' | 'escrow.confirmed' | 'milestone.review' | 'milestone.plan_confirmed' | 'milestone.plan_rejected' | 'milestone.submitted' | 'milestone.verified' | 'milestone.rejected' | 'milestone.arbitration_passed' | 'milestone.arbitration_failed' | 'order.settled' | 'order.completed' | 'order.cancelled' | 'order.expired' | 'order.dispute.resolved' | 'a2b.order_created' | 'a2b.payment_confirmed' | 'a2b.delivery_completed' | 'a2b.delivery_failed' | 'a2b.invoice_failed' | 'transfer.received' | 'message.received' | 'unknown';
+export type Channel = 'spine' | 'relay';
+/** 归一化后的内部事件。 */
+export interface NormalizedEvent {
+    /** 规范事件名 */
+    type: CanonicalEvent;
+    /** 原始事件名(点号或下划线,原样保留) */
+    rawType: string;
+    /** 订单 id(A2A/A2B 有,transfer/message 可能无) */
+    orderId?: string;
+    /** 用于幂等的稳定 id;优先用上游 eventId,否则由内容算 dedupeKey */
+    eventId: string;
+    /** 入站通道 */
+    channel: Channel;
+    /** 原始 payload */
+    payload: Record<string, unknown>;
+    /** 收到时间 */
+    receivedAt: number;
+}
+/**
+ * 把上游各种形态的事件名归一化到 CanonicalEvent。
+ * 上游可能给:
+ *   - 点号(通道甲 outbox): "milestone.verified"
+ *   - 下划线(通道乙 relay): "milestone_verified" / "a2b_order_created" / "transfer_received"
+ */
+export declare function normalizeEventType(raw: string): CanonicalEvent;
+/** 该规范事件归属哪条通道(用于订阅与诊断,不强制路由)。 */
+export declare function channelOf(type: CanonicalEvent): Channel;
+/** 通道甲订阅的点号 topic(给 /events/subscribe 用)。 */
+export declare const SPINE_TOPICS: string[];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAwB;AACxB,MAAM,MAAM,cAAc,GAEtB,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,0BAA0B,GAC1B,yBAAyB,GACzB,qBAAqB,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,8BAA8B,GAC9B,8BAA8B,GAC9B,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,wBAAwB,GAExB,mBAAmB,GACnB,uBAAuB,GACvB,wBAAwB,GACxB,qBAAqB,GACrB,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAExC,iBAAiB;AACjB,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,IAAI,EAAE,cAAc,CAAC;IACrB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CA2C9D;AAED,kCAAkC;AAClC,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAavD;AAED,6CAA6C;AAC7C,eAAO,MAAM,YAAY,EAAE,MAAM,EAUhC,CAAC"}

package/dist/events/types.js

@@ -0,0 +1,96 @@
+/**
+ * 事件 catalog —— 两条入站通道,事件名已三方核实(源码 + 测试服 DB + 生产 DB,
+ * 见 6.4 核-1)。
+ *
+ * 通道甲 · A2A 领域事件总线(点号命名):走 Spine /events/subscribe + /events/stream。
+ *   生产 event_outbox 真实出现:milestone.submitted / milestone.verified /
+ *   order.settled / order.accepted / order.created / order.cancelled /
+ *   milestone.arbitration_failed / order.dispute.resolved。
+ *   (milestone.arbitration_passed 源码有、生产暂未发生)
+ *
+ * 通道乙 · A2B + transfer + 消息(下划线命名):⚠️ 不进 outbox,Spine 订阅收不到,
+ *   走 relay 长轮询。a2b_order_created / a2b_payment_confirmed /
+ *   a2b_delivery_completed / a2b_delivery_failed / a2b_invoice_failed /
+ *   transfer_received / (P2P 文本消息)。
+ *
+ * 注意:order_created / order_accepted 等下划线名也会经 relay 推送(OpenClaw
+ * poll-loop 实测路径)。normalizeEventType 把点号/下划线统一成一种规范名,
+ * 让映射表对两条通道都成立。
+ */
+/**
+ * 把上游各种形态的事件名归一化到 CanonicalEvent。
+ * 上游可能给:
+ *   - 点号(通道甲 outbox): "milestone.verified"
+ *   - 下划线(通道乙 relay): "milestone_verified" / "a2b_order_created" / "transfer_received"
+ */
+export function normalizeEventType(raw) {
+    if (!raw)
+        return 'unknown';
+    const dotted = raw.replace(/_/g, '.').toLowerCase();
+    // a2b_* → a2b.*
+    if (dotted.startsWith('a2b.')) {
+        const rest = dotted.slice(4);
+        switch (rest) {
+            case 'order.created': return 'a2b.order_created';
+            case 'payment.confirmed': return 'a2b.payment_confirmed';
+            case 'delivery.completed': return 'a2b.delivery_completed';
+            case 'delivery.failed': return 'a2b.delivery_failed';
+            case 'invoice.failed': return 'a2b.invoice_failed';
+            default: return 'unknown';
+        }
+    }
+    switch (dotted) {
+        case 'order.created': return 'order.created';
+        case 'order.accepted': return 'order.accepted';
+        case 'escrow.confirmed': return 'escrow.confirmed';
+        case 'milestone.review': return 'milestone.review';
+        case 'milestone.plan.confirmed': return 'milestone.plan_confirmed';
+        case 'milestone.plan.rejected': return 'milestone.plan_rejected';
+        case 'milestone.submitted': return 'milestone.submitted';
+        case 'milestone.verified': return 'milestone.verified';
+        case 'milestone.rejected':
+        case 'milestone.max.rejected': return 'milestone.rejected';
+        case 'milestone.arbitration.passed': return 'milestone.arbitration_passed';
+        case 'milestone.arbitration.failed': return 'milestone.arbitration_failed';
+        case 'milestone.final': return 'order.settled';
+        case 'order.settled': return 'order.settled';
+        case 'order.completed': return 'order.completed';
+        case 'order.delivered': return 'order.completed';
+        case 'order.cancelled':
+        case 'order.canceled': return 'order.cancelled';
+        case 'order.expired': return 'order.expired';
+        case 'order.dispute.resolved': return 'order.dispute.resolved';
+        case 'transfer.received': return 'transfer.received';
+        case 'message.received':
+        case 'message': return 'message.received';
+        default: return 'unknown';
+    }
+}
+/** 该规范事件归属哪条通道(用于订阅与诊断,不强制路由)。 */
+export function channelOf(type) {
+    switch (type) {
+        case 'a2b.order_created':
+        case 'a2b.payment_confirmed':
+        case 'a2b.delivery_completed':
+        case 'a2b.delivery_failed':
+        case 'a2b.invoice_failed':
+        case 'transfer.received':
+        case 'message.received':
+            return 'relay';
+        default:
+            return 'spine';
+    }
+}
+/** 通道甲订阅的点号 topic(给 /events/subscribe 用)。 */
+export const SPINE_TOPICS = [
+    'order.created',
+    'order.accepted',
+    'milestone.submitted',
+    'milestone.verified',
+    'milestone.arbitration_passed',
+    'milestone.arbitration_failed',
+    'order.settled',
+    'order.cancelled',
+    'order.dispute.resolved',
+];
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

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

package/dist/identity.d.ts

@@ -0,0 +1,48 @@
+export declare class IdentityError extends Error {
+    constructor(message: string);
+}
+export interface KeyPair {
+    publicKey: Uint8Array;
+    secretKey: Uint8Array;
+}
+/** 生成 Ed25519 密钥对。 */
+export declare function generateKeyPair(): KeyPair;
+/** publicKey(32B) → did:atel:ed25519:<base58> */
+export declare function createDID(publicKey: Uint8Array): string;
+/** did:atel:ed25519:<base58> | did:atel:<base58>(legacy) → publicKey(32B) */
+export declare function parseDID(did: string): Uint8Array;
+/**
+ * 确定性 JSON 序列化 —— 递归按 key 排序。
+ * 必须与 atel-platform auth.SerializePayload 字节一致。
+ */
+export declare function serializePayload(obj: unknown): string;
+/** 对 payload 签名,返回 base64 detached 签名。payload 先确定性序列化。 */
+export declare function sign(payload: unknown, secretKey: Uint8Array): string;
+/** 校验 base64 detached 签名。 */
+export declare function verify(payload: unknown, signature: string, publicKey: Uint8Array): boolean;
+/** secretKey 编码: hex / base64 / 普通 base64 → 64B Uint8Array(对齐 OpenClaw identity.json)。 */
+export declare function decodeSecretKey(raw: string): Uint8Array;
+/** Agent 身份:DID + 私钥。companion 持有,用于签 SignedRequest 与换 JWT。 */
+export interface Identity {
+    did: string;
+    publicKey: Uint8Array;
+    secretKey: Uint8Array;
+    agent_id?: string;
+}
+/** 从 identity.json 风格的对象加载(secretKey 为 hex/base64 字符串)。 */
+export declare function loadIdentity(raw: {
+    did?: string;
+    secretKey: string;
+    publicKey?: string;
+    agent_id?: string;
+}): Identity;
+/** 新建身份(用于安装器 onboarding)。 */
+export declare function newIdentity(agent_id?: string): Identity;
+/** 导出为可落盘的 identity.json(secretKey 用 base64)。 */
+export declare function serializeIdentity(id: Identity): {
+    did: string;
+    publicKey: string;
+    secretKey: string;
+    agent_id?: string;
+};
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAcA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;CACvB;AAED,sBAAsB;AACtB,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAKvD;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAehD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAWrD;AAED,0DAA0D;AAC1D,wBAAgB,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,GAAG,MAAM,CAOpE;AAED,6BAA6B;AAC7B,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAS1F;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CASvD;AAED,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,GAAG,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAMtH;AAED,8BAA8B;AAC9B,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAGvD;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAOxH"}

package/dist/identity.js

@@ -0,0 +1,123 @@
+/**
+ * 自带最小签名 (tweetnacl + bs58)。
+ *
+ * 这是内核的"零外部前置"签名层 —— 字节级对齐 atel-platform 的
+ * auth.SerializePayload + Ed25519 detached 签名,以及 atel-sdk
+ * src/identity/index.ts。后续若 atel-sdk 暴露 `@atel-ai/atel-sdk/identity`
+ * 子路径,可走 [protocol-change] 切换复用;在那之前关键路径零跨团队依赖。
+ *
+ * ⚠️ 签名格式必须与服务端一致,否则 /identity/verify 与 relay /poll、/ack
+ * 全部 401。改这里前先跑 identity.test.ts(含 '1'.repeat(32) 固定向量)。
+ */
+import nacl from 'tweetnacl';
+import bs58 from 'bs58';
+export class IdentityError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'IdentityError';
+    }
+}
+/** 生成 Ed25519 密钥对。 */
+export function generateKeyPair() {
+    const kp = nacl.sign.keyPair();
+    return { publicKey: kp.publicKey, secretKey: kp.secretKey };
+}
+/** publicKey(32B) → did:atel:ed25519:<base58> */
+export function createDID(publicKey) {
+    if (publicKey.length !== 32) {
+        throw new IdentityError(`Invalid public key length: expected 32, got ${publicKey.length}`);
+    }
+    return `did:atel:ed25519:${bs58.encode(publicKey)}`;
+}
+/** did:atel:ed25519:<base58> | did:atel:<base58>(legacy) → publicKey(32B) */
+export function parseDID(did) {
+    const parts = did.split(':');
+    let b58;
+    if (parts.length === 4 && parts[0] === 'did' && parts[1] === 'atel' && parts[2] === 'ed25519') {
+        b58 = parts[3];
+    }
+    else if (parts.length === 3 && parts[0] === 'did' && parts[1] === 'atel') {
+        b58 = parts[2];
+    }
+    else {
+        throw new IdentityError(`Invalid DID format: ${did}`);
+    }
+    const decoded = bs58.decode(b58);
+    if (decoded.length !== 32) {
+        throw new IdentityError(`Invalid public key in DID: expected 32 bytes, got ${decoded.length}`);
+    }
+    return decoded;
+}
+/**
+ * 确定性 JSON 序列化 —— 递归按 key 排序。
+ * 必须与 atel-platform auth.SerializePayload 字节一致。
+ */
+export function serializePayload(obj) {
+    return JSON.stringify(obj, (_key, value) => {
+        if (value !== null && typeof value === 'object' && !Array.isArray(value) && !(value instanceof Uint8Array)) {
+            const sorted = {};
+            for (const k of Object.keys(value).sort()) {
+                sorted[k] = value[k];
+            }
+            return sorted;
+        }
+        return value;
+    });
+}
+/** 对 payload 签名,返回 base64 detached 签名。payload 先确定性序列化。 */
+export function sign(payload, secretKey) {
+    if (secretKey.length !== 64) {
+        throw new IdentityError(`Invalid secret key length: expected 64, got ${secretKey.length}`);
+    }
+    const message = typeof payload === 'string' ? payload : serializePayload(payload);
+    const sig = nacl.sign.detached(new TextEncoder().encode(message), secretKey);
+    return Buffer.from(sig).toString('base64');
+}
+/** 校验 base64 detached 签名。 */
+export function verify(payload, signature, publicKey) {
+    if (publicKey.length !== 32)
+        return false;
+    try {
+        const message = typeof payload === 'string' ? payload : serializePayload(payload);
+        const sigBytes = Uint8Array.from(Buffer.from(signature, 'base64'));
+        return nacl.sign.detached.verify(new TextEncoder().encode(message), sigBytes, publicKey);
+    }
+    catch {
+        return false;
+    }
+}
+/** secretKey 编码: hex / base64 / 普通 base64 → 64B Uint8Array(对齐 OpenClaw identity.json)。 */
+export function decodeSecretKey(raw) {
+    if (typeof raw !== 'string')
+        throw new IdentityError('secretKey must be a string');
+    const bytes = /^[0-9a-fA-F]+$/.test(raw) && raw.length % 2 === 0
+        ? Buffer.from(raw, 'hex')
+        : Buffer.from(raw, 'base64');
+    if (bytes.length !== 64) {
+        throw new IdentityError(`decoded secretKey length ${bytes.length}, expected 64`);
+    }
+    return new Uint8Array(bytes);
+}
+/** 从 identity.json 风格的对象加载(secretKey 为 hex/base64 字符串)。 */
+export function loadIdentity(raw) {
+    const secretKey = decodeSecretKey(raw.secretKey);
+    // tweetnacl 的 secretKey 后 32 字节即 publicKey
+    const publicKey = secretKey.slice(32, 64);
+    const did = raw.did || createDID(publicKey);
+    return { did, publicKey, secretKey, agent_id: raw.agent_id };
+}
+/** 新建身份(用于安装器 onboarding)。 */
+export function newIdentity(agent_id) {
+    const kp = generateKeyPair();
+    return { did: createDID(kp.publicKey), publicKey: kp.publicKey, secretKey: kp.secretKey, agent_id };
+}
+/** 导出为可落盘的 identity.json(secretKey 用 base64)。 */
+export function serializeIdentity(id) {
+    return {
+        did: id.did,
+        publicKey: Buffer.from(id.publicKey).toString('base64'),
+        secretKey: Buffer.from(id.secretKey).toString('base64'),
+        ...(id.agent_id ? { agent_id: id.agent_id } : {}),
+    };
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAOD,sBAAsB;AACtB,MAAM,UAAU,eAAe;IAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC;AAC9D,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,SAAS,CAAC,SAAqB;IAC7C,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,aAAa,CAAC,+CAA+C,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,oBAAoB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAW,CAAC;IAChB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9F,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAC3E,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,aAAa,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,aAAa,CAAC,qDAAqD,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACzC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,EAAE,CAAC;YAC3G,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBACrE,MAAM,CAAC,CAAC,CAAC,GAAI,KAAiC,CAAC,CAAC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,IAAI,CAAC,OAAgB,EAAE,SAAqB;IAC1D,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,aAAa,CAAC,+CAA+C,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC;IAC7E,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,MAAM,CAAC,OAAgB,EAAE,SAAiB,EAAE,SAAqB;IAC/E,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,MAAM,IAAI,aAAa,CAAC,4BAA4B,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAC9D,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;QACzB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,aAAa,CAAC,4BAA4B,KAAK,CAAC,MAAM,eAAe,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAUD,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,GAA+E;IAC1G,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjD,2CAA2C;IAC3C,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;AAC/D,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,WAAW,CAAC,QAAiB;IAC3C,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;IAC7B,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;AACtG,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,iBAAiB,CAAC,EAAY;IAC5C,OAAO;QACL,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvD,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvD,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @atel-ai/runtime-core —— ATEL agent companion 内核。
+ *
+ * 公共 80%(做一次共用):两路入站(Spine 订阅 + relay 轮询)+ 无头唤醒(三类驱动)
+ * + 事件→角色→工具映射 + JWT 生命周期 + 失败自治 + 可观测。
+ * 适配器是专属 20% 的薄层。
+ *
+ * 只走 ATEL 公开面(MCP + Spine + relay),不 import platform internal、不连 DB、
+ * 不设 X-Internal-Secret(遵 START-HERE 三纪律)。
+ */
+export * from './identity.js';
+export * from './envelope.js';
+export * from './client.js';
+export * from './config.js';
+export * from './auth.js';
+export * from './events/types.js';
+export * from './events/dedup.js';
+export * from './events/roles.js';
+export * from './events/mapping.js';
+export * from './events/channel-relay.js';
+export * from './events/channel-spine.js';
+export * from './wakers/types.js';
+export * from './wakers/cli.js';
+export * from './wakers/daemon.js';
+export * from './wakers/embedded.js';
+export * from './queue.js';
+export * from './tracker.js';
+export * from './deadletter.js';
+export * from './companion.js';
+export * from './adapters/types.js';
+export * from './adapters/registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAG1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * @atel-ai/runtime-core —— ATEL agent companion 内核。
+ *
+ * 公共 80%(做一次共用):两路入站(Spine 订阅 + relay 轮询)+ 无头唤醒(三类驱动)
+ * + 事件→角色→工具映射 + JWT 生命周期 + 失败自治 + 可观测。
+ * 适配器是专属 20% 的薄层。
+ *
+ * 只走 ATEL 公开面(MCP + Spine + relay),不 import platform internal、不连 DB、
+ * 不设 X-Internal-Secret(遵 START-HERE 三纪律)。
+ */
+// 身份 / 签名(自带最小签名,零外部前置)
+export * from './identity.js';
+export * from './envelope.js';
+// HTTP 客户端(Spine 公开面 + relay)
+export * from './client.js';
+// 配置
+export * from './config.js';
+// 鉴权 / JWT 生命周期
+export * from './auth.js';
+// 事件
+export * from './events/types.js';
+export * from './events/dedup.js';
+export * from './events/roles.js';
+export * from './events/mapping.js';
+export * from './events/channel-relay.js';
+export * from './events/channel-spine.js';
+// 唤醒器
+export * from './wakers/types.js';
+export * from './wakers/cli.js';
+export * from './wakers/daemon.js';
+export * from './wakers/embedded.js';
+// 编排 / 队列 / 自治 / 可观测
+export * from './queue.js';
+export * from './tracker.js';
+export * from './deadletter.js';
+export * from './companion.js';
+// 适配器
+export * from './adapters/types.js';
+export * from './adapters/registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wBAAwB;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,8BAA8B;AAC9B,cAAc,aAAa,CAAC;AAE5B,KAAK;AACL,cAAc,aAAa,CAAC;AAE5B,gBAAgB;AAChB,cAAc,WAAW,CAAC;AAE1B,KAAK;AACL,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAE1C,MAAM;AACN,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAErC,qBAAqB;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,MAAM;AACN,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC"}

package/dist/queue.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 按 key 串行队列 —— 同一订单的多事件串行推进,避免重复提交/竞态(6.5 §6-6);
+ * 不同订单并发(各自一条链)。agent 无状态,串行保证它每次看到的是最新单状态。
+ */
+export declare class SerialQueue {
+    private chains;
+    /** 在 key 这条链上排队执行 task;返回 task 的结果。 */
+    run<T>(key: string, task: () => Promise<T>): Promise<T>;
+    /** 当前活跃链数量(用于诊断)。 */
+    get activeKeys(): number;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAuC;IAErD,uCAAuC;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAevD,qBAAqB;IACrB,IAAI,UAAU,IAAI,MAAM,CAEvB;CACF"}

package/dist/queue.js

@@ -0,0 +1,25 @@
+/**
+ * 按 key 串行队列 —— 同一订单的多事件串行推进,避免重复提交/竞态(6.5 §6-6);
+ * 不同订单并发(各自一条链)。agent 无状态,串行保证它每次看到的是最新单状态。
+ */
+export class SerialQueue {
+    chains = new Map();
+    /** 在 key 这条链上排队执行 task;返回 task 的结果。 */
+    run(key, task) {
+        const prev = this.chains.get(key) ?? Promise.resolve();
+        const result = prev.then(task, task); // 不论前一个成败都接着跑
+        // 维护一条吞掉异常的尾链,供后续任务挂接
+        const tail = result.then(() => undefined, () => undefined);
+        this.chains.set(key, tail);
+        void tail.then(() => {
+            if (this.chains.get(key) === tail)
+                this.chains.delete(key);
+        });
+        return result;
+    }
+    /** 当前活跃链数量(用于诊断)。 */
+    get activeKeys() {
+        return this.chains.size;
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IAErD,uCAAuC;IACvC,GAAG,CAAI,GAAW,EAAE,IAAsB;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,cAAc;QACpD,sBAAsB;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CACtB,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YAClB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qBAAqB;IACrB,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF"}

package/dist/tracker.d.ts

@@ -0,0 +1,27 @@
+import type { CanonicalEvent } from './events/types.js';
+export interface OrderState {
+    orderId: string;
+    firstSeenAt: number;
+    lastEventAt: number;
+    lastEvent: string;
+    rejectCount: number;
+    terminal: boolean;
+    /** 已触发过的自治动作,去重用 */
+    firedActions: string[];
+}
+export declare class OrderTracker {
+    private readonly filePath;
+    private orders;
+    constructor(filePath: string);
+    private load;
+    private save;
+    observe(orderId: string | undefined, type: CanonicalEvent): void;
+    /** 已超过 deadline 且仍非终态、且该动作没触发过的单。 */
+    staleOrders(deadlineMs: number, action: string): OrderState[];
+    /** 驳回达阈值且未触发过 dispute 提示的单。 */
+    rejectThresholdHits(threshold: number, action: string): OrderState[];
+    markFired(orderId: string, action: string): void;
+    get(orderId: string): OrderState | undefined;
+    all(): OrderState[];
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,oBAAoB;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,MAAM,CAAkC;gBAEnB,QAAQ,EAAE,MAAM;IAI7C,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAchE,qCAAqC;IACrC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAO7D,+BAA+B;IAC/B,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAMpE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAShD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI5C,GAAG,IAAI,UAAU,EAAE;CAGpB"}