@playcraft/cli 0.1.53-beta → 0.1.54

package/dist/auth/account-activation.js

@@ -1,157 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { loadGlobalConfig } from '../config.js';
-import { accountActivationMessage } from './messages.js';
-export const ACCOUNT_PENDING_ACTIVATION = 'account_pending_activation';
-export class AccountActivationError extends Error {
-    code;
-    status;
-    retryable = false;
-    constructor(code, message, status) {
-        super(message);
-        this.code = code;
-        this.status = status;
-        this.name = 'AccountActivationError';
-    }
-}
-export function responseErrorCode(payload) {
-    if (!payload || typeof payload !== 'object')
-        return undefined;
-    const { error, code } = payload;
-    return typeof error?.code === 'string' ? error.code : typeof code === 'string' ? code : undefined;
-}
-export function pendingAccountActivationError(status, payload) {
-    return status === 403 && responseErrorCode(payload) === ACCOUNT_PENDING_ACTIVATION
-        ? new AccountActivationError(ACCOUNT_PENDING_ACTIVATION, `${ACCOUNT_PENDING_ACTIVATION}: ${accountActivationMessage('pending')}`, status)
-        : undefined;
-}
-export function parseErrorPayload(text) {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return undefined;
-    }
-}
-function localActivationConfig() {
-    for (const path of [
-        join(process.cwd(), '.playcraft.json'),
-        '/project/.playcraft.json',
-        join(homedir(), '.playcraft.json'),
-    ]) {
-        if (!existsSync(path))
-            continue;
-        try {
-            const config = JSON.parse(readFileSync(path, 'utf8'));
-            if (config && typeof config === 'object' && !Array.isArray(config))
-                return config;
-        }
-        catch {
-            // Follow the existing local credential lookup when a file is unreadable.
-        }
-    }
-    return {};
-}
-function stringValue(value) {
-    return typeof value === 'string' && value ? value : undefined;
-}
-function activationBaseUrl(raw) {
-    try {
-        const url = new URL(raw);
-        if (!['http:', 'https:'].includes(url.protocol) ||
-            url.username ||
-            url.password ||
-            url.search ||
-            url.hash)
-            throw new Error();
-        url.pathname = url.pathname.replace(/\/+$/, '').replace(/\/api$/, '');
-        return url.toString().replace(/\/+$/, '');
-    }
-    catch {
-        throw new AccountActivationError('INVALID_ACTIVATION_TARGET', accountActivationMessage('invalidTarget'));
-    }
-}
-function savedTokenForTarget(config, rawUrl, target, environment) {
-    if (!rawUrl || (stringValue(config.env)?.trim() || '') !== environment)
-        return undefined;
-    try {
-        return activationBaseUrl(rawUrl) === target ? stringValue(config.token) : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function normalizedSavedUrl(raw) {
-    try {
-        return raw ? activationBaseUrl(raw) : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-export async function activateAccount(options, defaultBaseUrl) {
-    const local = localActivationConfig();
-    const global = loadGlobalConfig();
-    const localUrl = stringValue(local.apiUrl);
-    const globalUrl = stringValue(global.backendUrl) || stringValue(global.url);
-    const explicitUrl = options.url || process.env.PLAYCRAFT_API_URL || process.env.PLAYCRAFT_URL;
-    const target = activationBaseUrl(explicitUrl || localUrl || globalUrl || defaultBaseUrl);
-    const explicitToken = options.token || process.env.PLAYCRAFT_TOKEN || process.env.PLAYCRAFT_SANDBOX_TOKEN;
-    const savedUrls = [normalizedSavedUrl(localUrl), normalizedSavedUrl(globalUrl)].filter(Boolean);
-    const savedTokens = [stringValue(local.token), stringValue(global.token)].filter(Boolean);
-    const environmentsConflict = savedUrls.length === 2 &&
-        savedUrls[0] === savedUrls[1] &&
-        (stringValue(local.env)?.trim() || '') !== (stringValue(global.env)?.trim() || '');
-    const environmentTokensConflict = process.env.PLAYCRAFT_TOKEN &&
-        process.env.PLAYCRAFT_SANDBOX_TOKEN &&
-        process.env.PLAYCRAFT_TOKEN !== process.env.PLAYCRAFT_SANDBOX_TOKEN;
-    const environmentUrlsConflict = process.env.PLAYCRAFT_API_URL &&
-        process.env.PLAYCRAFT_URL &&
-        normalizedSavedUrl(process.env.PLAYCRAFT_API_URL) !==
-            normalizedSavedUrl(process.env.PLAYCRAFT_URL);
-    if ((!explicitUrl && new Set(savedUrls).size > 1) ||
-        (!explicitToken && new Set(savedTokens).size > 1) ||
-        (environmentsConflict && !process.env.PLAYCRAFT_ENV) ||
-        (environmentTokensConflict && !options.token) ||
-        (environmentUrlsConflict && !options.url)) {
-        throw new AccountActivationError('AMBIGUOUS_ACTIVATION_TARGET', accountActivationMessage('ambiguous'));
-    }
-    const environment = (process.env.PLAYCRAFT_ENV ||
-        (!explicitUrl ? (localUrl ? stringValue(local.env) : stringValue(global.env)) : '') ||
-        '').trim();
-    const token = explicitToken ||
-        savedTokenForTarget(local, localUrl, target, environment) ||
-        savedTokenForTarget(global, globalUrl, target, environment);
-    if (!token)
-        throw new AccountActivationError('AUTH_REQUIRED', accountActivationMessage('missingToken'));
-    if (!/^playcraft_pat_[A-Za-z0-9_-]{32}$/.test(token)) {
-        throw new AccountActivationError('INVALID_ACTIVATION_TOKEN', accountActivationMessage('invalidToken'));
-    }
-    let response;
-    try {
-        response = await fetch(`${target}/api/settings/personal-access-tokens/activate`, {
-            method: 'POST',
-            redirect: 'error',
-            signal: AbortSignal.timeout(30_000),
-            headers: {
-                Authorization: `Bearer ${token}`,
-                ...(environment ? { 'playcraft-env': environment } : {}),
-            },
-        });
-    }
-    catch {
-        throw new AccountActivationError('ACTIVATION_UNCONFIRMED', accountActivationMessage('unavailable'));
-    }
-    if (!response.ok) {
-        await response.body?.cancel().catch(() => { });
-        throw new AccountActivationError('ACTIVATION_FAILED', accountActivationMessage('failed'), response.status);
-    }
-    const result = await response.json().catch(() => undefined);
-    if (!result ||
-        typeof result !== 'object' ||
-        result.accountStatus !== 'active') {
-        throw new AccountActivationError('ACTIVATION_UNCONFIRMED', accountActivationMessage('unavailable'), response.status);
-    }
-    console.log(accountActivationMessage('success'));
-}

package/dist/auth/messages.js

@@ -1,30 +0,0 @@
-const messages = {
-    en: {
-        activateOption: 'Explicitly activate the account using the current personal access token',
-        tokenOption: 'Personal access token for --activate (or use PLAYCRAFT_TOKEN)',
-        pending: 'Account activation is required. Run `playcraft login --activate` with the same token and target environment, then rerun your command.',
-        success: 'Account activated. Rerun your original command to continue.',
-        missingToken: 'No personal access token matches this target environment. Provide PLAYCRAFT_TOKEN or log in to this environment first.',
-        invalidToken: 'Account activation requires a personal access token. A sandbox token cannot activate an account.',
-        ambiguous: 'Activation credentials or target environments conflict. Specify --url, PLAYCRAFT_ENV when needed, and an explicit personal access token using --token or PLAYCRAFT_TOKEN.',
-        invalidTarget: 'Use a web service base address (http:// or https://) without credentials, a query, or a fragment.',
-        failed: 'Account activation failed. Check the target environment and token before trying again.',
-        unavailable: 'Account activation could not be confirmed. Check your account status before explicitly trying again.',
-    },
-    zh: {
-        activateOption: '明确使用当前个人访问令牌激活账号',
-        tokenOption: '用于 --activate 的个人访问令牌（也可使用 PLAYCRAFT_TOKEN）',
-        pending: '账号需要激活。请使用同一令牌和目标环境主动运行 `playcraft login --activate`，然后重新执行原命令。',
-        success: '账号已激活，请重新执行原命令继续。',
-        missingToken: '没有与目标环境匹配的个人访问令牌。请提供 PLAYCRAFT_TOKEN，或先登录此环境。',
-        invalidToken: '激活账号需要个人访问令牌，沙箱令牌不能用于激活账号。',
-        ambiguous: '激活凭据或目标环境存在冲突。请明确指定 --url、所需的 PLAYCRAFT_ENV，并通过 --token 或 PLAYCRAFT_TOKEN 提供个人访问令牌。',
-        invalidTarget: '激活目标必须是网页服务基址（http:// 或 https://），不能包含凭据、查询参数或片段。',
-        failed: '账号激活失败，请检查目标环境和令牌后再尝试。',
-        unavailable: '无法确认账号是否已激活。请先检查账号状态，再主动决定是否重试。',
-    },
-};
-export function accountActivationMessage(key) {
-    const locale = process.env.PLAYCRAFT_LANGUAGE || process.env.LANG || 'en';
-    return messages[locale.startsWith('zh') ? 'zh' : 'en'][key];
-}

package/dist/commands/build-temp.js

@@ -1,26 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { mkdir, rm } from 'node:fs/promises';
-import path from 'node:path';
-export async function createBuildTempDirectory(projectPath) {
-    const parent = path.join(projectPath, '.playcraft-temp');
-    await mkdir(parent, { recursive: true });
-    const directory = path.join(parent, `base-build-${randomUUID()}`);
-    // mkdir 继承工程的共享组和权限掩码；mkdtemp 固定使用 0700。
-    await mkdir(directory);
-    return directory;
-}
-export async function cleanupBuildTempDirectory(directory) {
-    if (!directory)
-        return;
-    if (process.env.PLAYCRAFT_KEEP_BUILD_TEMP === '1') {
-        console.log(`构建临时目录保留在: ${directory}`);
-        return;
-    }
-    try {
-        // 只删除本次创建的目录，保留并发构建与用户输入；父目录不做递归清理。
-        await rm(directory, { recursive: true, force: true });
-    }
-    catch (error) {
-        console.warn(`清理构建临时目录失败: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}

package/dist/commands/platform-skills.generated.js

@@ -1,19 +0,0 @@
-// 此文件由 scripts/generate-platform-skills.mjs 生成，请勿手改。
-// 重新生成：pnpm --filter @playcraft/cli generate:platform-skills
-/** `@playcraft/skills/playcraft-skills/` 下的 Platform Skill 目录名。 */
-export const PLATFORM_SKILL_DIRS = [
-    'playcraft-3d-flip-sprite',
-    'playcraft-asset-management',
-    'playcraft-build',
-    'playcraft-code-editor',
-    'playcraft-create-remix',
-    'playcraft-deploy',
-    'playcraft-iteration-methodology',
-    'playcraft-platform-intro',
-    'playcraft-prefab',
-    'playcraft-project-management',
-    'playcraft-remix-workflow',
-    'playcraft-save',
-    'playcraft-template-upgrade-merge',
-    'sound-effects',
-];

package/dist/commands/playable.js

@@ -1,53 +0,0 @@
-import { recordPlayable } from '../recording/recorder.js';
-import { RecordingError, recordingMessage as t } from '../recording/messages.js';
-import { dirname, join } from 'node:path';
-import { captureGeneratedArtifact } from '../workspace-runtime/workspaces/artifact-receipts.js';
-export async function runPlayableRecord(options) {
-    const interrupted = new AbortController();
-    const deadline = new AbortController();
-    const onInterrupt = () => interrupted.abort(new DOMException('Interrupted', 'AbortError'));
-    process.once('SIGINT', onInterrupt);
-    let timer;
-    try {
-        const seconds = options.timeout === undefined ? 1200 : Number(options.timeout);
-        if (!Number.isFinite(seconds) || seconds <= 0 || seconds > 1800)
-            throw new RecordingError('invalidArguments', 64);
-        timer = setTimeout(() => deadline.abort(new DOMException('Timed out', 'TimeoutError')), seconds * 1000);
-        const result = await recordPlayable(options, AbortSignal.any([interrupted.signal, deadline.signal]));
-        const metadata = result.envelope.result;
-        const output = result.envelope.artifacts;
-        if (result.envelope.ok && metadata && output?.candidate) {
-            const artifacts = [metadata.candidate, ...metadata.controls];
-            const paths = [output.candidate, ...(output.controls ?? [])];
-            for (let index = 0; index < artifacts.length; index++) {
-                const artifact = artifacts[index], path = paths[index];
-                if (!path)
-                    continue;
-                const thumbnail = artifact.screenshots?.[0]?.path;
-                await captureGeneratedArtifact(path, 'playable record', {
-                    width: artifact.video.source.width, height: artifact.video.source.height,
-                    duration: artifact.video.source.durationMs / 1000,
-                    ...(thumbnail ? { thumbnailPath: join(dirname(output.metadata), thumbnail) } : {}),
-                });
-            }
-        }
-        process.stdout.write(`${JSON.stringify(result.envelope)}\n`);
-        process.exitCode = result.exitCode;
-    }
-    catch (error) {
-        const code = error instanceof RecordingError ? error.code : 'recordingFailed';
-        process.stdout.write(`${JSON.stringify({ schemaVersion: 'playcraft.video-cli.v1', command: 'playable record', state: 'failed', ok: false, error: { code, message: t(code) } })}\n`);
-        process.exitCode = error instanceof RecordingError ? error.exitCode : 4;
-    }
-    finally {
-        if (timer)
-            clearTimeout(timer);
-        process.removeListener('SIGINT', onInterrupt);
-    }
-}
-export function registerPlayableCommands(program) {
-    program.command('playable').description(t('topic')).command('record').description(t('record'))
-        .option('--url <url>', t('url')).option('--scenario <file>', t('scenario')).option('--out <directory>', t('out'))
-        .option('--browser-path <path>', t('browser')).option('--timeout <seconds>', t('timeout'))
-        .action(runPlayableRecord);
-}

package/dist/commands/preview-runtime.js

@@ -1,21 +0,0 @@
-import { initializePreviewRuntime } from '../preview-runtime/distribution.js';
-const messages = {
-    zh: { topic: '开发预览运行时', init: '复制随命令行工具分发的开发模块，不修改游戏入口', directory: '目标工程目录' },
-    en: { topic: 'Development preview runtime', init: 'Copy the distributed development runtime without changing game entries', directory: 'Engineering project directory' },
-};
-export function registerPreviewRuntimeCommands(program) {
-    const language = /^(zh|cn)/i.test(process.env.LC_ALL || process.env.LANG || '') ? 'zh' : 'en';
-    const text = messages[language];
-    program.command('preview-runtime').description(text.topic)
-        .command('init').description(text.init)
-        .option('--dir <path>', text.directory, process.cwd())
-        .action(async (options) => {
-        try {
-            console.log(JSON.stringify(await initializePreviewRuntime(options.dir)));
-        }
-        catch (error) {
-            console.error(JSON.stringify({ status: 'failed', code: error instanceof Error ? error.message : 'preview_runtime_init_failed' }));
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/commands/tools-batch.js

@@ -1,113 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { batchCreateSchema, batchPromptCreateSchema } from '@playcraft/common/cloud-workspace/runtime';
-import { AgentApiClient } from '../utils/agent-api-client.js';
-import { handleError } from './tools-utils.js';
-const messages = {
-    en: {
-        create: 'Create and automatically run independent Remix variants from one prompt',
-        input: 'Path to the batch draft JSON (JavaScript Object Notation, 数据交换格式) file',
-        status: 'Read a batch and its generation status',
-        id: 'Batch identifier',
-        created: 'Batch created',
-        prompt: 'The complete batch generation request', workspace: 'Source workspace identifier',
-        directory: 'Source engineering directory; defaults to basic', request: 'Stable batch creation identity for retries',
-        team: 'Team identifier for a standalone workspace', invalidMode: 'Provide either --prompt with --workspace-id or --input, exclusively.',
-        requestRequired: 'Prompt creation requires a stable --client-request-id; reuse it when retrying the same request.',
-        help: '\nUse --prompt with --workspace-id and a stable --client-request-id. The platform plans and generates independent Remix directories while preserving the source. An omitted count defaults to 3; maximum 10. --input also accepts existing structured drafts.\n',
-        confirmation: 'Generation is queued. Read the batch status to track its results.',
-        sync: 'Apply the latest source snapshot to an existing batch',
-        syncDone: 'Batch sync requested',
-    },
-    zh: {
-        create: '用一个 prompt 创建并自动生成独立 Remix 变体',
-        input: '批次草案 JSON (JavaScript Object Notation, 数据交换格式) 文件路径',
-        status: '查询批次及生成状态',
-        id: '批次标识',
-        created: '批次已创建',
-        prompt: '完整的批量生成需求', workspace: '来源 workspace 标识',
-        directory: '来源工程目录，默认 basic', request: '用于重试的稳定批次创建标识',
-        team: '独立工作区所属团队标识', invalidMode: '请选择 --prompt 配合 --workspace-id，或 --input，两种方式不能同时使用。',
-        requestRequired: '使用 prompt 创建时必须提供稳定的 --client-request-id，重试同一请求时复用该标识。',
-        help: '\n使用 --prompt、--workspace-id 和稳定的 --client-request-id。平台自动规划，在副本中生成独立 Remix，保持来源不变。未指定数量默认 3 个，最多 10 个。--input 也兼容现有结构化草案。\n',
-        confirmation: '生成已排队，可查询批次状态追踪各项成果。',
-        sync: '将来源最新快照同步到已有批次',
-        syncDone: '已请求同步到批次',
-    },
-};
-const language = () => /^zh/i.test(process.env.PLAYCRAFT_LANG ?? process.env.LANG ?? '') ? messages.zh : messages.en;
-const modelConfigIdPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-/** Model bound by the runtime to the conversation that is creating the batch. */
-export function sessionModelConfigId(env = process.env) {
-    const value = env.PLAYCRAFT_MODEL_CONFIG_ID?.trim();
-    return value && modelConfigIdPattern.test(value) ? value : undefined;
-}
-function bindSessionModel(body) {
-    const modelConfigId = sessionModelConfigId();
-    return modelConfigId ? { ...body, modelConfigId } : body;
-}
-export async function createBatchDraft(path, client = new AgentApiClient()) {
-    const draft = batchCreateSchema.parse(bindSessionModel(JSON.parse(await readFile(path, 'utf8'))));
-    return client.post('/create-batch', draft);
-}
-export async function createPromptBatch(input, client = new AgentApiClient()) {
-    return client.post('/create-batch', batchPromptCreateSchema.parse(bindSessionModel(input)));
-}
-export function registerBatchCommands(tools) {
-    const t = language();
-    tools.command('create-batch')
-        .description(t.create)
-        .option('--input <path>', t.input)
-        .option('--prompt <text>', t.prompt)
-        .option('--workspace-id <id>', t.workspace)
-        .option('--source-directory <name>', t.directory, 'basic')
-        .option('--client-request-id <id>', t.request)
-        .option('--team-id <id>', t.team)
-        .option('--json', 'JSON (JavaScript Object Notation, 数据交换格式)')
-        .addHelpText('after', t.help)
-        .action(async (opts) => {
-        try {
-            if (Boolean(opts.input) === Boolean(opts.prompt))
-                throw new Error(t.invalidMode);
-            if (opts.prompt && !opts.workspaceId)
-                throw new Error(t.invalidMode);
-            if (opts.prompt && !opts.clientRequestId)
-                throw new Error(t.requestRequired);
-            const result = opts.input ? await createBatchDraft(opts.input) : await createPromptBatch({
-                clientRequestId: opts.clientRequestId, prompt: opts.prompt,
-                sourceWorkspaceId: opts.workspaceId, sourceDirectoryName: opts.sourceDirectory,
-                ...(opts.teamId ? { teamId: opts.teamId } : {}),
-            });
-            console.log(opts.json ? JSON.stringify(result, null, 2) : `${t.created}: ${result.batchId}\n${t.confirmation}`);
-        }
-        catch (error) {
-            handleError(error);
-        }
-    });
-    tools.command('sync-batch')
-        .description(t.sync)
-        .requiredOption('--batch-id <id>', t.id)
-        .option('--json', 'JSON (JavaScript Object Notation, 数据交换格式)')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.post('/sync-batch', { batchId: opts.batchId });
-            console.log(opts.json ? JSON.stringify(result, null, 2) : t.syncDone);
-        }
-        catch (error) {
-            handleError(error);
-        }
-    });
-    tools.command('get-batch')
-        .description(t.status)
-        .requiredOption('--batch-id <id>', t.id)
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.get('/get-batch', { batchId: opts.batchId });
-            console.log(JSON.stringify(result, null, 2));
-        }
-        catch (error) {
-            handleError(error);
-        }
-    });
-}

package/dist/commands/video.js

@@ -1,122 +0,0 @@
-import { videoAnalysisRunSchema, videoModelCatalogSchema } from '@playcraft/common/agent-tools';
-import { AgentApiClient } from '../utils/agent-api-client.js';
-import { executeVideoUnderstanding, readVideoRun, requireVideoId, resolveVideoWorkspace, videoTimeout, } from '../video-replication/client.js';
-import { materializeVideoEvidence } from '../video-replication/evidence.js';
-import { probeVideo } from '../video-replication/media.js';
-import { VideoCliError, videoMessage as t } from '../video-replication/messages.js';
-import { comparisonMessage as c, ComparisonCliError } from '../video-replication/comparison-messages.js';
-import { describeVideoFailure, remoteVideoFailure } from '../video-replication/diagnostics.js';
-import { executeVideoComparison, readComparisonRun, comparisonRunResult } from '../video-replication/comparison.js';
-import { materializeComparisonEvidence } from '../video-replication/comparison-evidence.js';
-/** One final structured stdout record; progress and diagnostics stay on stderr. */
-export async function runVideoCliAction(command, options, action) {
-    const interrupt = new AbortController();
-    const onInterrupt = () => interrupt.abort(new DOMException('Interrupted', 'AbortError'));
-    process.once('SIGINT', onInterrupt);
-    let timer;
-    const deadline = new AbortController();
-    try {
-        timer = setTimeout(() => deadline.abort(new DOMException('Timed out', 'TimeoutError')), videoTimeout(options));
-        const result = await action(AbortSignal.any([interrupt.signal, deadline.signal]));
-        if (result.envelope.error)
-            process.stderr.write(`[video] ${result.envelope.error.message}\n`);
-        process.stdout.write(`${JSON.stringify(result.envelope)}\n`);
-        process.exitCode = result.exitCode;
-    }
-    catch (error) {
-        const known = error instanceof VideoCliError || error instanceof ComparisonCliError;
-        const key = known ? error.code : interrupt.signal.aborted ? 'interrupted' : deadline.signal.aborted ? 'timeoutReached' : 'failed';
-        const summary = error instanceof ComparisonCliError ? c(error.code) : error instanceof VideoCliError ? t(error.code)
-            : interrupt.signal.aborted ? t('interrupted') : deadline.signal.aborted ? t('timeoutReached') : command === 'video compare' ? c('comparisonFailed') : t('failed');
-        const envelope = {
-            schemaVersion: 'playcraft.video-cli.v1', command, state: interrupt.signal.aborted || deadline.signal.aborted ? 'uncertain' : 'failed', ok: false,
-            error: { code: key, ...describeVideoFailure(summary, error, command === 'video models' ? 'models' : command === 'video jobs get' ? 'poll' : command === 'video jobs cancel' ? 'cancel' : 'prepare') },
-        };
-        process.stderr.write(`[video] ${envelope.error.message}\n`);
-        process.stdout.write(`${JSON.stringify(envelope)}\n`);
-        process.exitCode = known ? error.exitCode : interrupt.signal.aborted ? 130 : deadline.signal.aborted ? 75 : 4;
-    }
-    finally {
-        if (timer)
-            clearTimeout(timer);
-        process.removeListener('SIGINT', onInterrupt);
-    }
-}
-function shared(command) {
-    return command.option('--workspace <id>', t('workspace')).option('--timeout <seconds>', t('timeout'));
-}
-export function registerVideoCommands(program) {
-    const video = program.command('video').description(t('topic'));
-    shared(video.command('models').description(t('models')))
-        .option('--json', t('json'))
-        .action((options) => runVideoCliAction('video models', options, async (signal) => {
-        const workspaceId = await resolveVideoWorkspace(options.workspace);
-        const catalog = videoModelCatalogSchema.parse(await new AgentApiClient().get('/video-models', { workspaceId }, { signal }));
-        return { exitCode: 0, envelope: { schemaVersion: 'playcraft.video-cli.v1', command: 'video models', state: 'completed', ok: true, result: catalog } };
-    }));
-    shared(video.command('understand').description(t('understand')))
-        .option('--video <path>', t('video')).option('--question <text>', t('question'))
-        .option('--context <path>', t('context')).option('--processing <mode>', t('processing'))
-        .option('--fps <number>', t('fps')).option('--clip <start:end>', t('clip'))
-        .option('--model-config <id>', t('model')).option('--out <directory>', t('out'))
-        .option('--resume <runId>', t('resume'))
-        .action((options) => runVideoCliAction('video understand', options, signal => executeVideoUnderstanding(options, signal, {
-        client: new AgentApiClient(), probe: probeVideo, materialize: materializeVideoEvidence,
-        progress: key => process.stderr.write(`[video] ${t(key)}\n`),
-    })));
-    shared(video.command('compare').description(c('compare')))
-        .option('--reference <path>', c('reference')).option('--analysis <path>', c('analysis'))
-        .option('--candidate <path>', c('candidate')).option('--recording <path>', c('recording'))
-        .option('--policy <path>', c('policy')).option('--processing <mode>', c('processing'))
-        .option('--fps <number>', t('fps')).option('--model-config <id>', t('model'))
-        .option('--out <directory>', t('out')).option('--resume <runId>', t('resume'))
-        .action((options) => runVideoCliAction('video compare', options, signal => executeVideoComparison(options, signal, {
-        client: new AgentApiClient(), probe: probeVideo, materialize: materializeComparisonEvidence,
-        progress: key => process.stderr.write(`[video] ${t(key)}\n`),
-    })));
-    const jobs = video.command('jobs').description(t('jobs'));
-    shared(jobs.command('get <runId>').description(t('get')))
-        .option('--kind <kind>', c('kind'))
-        .action((runId, options) => runVideoCliAction('video jobs get', options, async (signal) => {
-        const workspaceId = await resolveVideoWorkspace(options.workspace);
-        if (options.kind !== undefined && !['understanding', 'comparison'].includes(options.kind))
-            throw new VideoCliError('invalidArguments', 64);
-        if (options.kind === 'comparison') {
-            const run = await readComparisonRun(new AgentApiClient(), requireVideoId(runId), workspaceId, signal);
-            return comparisonRunResult('video jobs get', run);
-        }
-        const run = await readVideoRun(new AgentApiClient(), requireVideoId(runId), workspaceId, signal);
-        const error = remoteVideoFailure(run.state, run.error);
-        return { exitCode: run.state === 'uncertain' ? 75 : run.state === 'failed' || run.state === 'cancelled' ? 4 : 0, envelope: {
-                schemaVersion: 'playcraft.video-cli.v1', command: 'video jobs get', runId: run.runId, state: run.state,
-                ok: !['failed', 'uncertain', 'cancelled'].includes(run.state), result: run,
-                ...(error && { error }),
-            } };
-    }));
-    shared(jobs.command('cancel <runId>').description(t('cancel')))
-        .option('--kind <kind>', c('kind'))
-        .action((identifier, options) => runVideoCliAction('video jobs cancel', options, async (signal) => {
-        const workspaceId = await resolveVideoWorkspace(options.workspace);
-        const runId = requireVideoId(identifier);
-        if (options.kind !== undefined && !['understanding', 'comparison'].includes(options.kind))
-            throw new VideoCliError('invalidArguments', 64);
-        if (options.kind === 'comparison') {
-            const run = await readComparisonRun(new AgentApiClient(), runId, workspaceId, signal, true);
-            const confirmed = run.state === 'cancelled';
-            return { exitCode: confirmed ? 0 : 75, envelope: {
-                    schemaVersion: 'playcraft.video-cli.v1', command: 'video jobs cancel', runId, state: run.state,
-                    ok: confirmed, result: { ...run, cancellationConfirmed: confirmed },
-                    ...(!confirmed && { error: { code: 'uncertain', ...describeVideoFailure(t('uncertain'), run.error?.code, 'cancel') } }),
-                } };
-        }
-        const run = videoAnalysisRunSchema.parse(await new AgentApiClient().post(`/video-analysis/${runId}/cancel`, { workspaceId, runId }, { signal }));
-        if (run.runId !== runId || run.workspaceId !== workspaceId)
-            throw new VideoCliError('invalidResult');
-        const confirmed = run.state === 'cancelled';
-        return { exitCode: confirmed ? 0 : 75, envelope: {
-                schemaVersion: 'playcraft.video-cli.v1', command: 'video jobs cancel', runId, state: run.state,
-                ok: confirmed, result: { ...run, cancellationConfirmed: confirmed },
-                ...(!confirmed && { error: { code: 'uncertain', ...describeVideoFailure(t('uncertain'), run.error?.code, 'cancel') } }),
-            } };
-    }));
-}

package/dist/commands/workspace-runtime.js

@@ -1,54 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { INCOMPATIBLE_EXIT_CODE, parseSandboxRuntimeConfig, } from '@playcraft/common/cloud-workspace/runtime';
-import { startWorkspaceRuntime } from '../workspace-runtime/serve.js';
-export async function runWorkspaceRuntimeServe(configPath) {
-    process.env.PLAYCRAFT_SKIP_UPDATE_CHECK = '1';
-    let config;
-    try {
-        config = parseSandboxRuntimeConfig(JSON.parse(await readFile(configPath, 'utf8')));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`workspace-runtime config invalid: ${message}`);
-        process.exitCode = INCOMPATIBLE_EXIT_CODE;
-        return;
-    }
-    try {
-        const runtime = await startWorkspaceRuntime(config, { configPath });
-        console.log(JSON.stringify({
-            status: 'listening',
-            url: runtime.url,
-            phase: 'awaiting_native',
-            protocolMajor: runtime.config.protocolMajor,
-            protocolMinor: runtime.config.protocolMinor,
-        }));
-        await new Promise((resolve) => {
-            const stop = () => {
-                void runtime.close().finally(resolve);
-            };
-            process.once('SIGINT', stop);
-            process.once('SIGTERM', stop);
-        });
-    }
-    catch (error) {
-        const code = error.code;
-        if (code === 'protocol_incompatible' || code === 'duplicate_instance') {
-            console.error(error instanceof Error ? error.message : code);
-            process.exitCode = INCOMPATIBLE_EXIT_CODE;
-            return;
-        }
-        throw error;
-    }
-}
-export function registerWorkspaceRuntimeCommands(program) {
-    const workspaceRuntime = program
-        .command('workspace-runtime')
-        .description('沙箱内 Sandbox Agent Server（Cloud Workspace 常驻运行入口）');
-    workspaceRuntime
-        .command('serve')
-        .description('前台常驻：读取 Runtime Server 下发的配置，不启动本地 backend 或旧同步')
-        .requiredOption('--config <path>', 'Runtime 引导配置 JSON')
-        .action(async (options) => {
-        await runWorkspaceRuntimeServe(options.config);
-    });
-}

package/dist/commands/workspace.js

@@ -1,40 +0,0 @@
-import { workspaceClone, workspacePush } from '../workspace/transfer-client.js';
-import { workspaceMessage as message } from '../workspace/messages.js';
-import { normalizeWorkspaceTransferError, WorkspaceCliTransferError } from '../workspace/transfer-errors.js';
-export function registerWorkspaceCommands(program) {
-    const run = async (command, options) => {
-        try {
-            if (command === 'clone')
-                await workspaceClone({ ...options, workspaceId: options?.workspaceId ?? '' });
-            else
-                await workspacePush(options);
-        }
-        catch (error) {
-            const normalized = normalizeWorkspaceTransferError(error);
-            const detail = normalized.message;
-            if (options?.json)
-                console.log(JSON.stringify({ ok: false, command: `workspace.${command}`, error: {
-                        code: normalized instanceof WorkspaceCliTransferError ? normalized.code : 'workspace_transfer_failed', message: detail,
-                        ...(normalized instanceof WorkspaceCliTransferError && normalized.details ? { details: normalized.details } : {}),
-                    } }));
-            else
-                console.error(detail);
-            process.exitCode = 1;
-        }
-    };
-    const workspace = program.command('workspace').description(message('description'));
-    workspace.command('clone').description(message('clone'))
-        .requiredOption('--workspace-id <id>', message('workspaceId'))
-        .option('--directory <name>', message('directory'), 'basic')
-        .option('--dir <path>', message('target'))
-        .option('--url <url>', message('url'))
-        .option('--token <token>', message('token'))
-        .option('--json', message('json'))
-        .action(options => run('clone', options));
-    workspace.command('push').description(message('push'))
-        .option('--dir <path>', message('target'))
-        .option('--url <url>', message('url'))
-        .option('--token <token>', message('token'))
-        .option('--json', message('json'))
-        .action(options => run('push', options));
-}