@harrylabsj/kiwi 0.8.0 → 0.10.0

package/dist/merchant-runtime/jobs.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Merchant 实例周期任务骨架（V2 阶段一：src/merchant-runtime/jobs.ts）。
+ *
+ * 本轮落地：健康轮询（health-poll，刷新 capability-probe 与健康报告）+
+ * 持续备份接缝（backup hook——备份实现放阶段四，本轮注册即明确报「未实现」，
+ * 不静默假装已备份）。任务串行执行、异常隔离（单个任务失败不影响其他任务
+ * 与宿主进程），错误进最近运行记录。
+ */
+export interface MerchantJob {
+    name: string;
+    intervalMs: number;
+    run: () => Promise<void>;
+}
+export interface MerchantJobRunRecord {
+    name: string;
+    last_run_at?: string;
+    last_error?: string;
+    runs: number;
+}
+export declare class MerchantJobs {
+    private readonly jobs;
+    private readonly timers;
+    private readonly records;
+    /** 在途任务（审查 P2：重入保护，防长备份与健康轮询自我重叠）。 */
+    private readonly inFlight;
+    private readonly now;
+    private running;
+    constructor(options?: {
+        now?: () => string;
+    });
+    register(job: MerchantJob): void;
+    /** 立即执行一次（异常隔离：记录 last_error，不抛出）。同任务在途时跳过
+     *  （审查 P2：与「串行执行」文档口径一致——长任务不与下一轮并发重叠）。 */
+    runOnce(name: string): Promise<MerchantJobRunRecord>;
+    /** 启动全部周期任务。 */
+    start(): void;
+    stop(): void;
+    list(): MerchantJobRunRecord[];
+}
+/**
+ * 标准任务集：健康轮询 + 持续备份接缝。
+ * backupHook 缺省 = 阶段四未实现的明确接缝（记录错误，绝不静默成功）。
+ */
+export declare function standardMerchantJobs(deps: {
+    healthPoll: () => Promise<void>;
+    backupHook?: () => Promise<void>;
+    healthIntervalMs?: number;
+    backupIntervalMs?: number;
+}): MerchantJob[];

package/dist/merchant-runtime/jobs.js

@@ -0,0 +1,107 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export class MerchantJobs {
+    jobs = new Map();
+    timers = new Map();
+    records = new Map();
+    /** 在途任务（审查 P2：重入保护，防长备份与健康轮询自我重叠）。 */
+    inFlight = new Set();
+    now;
+    running = false;
+    constructor(options = {}) {
+        this.now = options.now ?? (() => new Date().toISOString());
+    }
+    register(job) {
+        if (this.jobs.has(job.name))
+            throw new Error(`job ${job.name} 已注册`);
+        if (!(job.intervalMs > 0))
+            throw new Error(`job ${job.name} intervalMs 必须 > 0`);
+        this.jobs.set(job.name, job);
+        this.records.set(job.name, { name: job.name, runs: 0 });
+    }
+    /** 立即执行一次（异常隔离：记录 last_error，不抛出）。同任务在途时跳过
+     *  （审查 P2：与「串行执行」文档口径一致——长任务不与下一轮并发重叠）。 */
+    async runOnce(name) {
+        const job = this.jobs.get(name);
+        if (job === undefined)
+            throw new Error(`未知任务 ${name}`);
+        if (this.inFlight.has(name)) {
+            const record = this.records.get(name);
+            record.last_run_at = this.now();
+            return { ...record };
+        }
+        this.inFlight.add(name);
+        const record = this.records.get(name);
+        try {
+            await job.run();
+            record.last_run_at = this.now();
+            record.last_error = undefined;
+        }
+        catch (err) {
+            record.last_run_at = this.now();
+            record.last_error = err instanceof Error ? err.message : String(err);
+        }
+        finally {
+            this.inFlight.delete(name);
+        }
+        record.runs += 1;
+        return { ...record };
+    }
+    /** 启动全部周期任务。 */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        for (const [name, job] of this.jobs) {
+            const timer = setInterval(() => {
+                void this.runOnce(name);
+            }, job.intervalMs);
+            timer.unref();
+            this.timers.set(name, timer);
+        }
+    }
+    stop() {
+        this.running = false;
+        for (const timer of this.timers.values())
+            clearInterval(timer);
+        this.timers.clear();
+    }
+    list() {
+        return [...this.records.values()].map((r) => ({ ...r }));
+    }
+}
+/**
+ * 标准任务集：健康轮询 + 持续备份接缝。
+ * backupHook 缺省 = 阶段四未实现的明确接缝（记录错误，绝不静默成功）。
+ */
+export function standardMerchantJobs(deps) {
+    return [
+        {
+            name: "health-poll",
+            intervalMs: deps.healthIntervalMs ?? 60_000,
+            run: deps.healthPoll,
+        },
+        {
+            name: "backup",
+            intervalMs: deps.backupIntervalMs ?? 5 * 60_000,
+            run: deps.backupHook ??
+                (async () => {
+                    throw new Error("持续备份未实现（阶段四）；本轮为显式接缝，不静默假装已备份");
+                }),
+        },
+    ];
+}
+//# sourceMappingURL=jobs.js.map

package/dist/merchant-runtime/jobs.js.map

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

package/dist/merchant-runtime/manager.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Merchant 实例运行时管理（V2 阶段一：src/merchant-runtime/manager.ts）。
+ *
+ * 独立管理进程语义：A2A 接待服务与 MCP 管理服务作为受管子进程管理，
+ * 互不影响——停止 A2A 后管理入口（本 manager）仍可重启它（阶段一验收项）。
+ * WorkBuddy / MCP 会话退出不影响受管服务（detached + unref）。
+ *
+ * 进程状态落 `<dir>/runtime/`：`<name>.pid` / `<name>.log` / `<name>.exit.json`。
+ * 自动重启：supervise() 监控子进程异常退出并按退避重启；显式 stop 的不重启。
+ * 阶段一为单活形态；主备 fencing 留阶段四（V2 §5.3）。
+ */
+import { spawn } from "node:child_process";
+export interface ManagedServiceSpec {
+    /** 服务名（a2a / mcp 等，作为文件名须安全）。 */
+    name: string;
+    /** 完整 argv（如 [process.execPath, "dist/cli.js", "merchant", "start", "--no-chat"]）。 */
+    command: string[];
+    env?: Record<string, string>;
+    /** 确定的工作目录（BUG-04：缺省 = 数据根目录语义由调用方保证）。 */
+    cwd?: string;
+}
+export interface ManagedServiceState {
+    name: string;
+    running: boolean;
+    pid?: number;
+    restarts: number;
+    /** 显式停止（stop）后不再自动重启，直到再次 start。 */
+    stopped: boolean;
+    last_exit?: {
+        exit_code: number | null;
+        at: string;
+    };
+}
+export declare class MerchantRuntimeError extends Error {
+    readonly code: "unknown_service" | "already_running" | "not_running" | "spawn_failed";
+    constructor(message: string, code: "unknown_service" | "already_running" | "not_running" | "spawn_failed");
+}
+export declare class MerchantRuntimeManager {
+    private readonly dir;
+    private readonly runDir;
+    private readonly services;
+    private readonly children;
+    private readonly now;
+    private readonly spawnImpl;
+    constructor(options: {
+        dir: string;
+        services: ManagedServiceSpec[];
+        now?: () => string;
+        /** 测试注入。 */
+        spawnImpl?: typeof spawn;
+    });
+    private pidFile;
+    private logFile;
+    private exitFile;
+    private spec;
+    /** 读取 pidfile 里的存活状态（管理入口重启后据此恢复视图）。 */
+    private livePid;
+    /**
+     * PID 存活不等于仍是 Kiwi 子进程；校验命令行，避免 PID 复用误杀。
+     * 返回 "unknown" = 查询手段失败（ps 缺失/超时）——不能证明进程不存在，
+     * 调用方按保守（存活）处理，绝不据此重拉新实例（审查 P2 fail-open 修复）。
+     */
+    private matchesProcess;
+    private scheduleRestart;
+    /** 启动服务（已在运行 → already_running 拒绝重复启动）。 */
+    start(name: string): Promise<ManagedServiceState>;
+    /** 停止服务（SIGTERM；显式停止后不自动重启）。 */
+    stop(name: string): Promise<ManagedServiceState>;
+    /** 重启（停止 → 启动）；停止 A2A 后管理入口可重启它（阶段一验收项）。 */
+    restart(name: string): Promise<ManagedServiceState>;
+    private stateOf;
+    /** 全部服务状态。 */
+    status(): ManagedServiceState[];
+    /** 监控模式（runtime start 前台运行）：启动全部服务并保持，异常退出自动重启。 */
+    private supervising;
+    supervise(): Promise<void>;
+    /** 停止监控并停掉全部服务（优雅关闭）。 */
+    shutdown(): Promise<void>;
+}

package/dist/merchant-runtime/manager.js

@@ -0,0 +1,305 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Merchant 实例运行时管理（V2 阶段一：src/merchant-runtime/manager.ts）。
+ *
+ * 独立管理进程语义：A2A 接待服务与 MCP 管理服务作为受管子进程管理，
+ * 互不影响——停止 A2A 后管理入口（本 manager）仍可重启它（阶段一验收项）。
+ * WorkBuddy / MCP 会话退出不影响受管服务（detached + unref）。
+ *
+ * 进程状态落 `<dir>/runtime/`：`<name>.pid` / `<name>.log` / `<name>.exit.json`。
+ * 自动重启：supervise() 监控子进程异常退出并按退避重启；显式 stop 的不重启。
+ * 阶段一为单活形态；主备 fencing 留阶段四（V2 §5.3）。
+ */
+import { execFileSync, spawn } from "node:child_process";
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import path from "node:path";
+export class MerchantRuntimeError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "MerchantRuntimeError";
+    }
+}
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 异常退出后的重启退避（毫秒；指数，封顶 30s）。 */
+function backoffMs(restarts) {
+    return Math.min(30_000, 500 * 2 ** Math.min(restarts, 6));
+}
+export class MerchantRuntimeManager {
+    dir;
+    runDir;
+    services = new Map();
+    children = new Map();
+    now;
+    spawnImpl;
+    constructor(options) {
+        this.dir = options.dir;
+        this.runDir = path.join(options.dir, "runtime");
+        this.now = options.now ?? (() => new Date().toISOString());
+        this.spawnImpl = options.spawnImpl ?? spawn;
+        for (const spec of options.services) {
+            if (!/^[a-z0-9-]+$/.test(spec.name)) {
+                throw new MerchantRuntimeError(`非法服务名 ${spec.name}`, "unknown_service");
+            }
+            this.services.set(spec.name, spec);
+        }
+        mkdirSync(this.runDir, { recursive: true, mode: 0o700 });
+    }
+    pidFile(name) {
+        return path.join(this.runDir, `${name}.pid`);
+    }
+    logFile(name) {
+        return path.join(this.runDir, `${name}.log`);
+    }
+    exitFile(name) {
+        return path.join(this.runDir, `${name}.exit.json`);
+    }
+    spec(name) {
+        const spec = this.services.get(name);
+        if (spec === undefined) {
+            throw new MerchantRuntimeError(`未知服务 ${name}（已知：${[...this.services.keys()].join(", ")}）`, "unknown_service");
+        }
+        return spec;
+    }
+    /** 读取 pidfile 里的存活状态（管理入口重启后据此恢复视图）。 */
+    livePid(name) {
+        try {
+            const record = JSON.parse(readFileSync(this.pidFile(name), "utf8"));
+            if (!Number.isInteger(record.pid) || record.pid <= 0 || !pidAlive(record.pid))
+                return undefined;
+            const matched = this.matchesProcess(record.pid, this.spec(name));
+            if (matched === false)
+                return undefined;
+            // matched === true | "unknown"：unknown（ps 不可用/超时）时 pid 存活 +
+            // pidfile 记录即证据——按存活认领，绝不 fail-open 双 spawn（审查 P2）。
+            return record.pid;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * PID 存活不等于仍是 Kiwi 子进程；校验命令行，避免 PID 复用误杀。
+     * 返回 "unknown" = 查询手段失败（ps 缺失/超时）——不能证明进程不存在，
+     * 调用方按保守（存活）处理，绝不据此重拉新实例（审查 P2 fail-open 修复）。
+     */
+    matchesProcess(pid, spec) {
+        // Windows does not provide a portable command-line query through the
+        // standard Node APIs; keep the live-pid behavior there and rely on the
+        // service manager's per-instance directory isolation.
+        if (process.platform === "win32")
+            return true;
+        try {
+            const commandLine = execFileSync("ps", ["-p", String(pid), "-o", "command="], {
+                encoding: "utf8",
+                timeout: 2_000,
+            }).trim();
+            return spec.command.every((arg) => arg === "" || commandLine.includes(arg));
+        }
+        catch {
+            return "unknown";
+        }
+    }
+    scheduleRestart(name, previous) {
+        const delay = backoffMs(previous.restarts);
+        setTimeout(() => {
+            if (!this.supervising || previous.stopped)
+                return;
+            void this.start(name)
+                .then(() => {
+                const next = this.children.get(name);
+                if (next !== undefined)
+                    next.restarts = previous.restarts;
+            })
+                .catch(() => {
+                // 配置/权限/工作目录错误也按退避持续重试，保持 7×24 manager 存活。
+                if (this.supervising && !previous.stopped) {
+                    previous.restarts = Math.min(previous.restarts + 1, 32);
+                    this.scheduleRestart(name, previous);
+                }
+            });
+        }, delay).unref();
+    }
+    /** 启动服务（已在运行 → already_running 拒绝重复启动）。 */
+    async start(name) {
+        const spec = this.spec(name);
+        const existing = this.livePid(name);
+        if (existing !== undefined) {
+            throw new MerchantRuntimeError(`服务 ${name} 已在运行（pid ${existing}）`, "already_running");
+        }
+        const child = this.spawnImpl(spec.command[0] ?? "", spec.command.slice(1), {
+            detached: true,
+            stdio: ["ignore", "ignore", "ignore"],
+            env: { ...process.env, ...spec.env },
+            ...(spec.cwd !== undefined ? { cwd: spec.cwd } : {}),
+        });
+        // An invalid executable emits `error` asynchronously; attach a listener
+        // before checking pid so a failed spawn cannot crash the runtime manager.
+        child.once("error", () => undefined);
+        child.unref();
+        if (child.pid === undefined) {
+            throw new MerchantRuntimeError(`服务 ${name} 启动失败（无 pid）`, "spawn_failed");
+        }
+        const state = { pid: child.pid, restarts: 0, stopped: false };
+        this.children.set(name, state);
+        try {
+            writeFileSync(this.pidFile(name), `${JSON.stringify({ pid: child.pid, command: spec.command, ...(spec.cwd !== undefined ? { cwd: spec.cwd } : {}) })}\n`, { mode: 0o600 });
+        }
+        catch (err) {
+            // 审查 P2：pidfile 写失败时子进程已在跑——不回滚就会出现「无 pidfile
+            // 的活子进程」，异常路径重试会双 spawn（双 a2a 抢账本/端口）。
+            this.children.delete(name);
+            try {
+                child.kill("SIGTERM");
+            }
+            catch {
+                // 已退出
+            }
+            throw new MerchantRuntimeError(`服务 ${name} pidfile 写入失败，已终止刚启动的子进程：` +
+                `${err instanceof Error ? err.message : String(err)}`, "spawn_failed");
+        }
+        rmSync(this.exitFile(name), { force: true });
+        let finalized = false;
+        const finalize = (code) => {
+            if (finalized)
+                return;
+            finalized = true;
+            writeFileSync(this.exitFile(name), `${JSON.stringify({ exit_code: code, at: this.now() })}\n`, { mode: 0o600 });
+            const current = this.children.get(name);
+            this.children.delete(name);
+            rmSync(this.pidFile(name), { force: true });
+            // 异常退出自动重启（显式 stop 的不重启）；退避防崩溃风暴。
+            if (current !== undefined && !current.stopped && this.supervising) {
+                current.restarts += 1;
+                this.scheduleRestart(name, current);
+            }
+        };
+        // spawn 的 error 事件若无监听会成为未处理 EventEmitter 错误，直接退出 manager。
+        child.once("error", () => finalize(null));
+        child.once("exit", (code) => finalize(code));
+        return this.stateOf(name);
+    }
+    /** 停止服务（SIGTERM；显式停止后不自动重启）。 */
+    async stop(name) {
+        this.spec(name);
+        const current = this.children.get(name);
+        if (current !== undefined)
+            current.stopped = true;
+        let pid = current?.pid ?? this.livePid(name);
+        if (pid === undefined) {
+            // 审查 P2：spec（argv）变更后旧进程与新 spec 命令行不符，livePid 认领
+            // 不到——按 pidfile 原始记录的 command 校验并停掉，否则旧进程永远停
+            // 不掉且 start 会双跑（旧实例以旧策略继续对外报价）。
+            try {
+                const record = JSON.parse(readFileSync(this.pidFile(name), "utf8"));
+                if (Number.isInteger(record.pid) &&
+                    record.pid > 0 &&
+                    pidAlive(record.pid) &&
+                    this.matchesProcess(record.pid, {
+                        name,
+                        command: record.command,
+                        ...(record.cwd !== undefined ? { cwd: record.cwd } : {}),
+                    }) !== false) {
+                    pid = record.pid;
+                }
+            }
+            catch {
+                // 无 pidfile / 解析失败：按无进程处理
+            }
+        }
+        if (pid === undefined) {
+            rmSync(this.pidFile(name), { force: true });
+            return this.stateOf(name);
+        }
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch {
+            // 已退出
+        }
+        const deadline = Date.now() + 5_000;
+        while (Date.now() < deadline && pidAlive(pid)) {
+            await new Promise((r) => setTimeout(r, 25));
+        }
+        if (pidAlive(pid)) {
+            try {
+                process.kill(pid, "SIGKILL");
+            }
+            catch {
+                // 已退出
+            }
+        }
+        this.children.delete(name);
+        rmSync(this.pidFile(name), { force: true });
+        return this.stateOf(name);
+    }
+    /** 重启（停止 → 启动）；停止 A2A 后管理入口可重启它（阶段一验收项）。 */
+    async restart(name) {
+        await this.stop(name);
+        return await this.start(name);
+    }
+    stateOf(name) {
+        const current = this.children.get(name);
+        const pid = current?.pid ?? this.livePid(name);
+        let lastExit;
+        try {
+            lastExit = JSON.parse(readFileSync(this.exitFile(name), "utf8"));
+        }
+        catch {
+            lastExit = undefined;
+        }
+        return {
+            name,
+            running: pid !== undefined,
+            ...(pid !== undefined ? { pid } : {}),
+            restarts: current?.restarts ?? 0,
+            stopped: current?.stopped ?? pid === undefined,
+            ...(lastExit !== undefined && lastExit !== null ? { last_exit: lastExit } : {}),
+        };
+    }
+    /** 全部服务状态。 */
+    status() {
+        return [...this.services.keys()].map((name) => this.stateOf(name));
+    }
+    /** 监控模式（runtime start 前台运行）：启动全部服务并保持，异常退出自动重启。 */
+    supervising = false;
+    async supervise() {
+        this.supervising = true;
+        for (const name of this.services.keys()) {
+            const pid = this.livePid(name);
+            if (pid === undefined)
+                await this.start(name);
+        }
+    }
+    /** 停止监控并停掉全部服务（优雅关闭）。 */
+    async shutdown() {
+        this.supervising = false;
+        for (const name of [...this.services.keys()].reverse()) {
+            await this.stop(name);
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/merchant-runtime/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/merchant-runtime/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,IAAI,MAAM,WAAW,CAAC;AAsB7B,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAGlC;IAFX,YACE,OAAe,EACN,IAA4E;QAErF,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,SAAI,GAAJ,IAAI,CAAwE;QAGrF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,gCAAgC;AAChC,SAAS,SAAS,CAAC,QAAgB;IACjC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAcD,MAAM,OAAO,sBAAsB;IAChB,GAAG,CAAS;IACZ,MAAM,CAAS;IACf,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;IACjD,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC3C,GAAG,CAAe;IAClB,SAAS,CAAe;IAEzC,YAAY,OAMX;QACC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,oBAAoB,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,EAAE,iBAAiB,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAEO,OAAO,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;IAC/C,CAAC;IAEO,OAAO,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;IAC/C,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,CAAC;IACrD,CAAC;IAEO,IAAI,CAAC,IAAY;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,oBAAoB,CAC5B,QAAQ,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAC1D,iBAAiB,CAClB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IAChC,OAAO,CAAC,IAAY;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAc,CAAC;YACjF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAC;YAChG,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACjE,IAAI,OAAO,KAAK,KAAK;gBAAE,OAAO,SAAS,CAAC;YACxC,4DAA4D;YAC5D,oDAAoD;YACpD,OAAO,MAAM,CAAC,GAAG,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,GAAW,EAAE,IAAwB;QAC1D,qEAAqE;QACrE,uEAAuE;QACvE,sDAAsD;QACtD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE;gBAC5E,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,KAAK;aACf,CAAC,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,IAAY,EAAE,QAAsB;QAC1D,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3C,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO;gBAAE,OAAO;YAClD,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;iBAClB,IAAI,CAAC,GAAG,EAAE;gBACT,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,IAAI,KAAK,SAAS;oBAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;YAC5D,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE;gBACV,2CAA2C;gBAC3C,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;oBAC1C,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxD,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC,CAAC,CAAC;QACP,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,oBAAoB,CAAC,MAAM,IAAI,aAAa,QAAQ,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACzE,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;YACrC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;YACpC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC,CAAC;QACH,wEAAwE;QACxE,0EAA0E;QAC1E,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrC,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,oBAAoB,CAAC,MAAM,IAAI,cAAc,EAAE,cAAc,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,KAAK,GAAiB,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,aAAa,CACX,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAClB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EACtH,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,8CAA8C;YAC9C,uCAAuC;YACvC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM;YACR,CAAC;YACD,MAAM,IAAI,oBAAoB,CAC5B,MAAM,IAAI,2BAA2B;gBACnC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACvD,cAAc,CACf,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,QAAQ,GAAG,CAAC,IAAmB,EAAQ,EAAE;YAC7C,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,aAAa,CACX,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EACnB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAC1D,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;YACF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,kCAAkC;YAClC,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAClE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;gBACtB,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;QACH,CAAC,CAAC;QACF,2DAA2D;QAC3D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QAClD,IAAI,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,iDAAiD;YACjD,6CAA6C;YAC7C,gCAAgC;YAChC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAc,CAAC;gBACjF,IACE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;oBAC5B,MAAM,CAAC,GAAG,GAAG,CAAC;oBACd,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;oBACpB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE;wBAC9B,IAAI;wBACJ,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACzD,CAAC,KAAK,KAAK,EACZ,CAAC;oBACD,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;gBACnB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;QACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM;QACR,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACpC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAEO,OAAO,CAAC,IAAY;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,QAA0C,CAAC;QAC/C,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CACnB,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CACN,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;QACD,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,GAAG,KAAK,SAAS;YAC1B,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,GAAG,KAAK,SAAS;YAC9C,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF,CAAC;IACJ,CAAC;IAED,cAAc;IACd,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,mDAAmD;IAC3C,WAAW,GAAG,KAAK,CAAC;IAE5B,KAAK,CAAC,SAAS;QACb,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/merchant-runtime/services.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * runtime 受管服务命令构造（BUG-04 修复）。
+ *
+ * A2A 与 MCP 子进程显式携带 `--data-dir <merchantDataDir>`（三槽位解析结果）
+ * 与确定的工作目录（cwd = merchantDataDir）——A2A Ledger、MCP 状态、
+ * oauth.sqlite、stats 等全部落在同一数据根目录；manager 的健康/备份与
+ * 子进程读写同一真实业务状态。
+ */
+import type { ManagedServiceSpec } from "./manager.js";
+import type { MerchantMcpRuntimeDirs } from "../mcp/merchant-dirs.js";
+export declare function buildRuntimeServiceSpecs(options: {
+    dirs: MerchantMcpRuntimeDirs;
+    cliEntry: string;
+    profileArgs: string[];
+}): ManagedServiceSpec[];