@okclaw-build/cli 1.0.0-beta.5 → 1.0.0-beta.52

package/dist/commands/migration.js

@@ -0,0 +1,205 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { ARCHIVE_MANIFEST_NAME, buildCreateEncryptedArchiveCommand, buildDecryptArchiveCommand, buildTarCommand, buildTarCreateArgs, buildTarExtractArgs, buildTarExtractManifestArgs, buildTarListArgs, validateTarEntries, } from '../migration/archive.js';
+import { buildMigrationManifest, existingManifestPaths, validateMigrationManifest, } from '../migration/manifest.js';
+import { assertAgeIdentityContent, assertAgeRecipientContent, assertAuthenticatedEncryptionAvailable, } from '../migration/crypto.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+import { error, info, success } from '../utils/logger.js';
+import { commandExists, shell, shellCapture } from '../utils/shell.js';
+export async function migrationCommand(args) {
+    const emitter = new NdjsonEmitter('migration');
+    registerExitHandlers(emitter);
+    let parsed;
+    try {
+        parsed = parseMigrationArgs(args);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_USAGE', { error: msg });
+        process.exit(1);
+        return;
+    }
+    emitter.start(`migration ${parsed.action}`, migrationFields('start', `migration ${parsed.action}`, {
+        taskId: parsed.taskId,
+        shrimpId: parsed.shrimpId,
+        sourceHostId: parsed.sourceHostId,
+        targetHostId: parsed.targetHostId,
+    }));
+    try {
+        switch (parsed.action) {
+            case 'export':
+                await exportRuntime(parsed, emitter);
+                break;
+            case 'restore':
+                await restoreRuntime(parsed, emitter);
+                break;
+            case 'verify':
+                verifyManifest(parsed, emitter);
+                break;
+        }
+        emitter.end(true, 0, undefined, { taskId: parsed.taskId, action: parsed.action });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_MIGRATION_FAILED', { error: msg, taskId: parsed.taskId, action: parsed.action });
+        process.exit(1);
+    }
+}
+async function exportRuntime(args, emitter) {
+    if (!args.out || !args.keyFile)
+        throw new Error('export requires --out and --key-file');
+    await assertRequiredTools(['tar']);
+    await assertAuthenticatedEncryptionAvailable();
+    assertAgeRecipientContent(readFileSync(args.keyFile, 'utf8'), args.keyFile);
+    const workDir = mkdtempSync(join(tmpdir(), 'okclaw-migration-export-'));
+    const tarPath = join(workDir, 'runtime.tar');
+    const manifestPath = join(workDir, ARCHIVE_MANIFEST_NAME);
+    try {
+        emitter.stepStart('manifest', 'building migration manifest', migrationFields('manifest', 'building migration manifest'));
+        const manifest = buildMigrationManifest(identityFromArgs(args));
+        writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+        emitter.stepDone('manifest', 'migration manifest built', migrationFields('manifest', 'migration manifest built', {
+            missingPaths: manifest.missingPaths,
+        }));
+        emitter.stepStart('archive', 'creating runtime tar archive', migrationFields('archive', 'creating runtime tar archive'));
+        await shell(buildTarCommand(buildTarCreateArgs({
+            tarPath,
+            manifestPath,
+            existingIncludePaths: existingManifestPaths(manifest),
+        })));
+        emitter.stepDone('archive', 'runtime tar archive created', migrationFields('archive', 'runtime tar archive created'));
+        mkdirSync(dirname(args.out), { recursive: true });
+        emitter.stepStart('encrypt', 'encrypting runtime archive with age', migrationFields('encrypt', 'encrypting runtime archive'));
+        await shell(buildCreateEncryptedArchiveCommand(args.keyFile, tarPath, args.out));
+        emitter.stepDone('encrypt', 'encrypted runtime archive created', migrationFields('encrypt', 'encrypted runtime archive created', {
+            sha256: sha256File(args.out),
+            archive: args.out,
+        }));
+        success(`Migration archive exported: ${args.out}`);
+    }
+    finally {
+        rmSync(workDir, { recursive: true, force: true });
+    }
+}
+async function restoreRuntime(args, emitter) {
+    if (!args.archive || !args.keyFile)
+        throw new Error('restore requires --archive and --key-file');
+    await assertRequiredTools(['tar']);
+    await assertAuthenticatedEncryptionAvailable();
+    if (!existsSync(args.archive))
+        throw new Error(`Archive not found: ${args.archive}`);
+    assertAgeIdentityContent(readFileSync(args.keyFile, 'utf8'), args.keyFile);
+    const workDir = mkdtempSync(join(tmpdir(), 'okclaw-migration-restore-'));
+    const tarPath = join(workDir, 'runtime.tar');
+    try {
+        emitter.stepStart('decrypt', 'decrypting runtime archive with age', migrationFields('decrypt', 'decrypting runtime archive'));
+        await shell(buildDecryptArchiveCommand(args.keyFile, args.archive, tarPath));
+        emitter.stepDone('decrypt', 'runtime archive decrypted', migrationFields('decrypt', 'runtime archive decrypted'));
+        emitter.stepStart('manifest', 'validating migration manifest', migrationFields('manifest', 'validating migration manifest'));
+        await shell(buildTarCommand(buildTarExtractManifestArgs(tarPath, workDir)));
+        const manifest = validateMigrationManifest(JSON.parse(readFileSync(join(workDir, ARCHIVE_MANIFEST_NAME), 'utf8')), identityFromArgs(args));
+        emitter.stepDone('manifest', 'migration manifest validated', migrationFields('manifest', 'migration manifest validated'));
+        emitter.stepStart('archive-safety', 'validating archive entry paths', migrationFields('archive-safety', 'validating archive entry paths'));
+        const listing = await shellCapture(buildTarCommand(buildTarListArgs(tarPath)));
+        if (listing.code !== 0)
+            throw new Error(`Unable to list migration archive: ${listing.stderr}`);
+        validateTarEntries(listing.stdout.split(/\r?\n/), existingManifestPaths(manifest));
+        emitter.stepDone('archive-safety', 'archive entries validated', migrationFields('archive-safety', 'archive entries validated'));
+        emitter.stepStart('restore', 'restoring runtime files', migrationFields('restore', 'restoring runtime files'));
+        await shell(buildTarCommand(buildTarExtractArgs(tarPath)));
+        emitter.stepDone('restore', 'runtime files restored', migrationFields('restore', 'runtime files restored'));
+        success(`Migration archive restored: ${args.archive}`);
+    }
+    finally {
+        rmSync(workDir, { recursive: true, force: true });
+    }
+}
+function verifyManifest(args, emitter) {
+    if (!args.manifest)
+        throw new Error('verify requires --manifest');
+    emitter.stepStart('verify', 'validating migration manifest', migrationFields('verify', 'validating migration manifest'));
+    const manifest = validateMigrationManifest(JSON.parse(readFileSync(args.manifest, 'utf8')), identityFromArgs(args));
+    emitter.stepDone('verify', 'migration manifest valid', migrationFields('verify', 'migration manifest valid', {
+        missingPaths: manifest.missingPaths,
+    }));
+    info('Migration manifest is valid.');
+}
+function parseMigrationArgs(args) {
+    const action = args[0];
+    if (action !== 'export' && action !== 'restore' && action !== 'verify') {
+        throw new Error('Usage: okclaw migration <export|restore|verify> --task-id <id> --shrimp-id <id> --source-host-id <id> --target-host-id <id>');
+    }
+    const flags = parseFlags(args.slice(1));
+    const parsed = {
+        action,
+        taskId: requireFlag(flags, 'task-id'),
+        shrimpId: requireFlag(flags, 'shrimp-id'),
+        sourceHostId: requireFlag(flags, 'source-host-id'),
+        targetHostId: requireFlag(flags, 'target-host-id'),
+        out: flags.get('out'),
+        archive: flags.get('archive'),
+        keyFile: flags.get('key-file'),
+        manifest: flags.get('manifest'),
+    };
+    if (action === 'export' && (!parsed.out || !parsed.keyFile)) {
+        throw new Error('Usage: okclaw migration export --task-id <id> --shrimp-id <id> --source-host-id <id> --target-host-id <id> --out <archive> --key-file <key>');
+    }
+    if (action === 'restore' && (!parsed.archive || !parsed.keyFile)) {
+        throw new Error('Usage: okclaw migration restore --task-id <id> --shrimp-id <id> --source-host-id <id> --target-host-id <id> --archive <archive> --key-file <key>');
+    }
+    if (action === 'verify' && !parsed.manifest) {
+        throw new Error('Usage: okclaw migration verify --task-id <id> --shrimp-id <id> --source-host-id <id> --target-host-id <id> --manifest <manifest>');
+    }
+    return parsed;
+}
+function parseFlags(args) {
+    const flags = new Map();
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg.startsWith('--'))
+            throw new Error(`Unexpected argument: ${arg}`);
+        const withoutPrefix = arg.slice(2);
+        const eq = withoutPrefix.indexOf('=');
+        if (eq >= 0) {
+            flags.set(withoutPrefix.slice(0, eq), withoutPrefix.slice(eq + 1));
+            continue;
+        }
+        const value = args[++i];
+        if (!value || value.startsWith('--'))
+            throw new Error(`Missing value for --${withoutPrefix}`);
+        flags.set(withoutPrefix, value);
+    }
+    return flags;
+}
+function requireFlag(flags, name) {
+    const value = flags.get(name);
+    if (!value)
+        throw new Error(`--${name} is required`);
+    return value;
+}
+function identityFromArgs(args) {
+    return {
+        taskId: args.taskId,
+        shrimpId: args.shrimpId,
+        sourceHostId: args.sourceHostId,
+        targetHostId: args.targetHostId,
+    };
+}
+async function assertRequiredTools(commands) {
+    for (const command of commands) {
+        if (!await commandExists(command)) {
+            throw new Error(`Missing required command: ${command}`);
+        }
+    }
+}
+function migrationFields(phase, message, data = {}) {
+    return { phase, message, data };
+}
+function sha256File(path) {
+    return createHash('sha256').update(readFileSync(path)).digest('hex');
+}
+//# sourceMappingURL=migration.js.map

package/dist/commands/migration.js.map

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

package/dist/commands/restore.d.ts

@@ -0,0 +1,16 @@
+import { restoreOpenclawUserDataArchive } from '../openclaw-user-data.js';
+type RestoreEvent = {
+    ok: boolean;
+    code: string;
+    message: string;
+    stagingDir?: string;
+    archivePath?: string;
+    restoredFiles?: string[];
+    error?: string;
+};
+export type RestoreCommandDeps = {
+    restoreArchive?: typeof restoreOpenclawUserDataArchive;
+    emit?: (event: RestoreEvent) => void;
+};
+export declare function restoreCommand(args: string[], deps?: RestoreCommandDeps): Promise<void>;
+export {};

package/dist/commands/restore.js

@@ -0,0 +1,75 @@
+import { error, info } from '../utils/logger.js';
+import { restoreOpenclawUserDataArchive } from '../openclaw-user-data.js';
+export async function restoreCommand(args, deps = {}) {
+    const parsed = parseRestoreArgs(args);
+    const emit = deps.emit ?? defaultEmit;
+    const restoreArchive = deps.restoreArchive ?? restoreOpenclawUserDataArchive;
+    if (parsed.target !== 'openclaw-user-data' || !parsed.archivePath) {
+        error('Usage: okclaw restore openclaw-user-data --archive <path> [--include-workspace-extra] [--output=ndjson]');
+        process.exit(1);
+    }
+    try {
+        const result = await restoreArchive({
+            archivePath: parsed.archivePath,
+            includeWorkspaceExtra: parsed.includeWorkspaceExtra,
+        });
+        emit({
+            ok: true,
+            code: 'OK',
+            message: 'openclaw user data restored',
+            stagingDir: result.stagingDir,
+            archivePath: result.archivePath,
+            restoredFiles: result.restoredFiles,
+        });
+        if (!parsed.ndjson) {
+            info(`Restored openclaw user data from ${result.archivePath}`);
+        }
+    }
+    catch (e) {
+        const err = e;
+        emit({
+            ok: false,
+            code: 'E_RESTORE_FAILED',
+            message: 'openclaw user data restore failed',
+            stagingDir: err.stagingDir,
+            archivePath: err.archivePath ?? parsed.archivePath,
+            error: err.message,
+        });
+        throw e;
+    }
+}
+function parseRestoreArgs(args) {
+    let target;
+    let archivePath;
+    let includeWorkspaceExtra = false;
+    let ndjson = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!target && !arg.startsWith('--')) {
+            target = arg;
+            continue;
+        }
+        if (arg === '--archive' && args[i + 1]) {
+            archivePath = args[++i];
+            continue;
+        }
+        if (arg.startsWith('--archive=')) {
+            archivePath = arg.slice('--archive='.length);
+            continue;
+        }
+        if (arg === '--include-workspace-extra') {
+            includeWorkspaceExtra = true;
+            continue;
+        }
+        if (arg === '--output=ndjson' || (arg === '--output' && args[i + 1] === 'ndjson')) {
+            ndjson = true;
+            if (arg === '--output')
+                i += 1;
+        }
+    }
+    return { target, archivePath, includeWorkspaceExtra, ndjson };
+}
+function defaultEmit(event) {
+    process.stdout.write(JSON.stringify(event) + '\n');
+}
+//# sourceMappingURL=restore.js.map

package/dist/commands/restore.js.map

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

package/dist/commands/service.js

@@ -1,23 +1,66 @@
-import { shell, shellCapture } from '../utils/shell.js';
 import { info, success } from '../utils/logger.js';
-import { OPENVIKING_ENV } from '../utils/constants.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+import { isNdjson } from '../output/mode.js';
+import { OPENCLAW_GATEWAY_PORT } from '../utils/constants.js';
+import { startGateway, stopGateway, restartGateway, probeGatewayState } from '../utils/openclaw-daemon.js';
+async function runSimpleOp(op, step, humanVerb, action) {
+    const emitter = new NdjsonEmitter(op);
+    registerExitHandlers(emitter);
+    emitter.start(`${humanVerb} gateway`);
+    info(`${humanVerb} openclaw gateway...`);
+    try {
+        emitter.stepStart(step, `${humanVerb} gateway`);
+        await action();
+        emitter.stepDone(step, 'done');
+        success(`Gateway ${step}ed.`);
+        emitter.end(true, 0);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        emitter.end(false, 1, `E_${op.toUpperCase()}_FAILED`, { error: msg });
+        throw e;
+    }
+}
 export async function startCommand() {
-    info('Starting openclaw gateway...');
-    await shell(`source ${OPENVIKING_ENV} 2>/dev/null || true; openclaw gateway start`);
-    success('Gateway started.');
+    await runSimpleOp('start', 'start', 'Starting', startGateway);
 }
 export async function stopCommand() {
-    info('Stopping openclaw gateway...');
-    await shell('openclaw gateway stop 2>/dev/null || true');
-    success('Gateway stopped.');
+    await runSimpleOp('stop', 'stop', 'Stopping', stopGateway);
 }
 export async function restartCommand() {
-    info('Restarting openclaw gateway...');
-    await shell(`source ${OPENVIKING_ENV} 2>/dev/null || true; openclaw gateway restart`);
-    success('Gateway restarted.');
+    await runSimpleOp('restart', 'restart', 'Restarting', restartGateway);
 }
 export async function statusCommand() {
-    const result = await shellCapture('openclaw gateway status 2>&1 || true');
-    console.log(result.stdout || result.stderr || 'No output');
+    const emitter = new NdjsonEmitter('status');
+    registerExitHandlers(emitter);
+    emitter.start('querying gateway status');
+    emitter.stepStart('status', 'checking openclaw gateway process');
+    try {
+        // 健康判定以 18789 端口监听为准 —— systemd 服务 active ≠ 端口已对外服务。
+        // probeGatewayState 内含启动窗口的 bounded wait。
+        const state = await probeGatewayState();
+        const running = state === 'listening';
+        const output = state === 'listening'
+            ? `Gateway listening on port ${OPENCLAW_GATEWAY_PORT}`
+            : state === 'starting'
+                ? `Gateway service active but not listening on port ${OPENCLAW_GATEWAY_PORT} (starting/degraded)`
+                : `No gateway process found on port ${OPENCLAW_GATEWAY_PORT}`;
+        if (!isNdjson()) {
+            console.log(output);
+        }
+        emitter.stepDone('status', 'status query done');
+        emitter.end(running, running ? 0 : 1, running ? undefined : state === 'starting' ? 'E_STATUS_DEGRADED' : 'E_STATUS_NOT_RUNNING', { running, state, rawOutput: output });
+        // gateway 没真正对外监听时进程退出码也必须非 0 —— os-api 的 bootstrap
+        // 「Step 6」和迁移「target:status」都靠 shell 退出码做校验门
+        // (`okclaw status || 失败`),只写 ndjson、进程仍 exit 0 会让校验形同虚设。
+        if (!running) {
+            process.exit(1);
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        emitter.end(false, 1, 'E_STATUS_FAILED', { error: msg });
+        throw e;
+    }
 }
 //# sourceMappingURL=service.js.map

package/dist/commands/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/commands/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACrC,MAAM,KAAK,CAAC,UAAU,cAAc,8CAA8C,CAAC,CAAC;IACpF,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACrC,MAAM,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACvC,MAAM,KAAK,CAAC,UAAU,cAAc,gDAAgD,CAAC,CAAC;IACtF,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,sCAAsC,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/commands/service.ts"],"names":[],"mappings":"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"}

package/dist/commands/show.d.ts

@@ -0,0 +1,13 @@
+/**
+ * okclaw show <target...>
+ *
+ * 把 target 对应的文件内容原样输出到 stdout（text 模式）；
+ * 在 ndjson 模式下，文件内容放到 end 事件的 fields.content（plan 决策 #16）。
+ *
+ *   - 文件存在 → 输出文件内容，exit 0
+ *   - 文件不存在 → 输出空内容，exit 0（视为尚未创建）
+ *   - target 非法 → stderr 提示，exit 1
+ *
+ * `targets` 参数用于测试注入；生产调用不传第二个参数，使用 edit.ts 导出的 TARGETS。
+ */
+export declare function showCommand(args: string[], targets?: Record<string, string>): Promise<void>;

package/dist/commands/show.js

@@ -0,0 +1,70 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { error } from '../utils/logger.js';
+import { TARGETS as DEFAULT_TARGETS } from './edit.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+import { isNdjson } from '../output/mode.js';
+/**
+ * okclaw show <target...>
+ *
+ * 把 target 对应的文件内容原样输出到 stdout（text 模式）；
+ * 在 ndjson 模式下，文件内容放到 end 事件的 fields.content（plan 决策 #16）。
+ *
+ *   - 文件存在 → 输出文件内容，exit 0
+ *   - 文件不存在 → 输出空内容，exit 0（视为尚未创建）
+ *   - target 非法 → stderr 提示，exit 1
+ *
+ * `targets` 参数用于测试注入；生产调用不传第二个参数，使用 edit.ts 导出的 TARGETS。
+ */
+export async function showCommand(args, targets = DEFAULT_TARGETS) {
+    const emitter = new NdjsonEmitter('file_read');
+    registerExitHandlers(emitter);
+    const requestedTargets = args.filter((arg) => !arg.startsWith('--'));
+    if (requestedTargets.length === 0 || requestedTargets.some((target) => !targets[target])) {
+        error(`Usage: okclaw show <${Object.keys(targets).join('|')}>`);
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    if (!isNdjson() && requestedTargets.length > 1) {
+        error('Multiple targets are only supported with --output=ndjson');
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    emitter.start(`reading ${requestedTargets.join(',')}`, { targets: requestedTargets });
+    try {
+        const files = [];
+        for (const target of requestedTargets) {
+            const path = targets[target];
+            emitter.stepStart(`read:${target}`, `reading ${path}`, { target, path });
+            const exists = existsSync(path);
+            const content = exists ? readFileSync(path, 'utf8') : '';
+            files.push({ fileKey: target, path, exists, content });
+            emitter.stepDone(`read:${target}`, exists ? 'read ok' : 'file not found, returning empty');
+        }
+        if (!isNdjson()) {
+            const { exists, content } = files[0];
+            if (exists) {
+                process.stdout.write(content);
+            }
+        }
+        // 单文件保持 content 兼容；批量读取用 files 数组承载返回值。
+        if (requestedTargets.length === 1) {
+            const file = files[0];
+            emitter.end(true, 0, undefined, {
+                target: file.fileKey,
+                path: file.path,
+                exists: file.exists,
+                content: file.content,
+            });
+        }
+        else {
+            emitter.end(true, 0, undefined, { files });
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_READ_FAILED', { error: msg });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/show.js.map

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

package/dist/commands/skill.d.ts

@@ -0,0 +1 @@
+export declare function skillCommand(args: string[]): Promise<void>;

package/dist/commands/skill.js

@@ -0,0 +1,137 @@
+import { readFileSync } from 'node:fs';
+import { SkillInstaller } from '../installers/skill.js';
+import { configureMirrors } from '../utils/mirror.js';
+import { info, error, success } from '../utils/logger.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+import { assertSafeInstallName, assertSafePackageVersion, parsePackageSource, } from '../utils/install-safety.js';
+export async function skillCommand(args) {
+    const subCommand = args[0];
+    const skillName = args[1];
+    if (!subCommand || !['install', 'uninstall'].includes(subCommand)) {
+        const emitter = new NdjsonEmitter('skill_install');
+        registerExitHandlers(emitter);
+        error('Usage: okclaw skill <install|uninstall> <name> [options]');
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    const op = subCommand === 'install' ? 'skill_install' : 'skill_uninstall';
+    const emitter = new NdjsonEmitter(op);
+    registerExitHandlers(emitter);
+    if (!skillName) {
+        error(`Usage: okclaw skill ${subCommand} <name>${subCommand === 'install' ? ' --version <ver> [--package-url <url>]' : ''}`);
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    let safeSkillName;
+    try {
+        safeSkillName = assertSafeInstallName('skill', skillName);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_INVALID_ARGS', { error: msg });
+        process.exit(1);
+    }
+    const installer = new SkillInstaller(safeSkillName);
+    if (subCommand === 'uninstall') {
+        emitter.start(`uninstalling skill ${safeSkillName}`, { skillName: safeSkillName });
+        info(`Uninstalling skill ${safeSkillName}...`);
+        try {
+            emitter.stepStart('validate', `validating skill name ${safeSkillName}`);
+            // installer 内部校验名称，SkillInstaller.uninstall 会在目标不存在时快速返回
+            emitter.stepDone('validate', 'skill name ok');
+            emitter.stepStart('uninstall', `removing ${safeSkillName}`);
+            await installer.uninstall();
+            emitter.stepDone('uninstall', 'skill removed');
+            success(`Skill ${safeSkillName} uninstalled.`);
+            emitter.end(true, 0, undefined, { skillName: safeSkillName });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            error(msg);
+            emitter.end(false, 1, 'E_SKILL_UNINSTALL_FAILED', { error: msg });
+            process.exit(1);
+        }
+        return;
+    }
+    // install
+    let version = '';
+    let config;
+    let packageUrl;
+    for (let i = 2; i < args.length; i++) {
+        const arg = args[i];
+        if ((arg === '--version' || arg.startsWith('--version=')) && !version) {
+            version = arg.includes('=') ? arg.split('=')[1] : args[++i];
+            continue;
+        }
+        if (arg === '--config' && args[i + 1]) {
+            try {
+                config = JSON.parse(args[++i]);
+            }
+            catch {
+                error('Invalid --config JSON');
+                emitter.end(false, 1, 'E_CONFIG_JSON');
+                process.exit(1);
+            }
+            continue;
+        }
+        if ((arg === '--config-file' || arg.startsWith('--config-file=')) && !config) {
+            const filePath = arg.includes('=') ? arg.split('=')[1] : args[++i];
+            try {
+                config = JSON.parse(readFileSync(filePath, 'utf8'));
+            }
+            catch (e) {
+                error(`Failed to read config file: ${e}`);
+                emitter.end(false, 1, 'E_CONFIG_FILE');
+                process.exit(1);
+            }
+            continue;
+        }
+        if ((arg === '--package-url' || arg.startsWith('--package-url=')) && !packageUrl) {
+            packageUrl = arg.includes('=') ? arg.split('=')[1] : args[++i];
+            continue;
+        }
+    }
+    if (!version) {
+        error('--version is required for install');
+        emitter.end(false, 1, 'E_VERSION_REQUIRED');
+        process.exit(1);
+    }
+    let safeVersion;
+    let packageSource;
+    try {
+        safeVersion = assertSafePackageVersion(version);
+        packageSource = packageUrl ? parsePackageSource(packageUrl) : undefined;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_INVALID_ARGS', { error: msg });
+        process.exit(1);
+    }
+    emitter.start(`installing skill ${safeSkillName}@${safeVersion}`, { skillName: safeSkillName, version: safeVersion });
+    info(`Installing skill ${safeSkillName}@${safeVersion}...`);
+    try {
+        emitter.stepStart('validate', 'validating install args');
+        await installer.checkDeps();
+        emitter.stepDone('validate', 'args ok, deps ready');
+        emitter.stepStart('download', `downloading skill ${safeSkillName}@${safeVersion}`);
+        await configureMirrors();
+        await installer.install(safeVersion, packageSource);
+        emitter.stepDone('download', 'skill downloaded');
+        emitter.stepStart('install', `applying skill ${safeSkillName}`);
+        if (config) {
+            await installer.configure(config);
+        }
+        emitter.stepDone('install', 'skill installed');
+        success(`Skill ${safeSkillName}@${safeVersion} installed.`);
+        emitter.end(true, 0, undefined, { skillName: safeSkillName, version: safeVersion });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_SKILL_INSTALL_FAILED', { error: msg });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=skill.js.map