@okclaw-build/cli 1.0.0-beta.3 → 1.0.0-beta.30

package/dist/output/ndjson.js

@@ -0,0 +1,136 @@
+import { appendFileSync } from 'node:fs';
+import { getNdjsonPath, getOpId, isNdjson } from './mode.js';
+const defaultWriter = (line) => {
+    const path = getNdjsonPath();
+    if (path) {
+        appendFileSync(path, line);
+    }
+    else {
+        process.stdout.write(line);
+    }
+};
+/**
+ * 单 op 的事件发射器。在 text 模式下所有方法都是 no-op；ndjson 模式才写出。
+ *
+ * 约定：
+ *   - seq 单调递增，同一 emitter 实例内唯一
+ *   - end() 只能发一次，重复调用忽略
+ *   - 非正常退出（exception/signal）由 registerExitHandlers 兜底补 end
+ */
+export class NdjsonEmitter {
+    seq = 0;
+    op;
+    writer;
+    ended = false;
+    constructor(op, writer = defaultWriter) {
+        this.op = op;
+        this.writer = writer;
+    }
+    start(msg = '', fields) {
+        this.emit('start', 'info', { msg, fields });
+    }
+    stepStart(step, msg, fields) {
+        this.emit('step_start', 'info', { step, msg, fields });
+    }
+    progress(step, progress, msg, fields) {
+        const clamped = Number.isFinite(progress) ? Math.max(0, Math.min(1, progress)) : undefined;
+        this.emit('progress', 'info', { step, progress: clamped, msg, fields });
+    }
+    stepDone(step, msg, fields) {
+        this.emit('step_done', 'info', { step, msg, fields });
+    }
+    /**
+     * 通用日志事件。走独立 phase="log"（bug#7 修：之前借用 phase="progress" 会
+     * 污染"取 max(progress) 作为当前进度"的聚合逻辑）。用 level 区分严重度。
+     */
+    log(level, msg, fields) {
+        this.emit('log', level, { msg, fields });
+    }
+    /**
+     * 终态事件；必发。ok=false 时 fields 里加 errorCode（可选）。
+     * end 事件的 fields 可承载 op-specific 返回值（如 FILE_READ 的 content）。
+     */
+    end(ok, exitCode, code, fields) {
+        if (this.ended)
+            return;
+        this.ended = true;
+        const mergedFields = { ok, exitCode, ...(fields ?? {}) };
+        this.emit('end', ok ? 'info' : 'error', {
+            msg: ok ? 'success' : 'failed',
+            fields: mergedFields,
+            code,
+        });
+    }
+    hasEnded() {
+        return this.ended;
+    }
+    emit(phase, level, partial) {
+        if (!isNdjson())
+            return;
+        const opId = getOpId();
+        const userFields = { ...(partial.fields ?? {}) };
+        if (opId !== undefined && userFields.opId === undefined) {
+            userFields.opId = opId;
+        }
+        const event = {
+            ts: new Date().toISOString(),
+            seq: ++this.seq,
+            op: this.op,
+            phase,
+            level,
+        };
+        if (partial.step !== undefined)
+            event.step = partial.step;
+        if (partial.progress !== undefined)
+            event.progress = partial.progress;
+        if (partial.msg !== undefined && partial.msg !== '')
+            event.msg = partial.msg;
+        if (Object.keys(userFields).length > 0)
+            event.fields = userFields;
+        if (partial.code !== undefined)
+            event.code = partial.code;
+        this.writer(JSON.stringify(event) + '\n');
+    }
+}
+// bug#4 修：顶层 main().catch 里也要能拿到活 emitter 发 end 兜底。
+// registerExitHandlers 时把 emitter 挂到 module 级，exposé getActiveEmitter 给 index.ts。
+let activeEmitter = null;
+export function getActiveEmitter() {
+    return activeEmitter;
+}
+export function clearActiveEmitter() {
+    activeEmitter = null;
+}
+/**
+ * 注册进程兜底，确保 ndjson 模式下 end 事件必发（plan P1 风险：忘 flush → os-api 卡死）。
+ * 只在 ndjson 模式生效。
+ */
+export function registerExitHandlers(emitter) {
+    if (!isNdjson())
+        return;
+    activeEmitter = emitter;
+    const finalize = (exitCode, code) => {
+        if (!emitter.hasEnded()) {
+            emitter.end(false, exitCode, code);
+        }
+    };
+    process.on('uncaughtException', (err) => {
+        finalize(1, 'E_UNCAUGHT');
+        process.stderr.write(String(err?.stack ?? err) + '\n');
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        finalize(1, 'E_UNHANDLED_REJECTION');
+        process.stderr.write(String(reason) + '\n');
+        process.exit(1);
+    });
+    process.on('SIGTERM', () => {
+        finalize(143, 'E_SIGTERM');
+        process.exit(143);
+    });
+    process.on('SIGINT', () => {
+        finalize(130, 'E_SIGINT');
+        process.exit(130);
+    });
+}
+//# sourceMappingURL=ndjson.js.map

package/dist/output/ndjson.js.map

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

package/dist/utils/constants.d.ts

@@ -11,8 +11,6 @@ export declare const OPENVIKING_PORT = 1933;
 export declare const NODE_MIN_MAJOR = 22;
 export declare const NODE_MIN_MINOR = 16;
 export declare const NODE_INSTALL_VERSION = "22.16.0";
-export declare const PYTHON_MIN_MAJOR = 3;
-export declare const PYTHON_MIN_MINOR = 11;
 export declare const NPM_REGISTRY = "https://registry.npmmirror.com";
 export declare const PIP_INDEX_URL = "https://pypi.tuna.tsinghua.edu.cn/simple";
 export declare const PIP_TRUSTED_HOST = "pypi.tuna.tsinghua.edu.cn";

package/dist/utils/constants.js

@@ -9,13 +9,10 @@ export const OPENVIKING_HOME = '/root/.openviking';
 export const OPENVIKING_CONF = `${OPENVIKING_HOME}/ov.conf`;
 export const OPENVIKING_ENV = `${OPENCLAW_HOME}/openviking.env`;
 export const OPENVIKING_PORT = 1933;
-// Version requirements — slightly above official minimums
-// Official: Node >= 22.14, Python >= 3.10
+// Version requirements — slightly above official minimum (Node >= 22.14)
 export const NODE_MIN_MAJOR = 22;
 export const NODE_MIN_MINOR = 16;
 export const NODE_INSTALL_VERSION = '22.16.0';
-export const PYTHON_MIN_MAJOR = 3;
-export const PYTHON_MIN_MINOR = 11;
 // China mirrors
 export const NPM_REGISTRY = 'https://registry.npmmirror.com';
 export const PIP_INDEX_URL = 'https://pypi.tuna.tsinghua.edu.cn/simple';

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,WAAW,SAAS,CAAC;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,WAAW,SAAS,CAAC;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,WAAW,MAAM,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,aAAa,YAAY,CAAC;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,eAAe,UAAU,CAAC;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,aAAa,iBAAiB,CAAC;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,0DAA0D;AAC1D,0CAA0C;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,0CAA0C,CAAC;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEhE,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,6BAA6B,CAAC;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE,gDAAgD;AAChD,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,mBAAmB,EAAE,WAAW,EAAE,oBAAoB;IACtD,mBAAmB,EAAE,eAAe,EAAE,iBAAiB;IACvD,8BAA8B,EAAE,sBAAsB;IACtD,eAAe;CAChB,CAAC;AAEF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,QAAQ,EAAE,iBAAiB;IAC3B,MAAM,EAAE,iCAAiC;IACzC,iDAAiD;IACjD,mEAAmE;CACpE,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,WAAW,SAAS,CAAC;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,WAAW,SAAS,CAAC;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,WAAW,MAAM,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,aAAa,YAAY,CAAC;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,eAAe,UAAU,CAAC;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,aAAa,iBAAiB,CAAC;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,0CAA0C,CAAC;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEhE,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,6BAA6B,CAAC;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE,gDAAgD;AAChD,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,mBAAmB,EAAE,WAAW,EAAE,oBAAoB;IACtD,mBAAmB,EAAE,eAAe,EAAE,iBAAiB;IACvD,8BAA8B,EAAE,sBAAsB;IACtD,eAAe;CAChB,CAAC;AAEF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,QAAQ,EAAE,iBAAiB;IAC3B,MAAM,EAAE,iCAAiC;IACzC,iDAAiD;IACjD,mEAAmE;CACpE,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC"}

package/dist/utils/deps.d.ts

@@ -3,11 +3,6 @@
  * Installs nvm first if not present, then installs Node.js through nvm.
  */
 export declare function ensureNodeVersion(): Promise<void>;
-/**
- * Ensure Python >= PYTHON_MIN_MAJOR.PYTHON_MIN_MINOR is installed.
- * Auto-installs via system package manager if missing or too old.
- */
-export declare function ensurePython(): Promise<void>;
 /**
  * Ensure a command exists on PATH.
  */

package/dist/utils/deps.js

@@ -1,6 +1,6 @@
 import { shell, shellCapture, commandExists } from './shell.js';
 import { info, warn } from './logger.js';
-import { NODE_MIN_MAJOR, NODE_MIN_MINOR, NODE_INSTALL_VERSION, NODE_MIRROR, PYTHON_MIN_MAJOR, PYTHON_MIN_MINOR, } from './constants.js';
+import { NODE_MIN_MAJOR, NODE_MIN_MINOR, NODE_INSTALL_VERSION, NODE_MIRROR, } from './constants.js';
 /**
  * Ensure Node.js >= NODE_MIN_MAJOR.NODE_MIN_MINOR is installed via nvm.
  * Installs nvm first if not present, then installs Node.js through nvm.
@@ -55,79 +55,6 @@ async function installNodejs() {
         throw new Error('Node.js installation failed: node command not found');
     info(`Node.js ${verify.stdout.trim()} installed via nvm ✓`);
 }
-/**
- * Ensure Python >= PYTHON_MIN_MAJOR.PYTHON_MIN_MINOR is installed.
- * Auto-installs via system package manager if missing or too old.
- */
-export async function ensurePython() {
-    const required = `${PYTHON_MIN_MAJOR}.${PYTHON_MIN_MINOR}`;
-    const result = await shellCapture('python3 --version');
-    if (result.code === 0) {
-        const match = result.stdout.match(/(\d+)\.(\d+)\.?(\d+)?/);
-        if (match) {
-            const version = `${match[1]}.${match[2]}`;
-            if (versionGe(version, required)) {
-                info(`Python ${result.stdout.trim()} >= ${required} ✓`);
-                await ensurePip();
-                return;
-            }
-            warn(`Python ${version} < ${required}, upgrading...`);
-        }
-    }
-    else {
-        info('Python3 not found, installing...');
-    }
-    await installPython();
-    await ensurePip();
-}
-async function installPython() {
-    const required = `${PYTHON_MIN_MAJOR}.${PYTHON_MIN_MINOR}`;
-    info(`Installing Python >= ${required}...`);
-    if (await commandExists('apt-get')) {
-        // Try deadsnakes PPA for newer Python on older Ubuntu
-        await shell('apt-get update -qq').catch(() => { });
-        await shell('apt-get install -y -qq python3 python3-pip python3-venv python3-dev').catch(async () => {
-            info('Trying deadsnakes PPA...');
-            await shell('apt-get install -y -qq software-properties-common').catch(() => { });
-            await shell('add-apt-repository -y ppa:deadsnakes/ppa').catch(() => { });
-            await shell('apt-get update -qq');
-            await shell('apt-get install -y -qq python3 python3-pip python3-venv python3-dev');
-        });
-    }
-    else if (await commandExists('dnf')) {
-        await shell('dnf install -y python3 python3-pip python3-devel');
-    }
-    else if (await commandExists('yum')) {
-        await shell('yum install -y python3 python3-pip python3-devel');
-    }
-    else {
-        throw new Error(`Cannot install Python: no supported package manager. Install Python >= ${required} manually.`);
-    }
-    // Verify
-    const verify = await shellCapture('python3 --version');
-    if (verify.code !== 0)
-        throw new Error('Python installation failed');
-    const match = verify.stdout.match(/(\d+)\.(\d+)/);
-    if (match && !versionGe(`${match[1]}.${match[2]}`, required)) {
-        throw new Error(`Installed Python ${match[1]}.${match[2]} still below ${required}. Install manually.`);
-    }
-    info(`Python ${verify.stdout.trim()} installed ✓`);
-}
-/**
- * Ensure pip is available.
- */
-async function ensurePip() {
-    const result = await shellCapture('python3 -m pip --version');
-    if (result.code === 0)
-        return;
-    info('pip not found, installing...');
-    await shell('curl -fsSL https://bootstrap.pypa.io/get-pip.py | python3').catch(async () => {
-        await installSystemPackages(['python3-pip']);
-    });
-    const verify = await shellCapture('python3 -m pip --version');
-    if (verify.code !== 0)
-        throw new Error('Failed to install pip');
-}
 /**
  * Ensure a command exists on PATH.
  */
@@ -147,20 +74,6 @@ export async function checkDiskSpace(requiredMb) {
     }
 }
 // ---- helpers ----
-async function installSystemPackages(packages) {
-    if (await commandExists('apt-get')) {
-        await shell(`apt-get update -qq && apt-get install -y -qq ${packages.join(' ')}`);
-    }
-    else if (await commandExists('dnf')) {
-        await shell(`dnf install -y ${packages.join(' ')}`);
-    }
-    else if (await commandExists('yum')) {
-        await shell(`yum install -y ${packages.join(' ')}`);
-    }
-    else {
-        throw new Error(`Cannot install packages: no supported package manager`);
-    }
-}
 function versionGe(a, b) {
     const pa = a.split('.').map(Number);
     const pb = b.split('.').map(Number);

package/dist/utils/deps.js.map

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

package/dist/utils/logger.d.ts

@@ -1,3 +1,13 @@
+/**
+ * 人类可读 log。
+ *
+ * ndjson 模式下：所有业务级 log（info / warn / success / error）静默。
+ *   - info/warn/success 本就无关紧要，静默避免污染 stdout 结构化流
+ *   - error 也静默（bug#5 修）：业务错误必须通过 emitter.end(false, code, { error: msg }) 承载，
+ *     与 design 契约对齐（stderr 仅给真正的崩溃栈，由 registerExitHandlers 的 uncaughtException 打印）
+ *
+ * 调用方注意：ndjson 模式下调 error(msg) 不会让用户看见消息，务必把 msg 塞进 emitter.end 的 fields。
+ */
 export declare function info(msg: string): void;
 export declare function warn(msg: string): void;
 export declare function error(msg: string): void;

package/dist/utils/logger.js

@@ -1,5 +1,32 @@
-export function info(msg) { console.log(`[okclaw] ${msg}`); }
-export function warn(msg) { console.log(`[okclaw] WARN: ${msg}`); }
-export function error(msg) { console.error(`[okclaw] ERROR: ${msg}`); }
-export function success(msg) { console.log(`[okclaw] ✓ ${msg}`); }
+import { isNdjson } from '../output/mode.js';
+/**
+ * 人类可读 log。
+ *
+ * ndjson 模式下：所有业务级 log（info / warn / success / error）静默。
+ *   - info/warn/success 本就无关紧要，静默避免污染 stdout 结构化流
+ *   - error 也静默（bug#5 修）：业务错误必须通过 emitter.end(false, code, { error: msg }) 承载，
+ *     与 design 契约对齐（stderr 仅给真正的崩溃栈，由 registerExitHandlers 的 uncaughtException 打印）
+ *
+ * 调用方注意：ndjson 模式下调 error(msg) 不会让用户看见消息，务必把 msg 塞进 emitter.end 的 fields。
+ */
+export function info(msg) {
+    if (isNdjson())
+        return;
+    console.log(`[okclaw] ${msg}`);
+}
+export function warn(msg) {
+    if (isNdjson())
+        return;
+    console.log(`[okclaw] WARN: ${msg}`);
+}
+export function error(msg) {
+    if (isNdjson())
+        return;
+    console.error(`[okclaw] ERROR: ${msg}`);
+}
+export function success(msg) {
+    if (isNdjson())
+        return;
+    console.log(`[okclaw] ✓ ${msg}`);
+}
 //# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,IAAI,CAAC,GAAW,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACrE,MAAM,UAAU,IAAI,CAAC,GAAW,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3E,MAAM,UAAU,KAAK,CAAC,GAAW,IAAI,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/E,MAAM,UAAU,OAAO,CAAC,GAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;;;;;;;GASG;AAEH,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,IAAI,QAAQ,EAAE;QAAE,OAAO;IACvB,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,IAAI,QAAQ,EAAE;QAAE,OAAO;IACvB,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,IAAI,QAAQ,EAAE;QAAE,OAAO;IACvB,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,QAAQ,EAAE;QAAE,OAAO;IACvB,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/utils/mirror.js

@@ -4,6 +4,13 @@ import { NPM_REGISTRY, PIP_INDEX_URL, PIP_TRUSTED_HOST } from './constants.js';
 export async function configureMirrors() {
     info('Configuring China mirrors...');
     await shell(`npm config set registry ${NPM_REGISTRY}`).catch(() => { });
+    // 部分 npm 包（如 openclaw 依赖的 libsignal-node）用 git+ssh://git@github.com/...
+    // 引用 GitHub 仓库。云主机 root 账户默认没有 GitHub SSH key 会拉取失败。
+    // 这里把 ssh://git@github.com/ 和 git@github.com: 都重写成 https://github.com/（匿名可读）。
+    // 注意: 同一个 URL name 下要写多个 insteadOf 必须用 --add，否则第二次 set 会覆盖第一次。
+    await shell(`git config --global --unset-all url."https://github.com/".insteadOf 2>/dev/null || true`).catch(() => { });
+    await shell(`git config --global --add url."https://github.com/".insteadOf ssh://git@github.com/`).catch(() => { });
+    await shell(`git config --global --add url."https://github.com/".insteadOf git@github.com:`).catch(() => { });
     // Use /root/.pip — not ~/
     await shell(`mkdir -p /root/.pip && cat > /root/.pip/pip.conf << 'EOF'
 [global]

package/dist/utils/mirror.js.map

@@ -1 +1 @@
-{"version":3,"file":"mirror.js","sourceRoot":"","sources":["../../src/utils/mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAErC,MAAM,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEvE,0BAA0B;IAC1B,MAAM,KAAK,CAAC;;cAEA,aAAa;iBACV,gBAAgB;IAC7B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEpB,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"mirror.js","sourceRoot":"","sources":["../../src/utils/mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAErC,MAAM,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEvE,wEAAwE;IACxE,qDAAqD;IACrD,8EAA8E;IAC9E,+DAA+D;IAC/D,MAAM,KAAK,CACT,yFAAyF,CAC1F,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClB,MAAM,KAAK,CACT,qFAAqF,CACtF,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClB,MAAM,KAAK,CACT,+EAA+E,CAChF,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAElB,0BAA0B;IAC1B,MAAM,KAAK,CAAC;;cAEA,aAAa;iBACV,gBAAgB;IAC7B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEpB,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAC9B,CAAC"}

package/dist/utils/openclaw-config-cli.d.ts

@@ -0,0 +1,19 @@
+export declare class OpenclawConfigCliError extends Error {
+    readonly cmd: string;
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    constructor(cmd: string, exitCode: number, stdout: string, stderr: string);
+}
+export interface CliRunner {
+    run(args: string[]): {
+        exitCode: number;
+        stdout: string;
+        stderr: string;
+    };
+}
+export declare const defaultCliRunner: CliRunner;
+export declare function configGet(path: string, runner?: CliRunner): unknown | undefined;
+export declare function configSet(path: string, valueJson: string, runner?: CliRunner): void;
+export declare function configUnset(path: string, runner?: CliRunner): void;
+export declare function configValidate(runner?: CliRunner): boolean;

package/dist/utils/openclaw-config-cli.js

@@ -0,0 +1,81 @@
+import { execFileSync } from 'node:child_process';
+export class OpenclawConfigCliError extends Error {
+    cmd;
+    exitCode;
+    stdout;
+    stderr;
+    constructor(cmd, exitCode, stdout, stderr) {
+        super(`openclaw ${cmd} failed (exit ${exitCode}): ${stderr || stdout}`);
+        this.cmd = cmd;
+        this.exitCode = exitCode;
+        this.stdout = stdout;
+        this.stderr = stderr;
+    }
+}
+function stringifyOutput(value) {
+    if (typeof value === 'string')
+        return value;
+    if (Buffer.isBuffer(value))
+        return value.toString('utf8');
+    return '';
+}
+export const defaultCliRunner = {
+    run(args) {
+        try {
+            const stdout = execFileSync('openclaw', args, {
+                encoding: 'utf8',
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            return { exitCode: 0, stdout, stderr: '' };
+        }
+        catch (err) {
+            const error = err;
+            return {
+                exitCode: typeof error.status === 'number' ? error.status : 127,
+                stdout: stringifyOutput(error.stdout),
+                stderr: stringifyOutput(error.stderr || error.message),
+            };
+        }
+    },
+};
+function runOrThrow(args, runner = defaultCliRunner) {
+    const result = runner.run(args);
+    if (result.exitCode !== 0) {
+        throw new OpenclawConfigCliError(args.join(' '), result.exitCode, result.stdout, result.stderr);
+    }
+    return result;
+}
+function isNotFoundOutput(output) {
+    return /Config\s+path\s+not\s+found/i.test(output);
+}
+export function configGet(path, runner = defaultCliRunner) {
+    const args = ['config', 'get', path];
+    const result = runner.run(args);
+    if (result.exitCode !== 0) {
+        if (isNotFoundOutput(`${result.stderr}\n${result.stdout}`))
+            return undefined;
+        throw new OpenclawConfigCliError(args.join(' '), result.exitCode, result.stdout, result.stderr);
+    }
+    const stdout = result.stdout.trim();
+    if (!stdout)
+        return undefined;
+    try {
+        return JSON.parse(stdout);
+    }
+    catch {
+        // openclaw config get prints scalar string values as raw text without JSON
+        // quoting (e.g. `openviking` rather than `"openviking"`). number / bool / null
+        // are valid JSON literals so they parse above; only unquoted strings reach here.
+        return stdout;
+    }
+}
+export function configSet(path, valueJson, runner = defaultCliRunner) {
+    runOrThrow(['config', 'set', path, valueJson, '--strict-json'], runner);
+}
+export function configUnset(path, runner = defaultCliRunner) {
+    runOrThrow(['config', 'unset', path], runner);
+}
+export function configValidate(runner = defaultCliRunner) {
+    return runner.run(['config', 'validate']).exitCode === 0;
+}
+//# sourceMappingURL=openclaw-config-cli.js.map

package/dist/utils/openclaw-config-cli.js.map

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

package/dist/utils/shell.d.ts

@@ -8,8 +8,18 @@ export interface ShellResult {
  */
 export declare function ensureRoot(): void;
 /**
- * Run a shell command with inherited stdio (visible output).
- * Automatically sources nvm so node/npm/openclaw are available.
+ * Run a shell command and wait for exit.
+ *
+ * text 模式：stdio:inherit，子进程输出直通父进程 TTY（本地交互体验不变）。
+ *
+ * ndjson 模式：捕获 stdout/stderr 并按行合成 phase="log" 事件（stdout→level=info，
+ *   stderr→level=warn），通过 {@link getActiveEmitter} 拿到当前 op 的 emitter 发出。
+ *   这样像 `npm install` 这种几分钟才回一行 ndjson 的长操作，其实时进度也能通过
+ *   事件流推给 os-api / 前端，用户不会看到 UI 卡死 10 分钟。
+ *
+ *   透传是"尽力而为"：emitter 缺失（理论上只有本地脚本直接 import shell() 且没走
+ *   正常 command 入口才会发生）时静默吞，不影响命令本身执行。
+ *
  * Throws on non-zero exit.
  */
 export declare function shell(cmd: string): Promise<void>;

package/dist/utils/shell.js

@@ -1,5 +1,7 @@
 import { spawn, execFileSync } from 'node:child_process';
 import { error as logError, info } from './logger.js';
+import { isNdjson } from '../output/mode.js';
+import { getActiveEmitter } from '../output/ndjson.js';
 /**
  * Ensure running as root. If not, re-exec with sudo and exit.
  */
@@ -23,16 +25,31 @@ export function ensureRoot() {
 // Prefix to source nvm before every shell command so node/npm are on PATH
 const NVM_INIT = 'export HOME=/root; export NVM_DIR=/root/.nvm; [ -s "$NVM_DIR/nvm.sh" ] && source "$NVM_DIR/nvm.sh"; ';
 /**
- * Run a shell command with inherited stdio (visible output).
- * Automatically sources nvm so node/npm/openclaw are available.
+ * Run a shell command and wait for exit.
+ *
+ * text 模式：stdio:inherit，子进程输出直通父进程 TTY（本地交互体验不变）。
+ *
+ * ndjson 模式：捕获 stdout/stderr 并按行合成 phase="log" 事件（stdout→level=info，
+ *   stderr→level=warn），通过 {@link getActiveEmitter} 拿到当前 op 的 emitter 发出。
+ *   这样像 `npm install` 这种几分钟才回一行 ndjson 的长操作，其实时进度也能通过
+ *   事件流推给 os-api / 前端，用户不会看到 UI 卡死 10 分钟。
+ *
+ *   透传是"尽力而为"：emitter 缺失（理论上只有本地脚本直接 import shell() 且没走
+ *   正常 command 入口才会发生）时静默吞，不影响命令本身执行。
+ *
  * Throws on non-zero exit.
  */
 export function shell(cmd) {
     return new Promise((resolve, reject) => {
+        const ndjson = isNdjson();
         const child = spawn('bash', ['-c', NVM_INIT + cmd], {
-            stdio: 'inherit',
+            stdio: ndjson ? ['ignore', 'pipe', 'pipe'] : 'inherit',
             env: { ...process.env, HOME: '/root' },
         });
+        if (ndjson) {
+            forwardStreamAsLogEvents(child, 'stdout', 'info');
+            forwardStreamAsLogEvents(child, 'stderr', 'warn');
+        }
         child.on('error', reject);
         child.on('close', (code) => {
             if (code === 0)
@@ -42,6 +59,52 @@ export function shell(cmd) {
         });
     });
 }
+/**
+ * 把子进程的一个输出流按换行切分，每行合成一条 phase="log" ndjson 事件。
+ *
+ * 实现细节：
+ *   - 跨 chunk 续行：`buf` 累积未看到 \n 的尾巴，下次 data 再拼
+ *   - 空行丢弃（避免 npm 输出里的空白行污染事件流）
+ *   - \r 尾字符剥掉（Windows / 终端控制字符常见）
+ *   - close 时 flush 尾 buf，防止最后一行没 \n 漏掉
+ *   - emitter 为空时整段 no-op，绝不抛异常——shell() 的主路径不能因日志透传失败而失败
+ */
+function forwardStreamAsLogEvents(child, streamName, level) {
+    const stream = child[streamName];
+    if (!stream)
+        return;
+    let buf = '';
+    stream.setEncoding('utf8');
+    stream.on('data', (chunk) => {
+        buf += chunk;
+        let idx = buf.indexOf('\n');
+        while (idx >= 0) {
+            emitLogLine(buf.slice(0, idx), level);
+            buf = buf.slice(idx + 1);
+            idx = buf.indexOf('\n');
+        }
+    });
+    stream.on('close', () => {
+        if (buf.length > 0) {
+            emitLogLine(buf, level);
+            buf = '';
+        }
+    });
+}
+function emitLogLine(line, level) {
+    const cleaned = line.endsWith('\r') ? line.slice(0, -1) : line;
+    if (cleaned.length === 0)
+        return;
+    const emitter = getActiveEmitter();
+    if (!emitter)
+        return;
+    try {
+        emitter.log(level, cleaned);
+    }
+    catch {
+        // log 事件透传失败不能影响命令本身执行；这里静默
+    }
+}
 /**
  * Run a shell command with retries.
  */