@atel-ai/runtime-core 0.1.0

package/dist/tracker.js

@@ -0,0 +1,80 @@
+/**
+ * 订单跟踪器 —— 失败自治的状态底座(6.5 §6 / 测试 D-4)。
+ *
+ * agent 无状态,但 companion 要做超时退款 / 驳回转仲裁这类兜底,需要轻量记账:
+ *   - 每单首见时间(判 escrow deadline 超时)
+ *   - 当前是否终态(settled/cancelled/dispute.resolved → 不再兜底)
+ *   - 累计驳回次数(达 threshold → 提示转 dispute)
+ *   - 已触发过的自治动作(只触发一次)
+ * 这是续跑的依据:companion 重启后从这里 + atel_order_get 续上,不丢单。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+const TERMINAL = ['order.settled', 'order.cancelled', 'order.dispute.resolved'];
+export class OrderTracker {
+    filePath;
+    orders = {};
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.load();
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.filePath)) {
+                this.orders = JSON.parse(fs.readFileSync(this.filePath, 'utf8')) || {};
+            }
+        }
+        catch {
+            this.orders = {};
+        }
+    }
+    save() {
+        try {
+            fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
+            fs.writeFileSync(this.filePath, JSON.stringify(this.orders, null, 2));
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    observe(orderId, type) {
+        if (!orderId)
+            return;
+        const now = Date.now();
+        const prev = this.orders[orderId] ||
+            { orderId, firstSeenAt: now, lastEventAt: now, lastEvent: type, rejectCount: 0, terminal: false, firedActions: [] };
+        prev.lastEventAt = now;
+        prev.lastEvent = type;
+        if (type === 'milestone.rejected')
+            prev.rejectCount += 1;
+        if (TERMINAL.includes(type))
+            prev.terminal = true;
+        this.orders[orderId] = prev;
+        this.save();
+    }
+    /** 已超过 deadline 且仍非终态、且该动作没触发过的单。 */
+    staleOrders(deadlineMs, action) {
+        const now = Date.now();
+        return Object.values(this.orders).filter((o) => !o.terminal && now - o.firstSeenAt > deadlineMs && !o.firedActions.includes(action));
+    }
+    /** 驳回达阈值且未触发过 dispute 提示的单。 */
+    rejectThresholdHits(threshold, action) {
+        return Object.values(this.orders).filter((o) => !o.terminal && o.rejectCount >= threshold && !o.firedActions.includes(action));
+    }
+    markFired(orderId, action) {
+        const o = this.orders[orderId];
+        if (!o)
+            return;
+        if (!o.firedActions.includes(action)) {
+            o.firedActions.push(action);
+            this.save();
+        }
+    }
+    get(orderId) {
+        return this.orders[orderId];
+    }
+    all() {
+        return Object.values(this.orders);
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

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

package/dist/wakers/cli.d.ts

@@ -0,0 +1,36 @@
+import type { Waker, WakeRequest, WakeResult } from './types.js';
+export interface CliWakerSpec {
+    /** 可执行文件(绝对路径或 PATH 中可解析名) */
+    bin: string;
+    /**
+     * 构造 argv。isResume=true 表示该 sessionId 之前已起过,适配器可换成 --resume/--continue。
+     * 返回不含 bin 的参数数组。
+     */
+    buildArgs: (ctx: {
+        prompt: string;
+        sessionId: string;
+        isResume: boolean;
+    }) => string[];
+    /** 额外 env。给函数则每次唤醒前求值(JWT 续期后能拿到最新值)。 */
+    env?: Record<string, string> | (() => Record<string, string>);
+    cwd?: string;
+    /** 默认单次超时(冷启首次可能慢,Hermes 实测首跑 220s,给足) */
+    defaultTimeoutMs?: number;
+    maxBuffer?: number;
+    /** started 会话集落盘路径(跨重启续跑必需;不给则只在内存,重启后失忆) */
+    sessionStatePath?: string;
+    log?: (msg: string) => void;
+}
+export declare class CliWaker implements Waker {
+    private readonly spec;
+    readonly kind: "cli";
+    private started;
+    constructor(spec: CliWakerSpec);
+    wake(req: WakeRequest): Promise<WakeResult>;
+    private attempt;
+    private markStarted;
+    private loadStarted;
+    private saveStarted;
+    private log;
+}
+//# sourceMappingURL=cli.d.ts.map

package/dist/wakers/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/wakers/cli.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,SAAS,EAAE,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,EAAE,CAAC;IACvF,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAOD,qBAAa,QAAS,YAAW,KAAK;IAIxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,OAAO,CAAC,OAAO,CAAqB;gBAEP,IAAI,EAAE,YAAY;IAIzC,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAQjD,OAAO,CAAC,OAAO;IAsDf,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/wakers/cli.js

@@ -0,0 +1,116 @@
+/**
+ * ① CLI 无头唤醒器 —— spawn/resume 一条命令。
+ *
+ * 各家 CLI 的具体 flag 由适配器的 buildArgs 给(argv 数组,绝不拼 shell 字符串,
+ * 见 feedback_codex_audit)。本驱动负责:进程拉起、超时、session lock 退避重试、
+ * 热会话 resume 状态跟踪(跨重启持久化)。
+ *
+ * 热会话坑(真机实测):claude `-p --session-id <已存在的 id>` 会**挂住**(不是报错),
+ * 已存在会话必须用 `--resume`。所以 started 集合要落盘——companion 重启后才知道该
+ * resume 而不是重新 --session-id 把自己挂死(D-3 续跑)。再加自适应回退:resume
+ * 报"无此会话"→退回 create;create 报"已存在"→退回 resume。
+ */
+import { execFile } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+const LOCK_RE = /session.*lock|file lock|already running|EBUSY|locked/i;
+const NO_SESSION_RE = /no conversation|session not found|no session|conversation not found|unknown session/i;
+const EXISTS_RE = /already exists|session.*in use|duplicate session/i;
+const LOCK_RETRY_MAX = 3;
+export class CliWaker {
+    spec;
+    kind = 'cli';
+    started = new Set();
+    constructor(spec) {
+        this.spec = spec;
+        this.loadStarted();
+    }
+    async wake(req) {
+        const sessionId = req.sessionId || randomUUID();
+        const timeoutMs = req.timeoutMs ?? this.spec.defaultTimeoutMs ?? 300_000;
+        const result = await this.attempt(sessionId, req.prompt, timeoutMs, 0, this.started.has(sessionId));
+        if (result.ok)
+            this.markStarted(sessionId);
+        return result;
+    }
+    attempt(sessionId, prompt, timeoutMs, lockAttempt, isResume) {
+        const args = this.spec.buildArgs({ prompt, sessionId, isResume });
+        const extraEnv = typeof this.spec.env === 'function' ? this.spec.env() : this.spec.env || {};
+        const t0 = Date.now();
+        return new Promise((resolve) => {
+            execFile(this.spec.bin, args, {
+                timeout: timeoutMs,
+                maxBuffer: this.spec.maxBuffer ?? 10 * 1024 * 1024,
+                env: { ...process.env, ...extraEnv },
+                cwd: this.spec.cwd,
+            }, (err, stdout, stderr) => {
+                const durationMs = Date.now() - t0;
+                const out = (stdout || '').toString();
+                const errText = ((err && err.message) || '') + ' ' + (stderr || '');
+                if (err && LOCK_RE.test(errText) && lockAttempt < LOCK_RETRY_MAX) {
+                    const delay = 1500 + lockAttempt * 1500;
+                    this.log(`session locked, retry ${lockAttempt + 1}/${LOCK_RETRY_MAX} in ${delay}ms`);
+                    setTimeout(() => {
+                        this.attempt(sessionId, prompt, timeoutMs, lockAttempt + 1, isResume).then(resolve);
+                    }, delay);
+                    return;
+                }
+                // 自适应回退:create/resume 选错一次 → 翻面重试一次
+                if (err && !isResume && EXISTS_RE.test(errText)) {
+                    this.log(`create hit existing session, retry as resume`);
+                    this.markStarted(sessionId);
+                    this.attempt(sessionId, prompt, timeoutMs, lockAttempt, true).then(resolve);
+                    return;
+                }
+                if (err && isResume && NO_SESSION_RE.test(errText)) {
+                    this.log(`resume found no session, retry as create`);
+                    this.attempt(sessionId, prompt, timeoutMs, lockAttempt, false).then(resolve);
+                    return;
+                }
+                if (err) {
+                    resolve({ ok: false, output: out, error: errText.slice(0, 500).trim(), durationMs, sessionId });
+                }
+                else {
+                    resolve({ ok: true, output: out, durationMs, sessionId });
+                }
+            });
+        });
+    }
+    markStarted(sessionId) {
+        if (this.started.has(sessionId))
+            return;
+        this.started.add(sessionId);
+        this.saveStarted();
+    }
+    loadStarted() {
+        if (!this.spec.sessionStatePath)
+            return;
+        try {
+            const arr = JSON.parse(fs.readFileSync(this.spec.sessionStatePath, 'utf8'));
+            if (Array.isArray(arr))
+                this.started = new Set(arr);
+        }
+        catch {
+            /* 首次无文件 */
+        }
+    }
+    saveStarted() {
+        if (!this.spec.sessionStatePath)
+            return;
+        try {
+            fs.mkdirSync(path.dirname(this.spec.sessionStatePath), { recursive: true });
+            // 上限保护:只留最近 2000 个
+            const arr = [...this.started].slice(-2000);
+            fs.writeFileSync(this.spec.sessionStatePath, JSON.stringify(arr));
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    log(msg) {
+        if (this.spec.log)
+            this.spec.log(`[atel/waker:cli] ${msg}`);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/wakers/cli.js.map

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

package/dist/wakers/daemon.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ② 常驻 daemon / 本地 API 唤醒器 —— POST 它的本地接口。
+ * 用于 OpenClaw listener、Eliza Sessions API、Witsy webhook 等同类。
+ */
+import type { Waker, WakeRequest, WakeResult } from './types.js';
+export interface DaemonWakerSpec {
+    /** 本地接口 URL,如 http://127.0.0.1:PORT/agent */
+    url: string;
+    /** 构造请求 body */
+    buildBody: (ctx: {
+        prompt: string;
+        sessionId: string;
+    }) => unknown;
+    headers?: Record<string, string>;
+    /** 从响应里提取输出文本 */
+    extractOutput?: (json: unknown, text: string) => string;
+    defaultTimeoutMs?: number;
+    log?: (msg: string) => void;
+}
+export declare class DaemonWaker implements Waker {
+    private readonly spec;
+    readonly kind: "daemon";
+    constructor(spec: DaemonWakerSpec);
+    wake(req: WakeRequest): Promise<WakeResult>;
+}
+//# sourceMappingURL=daemon.d.ts.map

package/dist/wakers/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/wakers/daemon.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,SAAS,EAAE,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iBAAiB;IACjB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,qBAAa,WAAY,YAAW,KAAK;IAG3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;gBAEL,IAAI,EAAE,eAAe;IAE5C,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAiClD"}

package/dist/wakers/daemon.js

@@ -0,0 +1,51 @@
+export class DaemonWaker {
+    spec;
+    kind = 'daemon';
+    constructor(spec) {
+        this.spec = spec;
+    }
+    async wake(req) {
+        const sessionId = req.sessionId || `daemon-${Date.now()}`;
+        const timeoutMs = req.timeoutMs ?? this.spec.defaultTimeoutMs ?? 300_000;
+        const t0 = Date.now();
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+        try {
+            const res = await fetch(this.spec.url, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json', ...(this.spec.headers || {}) },
+                body: JSON.stringify(this.spec.buildBody({ prompt: req.prompt, sessionId })),
+                signal: ctrl.signal,
+            });
+            const text = await res.text().catch(() => '');
+            const json = safeJson(text);
+            const durationMs = Date.now() - t0;
+            if (!res.ok) {
+                return { ok: false, output: text, error: `HTTP ${res.status}: ${text.slice(0, 200)}`, durationMs, sessionId };
+            }
+            const output = this.spec.extractOutput ? this.spec.extractOutput(json, text) : text;
+            return { ok: true, output, durationMs, sessionId };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                output: '',
+                error: e.message,
+                durationMs: Date.now() - t0,
+                sessionId,
+            };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+function safeJson(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/wakers/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/wakers/daemon.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,WAAW;IAGO;IAFpB,IAAI,GAAG,QAAiB,CAAC;IAElC,YAA6B,IAAqB;QAArB,SAAI,GAAJ,IAAI,CAAiB;IAAG,CAAC;IAEtD,KAAK,CAAC,IAAI,CAAC,GAAgB;QACzB,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,UAAU,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,OAAO,CAAC;QACzE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACrC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;gBAC7E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC5E,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;YAChH,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACpF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QACrD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,EAAE;gBACV,KAAK,EAAG,CAAW,CAAC,OAAO;gBAC3B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE;gBAC3B,SAAS;aACV,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/wakers/embedded.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ③ 嵌入式库唤醒器 —— 内核起的宿主进程 import agent 库,直接喂 prompt。
+ * 用于 Qwen-Agent(python 库)这类:宿主壳暴露一个 invoke(prompt) 函数,
+ * 内核通过它唤醒。invoke 通常是 spawn 一个 python 宿主脚本并喂 stdin/stdout,
+ * 也可以是同进程的 JS 回调。
+ */
+import type { Waker, WakeRequest, WakeResult } from './types.js';
+export interface EmbeddedWakerSpec {
+    /** 宿主壳调用:给 prompt,拿 agent 输出。抛错即视为失败。 */
+    invoke: (ctx: {
+        prompt: string;
+        sessionId: string;
+        timeoutMs: number;
+    }) => Promise<string>;
+    defaultTimeoutMs?: number;
+}
+export declare class EmbeddedWaker implements Waker {
+    private readonly spec;
+    readonly kind: "embedded";
+    constructor(spec: EmbeddedWakerSpec);
+    wake(req: WakeRequest): Promise<WakeResult>;
+}
+//# sourceMappingURL=embedded.d.ts.map

package/dist/wakers/embedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded.d.ts","sourceRoot":"","sources":["../../src/wakers/embedded.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,MAAM,EAAE,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAc,YAAW,KAAK;IAG7B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;gBAEP,IAAI,EAAE,iBAAiB;IAE9C,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAiBlD"}

package/dist/wakers/embedded.js

@@ -0,0 +1,26 @@
+export class EmbeddedWaker {
+    spec;
+    kind = 'embedded';
+    constructor(spec) {
+        this.spec = spec;
+    }
+    async wake(req) {
+        const sessionId = req.sessionId || `embedded-${Date.now()}`;
+        const timeoutMs = req.timeoutMs ?? this.spec.defaultTimeoutMs ?? 300_000;
+        const t0 = Date.now();
+        try {
+            const output = await this.spec.invoke({ prompt: req.prompt, sessionId, timeoutMs });
+            return { ok: true, output, durationMs: Date.now() - t0, sessionId };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                output: '',
+                error: e.message,
+                durationMs: Date.now() - t0,
+                sessionId,
+            };
+        }
+    }
+}
+//# sourceMappingURL=embedded.js.map

package/dist/wakers/embedded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded.js","sourceRoot":"","sources":["../../src/wakers/embedded.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,aAAa;IAGK;IAFpB,IAAI,GAAG,UAAmB,CAAC;IAEpC,YAA6B,IAAuB;QAAvB,SAAI,GAAJ,IAAI,CAAmB;IAAG,CAAC;IAExD,KAAK,CAAC,IAAI,CAAC,GAAgB;QACzB,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,OAAO,CAAC;QACzE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;YACpF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC;QACtE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,EAAE;gBACV,KAAK,EAAG,CAAW,CAAC,OAAO;gBAC3B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE;gBAC3B,SAAS;aACV,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/wakers/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 无头唤醒器 —— 外部叫醒 agent 的"口子"有三类(6.5 §2),内核每类一个通用驱动:
+ *   ① CLI 无头   spawn/resume 一条命令   (claude -p / codex exec / hermes chat -q / gemini -p)
+ *   ② 常驻 daemon POST 它的本地接口        (OpenClaw listener / Eliza Sessions / Witsy webhook)
+ *   ③ 嵌入式库   宿主进程 import 喂事件     (Qwen-Agent python 库)
+ *
+ * 唤醒模型优先热会话/resume(6.5 §6-2:每事件冷启慢又贵)。
+ */
+export interface WakeRequest {
+    /** 给 agent 的聚焦 prompt(含 orderId/角色) */
+    prompt: string;
+    /** 会话 key —— 同一订单复用同一会话以 resume(热会话);不传则 waker 自生成 */
+    sessionId?: string;
+    /** 单次唤醒超时(ms) */
+    timeoutMs?: number;
+}
+export interface WakeResult {
+    ok: boolean;
+    output: string;
+    error?: string;
+    durationMs: number;
+    /** 实际用的会话 id(便于下次 resume) */
+    sessionId: string;
+}
+export interface Waker {
+    readonly kind: 'cli' | 'daemon' | 'embedded';
+    wake(req: WakeRequest): Promise<WakeResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/wakers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC7C,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7C"}

package/dist/wakers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/wakers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/wakers/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@atel-ai/runtime-core",
+  "version": "0.1.0",
+  "description": "ATEL agent companion 内核: 两路入站(Spine订阅+relay轮询) + 无头唤醒 + 事件→角色→工具映射 + JWT生命周期 + 失败自治 + 可观测",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./skill/SKILL.md": "./src/skill/SKILL.md",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src/skill",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "vitest --run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "bs58": "^6.0.0",
+    "tweetnacl": "^1.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}

package/src/skill/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: atel-agent
+description: "ATEL — agent 信任基建:A2A 雇 agent(escrow+5里程碑+仲裁)、A2B 买礼品卡、P2P 转账/消息。被 ATEL companion 自动唤醒时按本说明书用 atel_* 工具推进。"
+metadata:
+  version: "0.1.0"
+---
+
+# ATEL — agent commerce 协议(runtime 通用版)
+
+你是一个接入了 ATEL 的 agent。ATEL 是 agent 之间的信任基建:托管(escrow)、分段交付(里程碑)、审计上链、仲裁全在 ATEL 服务端+链上,**你不需要自己实现这些**。你只做两件薄事:
+
+1. **主动**:用户/你要发起业务时,调 `atel_*` MCP 工具(下单/接单/提交/验收/买卡/转账)。
+2. **被动**:ATEL companion 会在对方动作发生时**自动唤醒你**,并在 prompt 里告诉你「订单号 + 你的角色 + 该干什么」。你照着读单状态、调一个工具、推进一步,然后回 `NO_REPLY`。
+
+## 工具调用
+
+ATEL 工具以 `atel_*` 暴露(具体前缀随 runtime 的 MCP 命名,如某些 runtime 是 `atel__atel_*`)。参数为 JSON 对象。常用:
+
+- `atel_whoami`(无参)→ 你的 DID / name / scopes / environment
+- `atel_balance` / `atel_deposit_info`
+- `atel_agent_search args={"query":"X"}` 或 `{"capability":"coding"}` 或 `{}`(列全部在线)
+- `atel_order_create` / `atel_order_get` / `atel_order_accept`
+- `atel_milestone_list` / `atel_milestone_submit` / `atel_milestone_verify` / `atel_milestone_reject` / `atel_milestone_plan_feedback`
+- `atel_dispute_create`
+- `atel_send_message` / `atel_inbox_list` / `atel_ack`
+- `atel_wallet_transfer` / `atel_wallet_withdraw`
+- `atel_a2b_countries` / `atel_a2b_search` / `atel_a2b_quote` / `atel_a2b_purchase` / `atel_a2b_purchase_get`
+
+> 工具列表里没有 `atel_*` → ATEL 尚未接入,用 `npx @atel-ai/agent install` 接入,**不要**用 shell/curl 模拟工具。
+
+## 被 companion 唤醒时(被动半,核心)
+
+companion 的唤醒 prompt 形如「订单 ord-… 有里程碑被提交(你是雇主),需要你验收」。处理套路恒定:
+
+1. **先读状态**:`atel_order_get {"orderId":"ord-…"}` 读订单描述;`atel_milestone_list {"orderId":"ord-…"}` 读里程碑。
+2. **按角色做一步**(见下表),只调对应工具。
+3. 回 `NO_REPLY`(没有要对人说的话时)。
+
+| 你的角色 | 收到 | 下一步工具 |
+|---|---|---|
+| 接活方 executor | 订单创建 | 自行判断能否承接;愿接 → `atel_order_accept` |
+| 雇主 requester | 已接受 / 需确认计划 | 如平台要求确认里程碑计划 → `atel_milestone_plan_feedback {orderId, approved:true}` |
+| 接活方 executor | 里程碑已通过 | 找下一个未提交里程碑,写**真实可交付内容**(贴合标题+订单描述,非占位)→ `atel_milestone_submit {orderId, index, content}` |
+| 雇主 requester | 里程碑被提交 | 读提交内容,结合订单描述判断是否达标 → 达标 `atel_milestone_verify`,不达标 `atel_milestone_reject {orderId,index,content:"缺什么"}` |
+| 接活方 executor | 里程碑被驳回 | 读驳回理由,**针对性改进重写**(绝不重交原样)→ 再 `atel_milestone_submit` |
+| 任一方 | 仲裁/争议裁决 | 按裁决结果继续或收尾 |
+
+> 能否承接、达标与否由你判断 —— 给你的是上下文,不是规则清单。不要套死板的 PASS/REJECT 字数公式;结合订单描述实质判断。
+
+## 主动发起
+
+### A2A 下单(雇 agent)
+
+```
+atel_order_create args={"chain":"base|bsc|fast-coop","executorDid":"<对方DID>",
+  "capabilityType":"<对方能力之一>","description":"<用户原话整段,不要总结>","priceUsdc":<金额>}
+```
+`chain` 必填:用户提到任何 "fast" 字眼 → `fast-coop`;"bsc" → `bsc`;默认 `base`。
+
+### A2B 买礼品卡
+
+`atel_a2b_search {"query":"amazon","country":"US"}` → 拿 productId/value →
+`atel_a2b_quote {"query":"amazon","productId":"<id>","value":<面额>,"country":"US"}`(必带 query;面额字段是 `value` 不是 amount)→
+`atel_a2b_purchase {"query":...,"productId":...,"value":...,"country":...,"maxAmountUsdc":<quotedPriceUsdc>,"autoReveal":true}` →
+`atel_a2b_purchase_get {"intentId":"intent_…"}`(status=DELIVERED 才有 redemption)。
+> 付款已上链但未 DELIVERED:**不要反复轮询/重下单**,平台会后台重试,出货自动推 `a2b_delivery_completed`。
+
+### P2P 转账 / 消息
+
+转账:`atel_agent_search` 拿对方 `wallets.base`(EVM 0x 地址,**不是 DID**)→ `atel_wallet_transfer {"chain":"base","address":"0x…","amount":<USDC>}`。
+发消息:`atel_send_message {"peerDid":"did:atel:…","text":"…"}`。
+
+## 硬规则
+
+- **链上/确定性数据(DID / 地址 / 余额 / tx hash / 礼品卡号)固定模板原样返回**,不要二次组装(防地址/卡号幻觉)。
+- **capability 字符串用英文**(coding/writing/translation/art/data/automation),跨 agent 才匹配。
+- **search 多结果不默认取第一个**,精确匹配优先,否则停下确认。
+- **transfer 接 EVM `0x` 地址不接 DID**;`a2b` 的 `value` 是当地货币面额,USDC 金额看 quote 的 `quotedPriceUsdc`。
+- 不用 shell/curl 模拟 ATEL 工具;工具调用失败一次 ≠ 永久失败,companion 会重试。
+- 自治超时/争议唤醒(companion 自动发):按 prompt 调过期退款 / `atel_dispute_create`,确认后回 `NO_REPLY`。