@lumenkey/cli 0.3.1 → 0.4.0-rc.1

package/dist/studio/draft-store.js

@@ -0,0 +1,100 @@
+import { randomUUID } from 'node:crypto';
+import { link, open, readdir, rename, unlink } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { assertRegularFile, assertStudioRoot } from './paths.js';
+import { hasFsCode, StudioError } from './errors.js';
+import { isSafeJson, isoDate } from './run-journal.js';
+import { prepareDocumentAuthority } from './document-authority.js';
+const MAX_BYTES = 512 * 1024;
+const revision = z.number().int().nonnegative().safe();
+const fields = z.unknown().refine(v => isSafeJson(v) && !!v && typeof v === 'object' && !Array.isArray(v) && Buffer.byteLength(JSON.stringify(v)) <= 128 * 1024).pipe(z.record(z.string()));
+const draft = z.object({ modelId: z.string().max(200), fields, savedAt: isoDate }).strict();
+const document = z.object({ schemaVersion: z.literal(1), revision, drafts: z.object({ image: draft.optional(), video: draft.optional() }).strict() }).strict();
+const request = z.object({ revision, mode: z.enum(['image', 'video']), modelId: z.string().max(200), fields }).strict();
+/** Uses the asset store's exclusive directory writer and lifecycle, not a second lock. */
+export function createDraftStore(root, serial) {
+    const file = path.join(root.managedDir, 'drafts.json');
+    let current;
+    async function disk() {
+        await assertStudioRoot(root);
+        try {
+            await assertRegularFile(file);
+            const handle = await open(file, 'r');
+            try {
+                if ((await handle.stat()).size > MAX_BYTES)
+                    throw new Error();
+                return document.parse(JSON.parse(await handle.readFile('utf8')));
+            }
+            finally {
+                await handle.close();
+            }
+        }
+        catch (error) {
+            if (hasFsCode(error, 'ENOENT'))
+                return undefined;
+            throw new StudioError('STUDIO_DRAFT_INVALID', 409);
+        }
+    }
+    async function commit(next, initial = false) {
+        await assertStudioRoot(root);
+        const text = JSON.stringify(document.parse(next));
+        if (Buffer.byteLength(text) > MAX_BYTES)
+            throw new StudioError('STUDIO_DRAFT_INVALID', 409);
+        const temp = path.join(root.managedDir, `drafts.${randomUUID()}.tmp`);
+        const handle = await open(temp, 'wx', 0o600);
+        try {
+            await handle.writeFile(text);
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        await assertStudioRoot(root);
+        if (initial) {
+            await link(temp, file);
+            await unlink(temp);
+        }
+        else {
+            await assertRegularFile(file);
+            await rename(temp, file);
+        }
+    }
+    async function authority() {
+        const loaded = await disk();
+        if (loaded)
+            await prepareDocumentAuthority(root, 'drafts', true, 'STUDIO_DRAFT_INVALID');
+        if (current) {
+            if (!loaded || JSON.stringify(loaded) !== JSON.stringify(current))
+                throw new StudioError('STUDIO_DRAFT_INVALID', 409);
+        }
+        else if (loaded)
+            current = loaded;
+        else {
+            if ((await readdir(root.managedDir)).some(n => /^drafts\..+\.tmp$/.test(n)))
+                throw new StudioError('STUDIO_DRAFT_INVALID', 409);
+            await prepareDocumentAuthority(root, 'drafts', false, 'STUDIO_DRAFT_INVALID');
+            const empty = { schemaVersion: 1, revision: 0, drafts: {} };
+            await commit(empty, true);
+            current = empty;
+        }
+        return current;
+    }
+    return {
+        read: () => serial(async () => structuredClone(await authority())),
+        save: value => serial(async () => {
+            const parsed = request.safeParse(value);
+            if (!parsed.success)
+                throw new StudioError('STUDIO_INPUT_INVALID');
+            const input = parsed.data;
+            const before = await authority();
+            if (input.revision !== before.revision)
+                throw new StudioError('STUDIO_DRAFT_CONFLICT', 409);
+            const next = document.parse({ ...before, revision: before.revision + 1, drafts: { ...before.drafts, [input.mode]: { modelId: input.modelId, fields: input.fields, savedAt: new Date().toISOString() } } });
+            await commit(next);
+            current = next;
+            return structuredClone(next);
+        }),
+    };
+}
+//# sourceMappingURL=draft-store.js.map

package/dist/studio/errors.d.ts

@@ -0,0 +1,85 @@
+declare const messages: {
+    readonly SAVE_REGISTRATION_PENDING: "完整文件待登记到本机素材库。 / Local asset registration pending.";
+    readonly SAVE_RELATION_PENDING: "本机素材已登记，输出关联待恢复。 / Local output relation pending.";
+    readonly SAVE_FILE_MISSING: "本机素材文件缺失。 / Local asset file missing.";
+    readonly SAVE_FILE_MODIFIED: "本机素材文件已变更。 / Local asset file modified.";
+    readonly SAVE_FILE_UNSAFE: "本机素材文件不安全，已保留。 / Unsafe local asset file preserved.";
+    readonly SAVE_FILE_READ_FAILED: "暂时无法核对本机素材。 / Local asset check failed.";
+    readonly SAVE_TARGET_CONFLICT: "目标文件归属无法确认，已保留。 / Save target conflict.";
+    readonly SAVE_PATH_UNSAFE: "保存路径不安全。 / Unsafe save path.";
+    readonly SAVE_WRITE_FAILED: "保存写入失败，未确认成功。 / Save write failed.";
+    readonly SAVE_NETWORK_ERROR: "保存下载暂时失败。 / Save network error.";
+    readonly SAVE_DOWNLOAD_TIMEOUT: "保存下载超时。 / Save download timeout.";
+    readonly SAVE_MEDIA_TOO_LARGE: "输出超过保存上限。 / Save media exceeds limit.";
+    readonly SAVE_LENGTH_MISMATCH: "下载长度不匹配。 / Save length mismatch.";
+    readonly SAVE_RETRY_NOT_ALLOWED: "当前保存操作不能安全重试。 / Save retry is not allowed.";
+    readonly SAVE_OUTPUT_IDENTITY_UNVERIFIED: "输出身份尚未核实。 / Output identity unverified.";
+    readonly SAVE_OUTPUT_IDENTITY_CONFLICT: "输出身份存在冲突。 / Output identity conflict.";
+    readonly SAVE_JOB_NOT_TERMINAL: "云任务尚未结束。 / Job is not terminal.";
+    readonly SAVE_MEDIA_UNSUPPORTED: "该输出格式不支持保存。 / Unsupported save media.";
+    readonly SAVE_SOURCE_UNAVAILABLE: "输出来源当前不可用。 / Save source unavailable.";
+    readonly SAVE_REQUEST_CONFLICT: "该保存请求标识已用于其他输出。 / Save request identity conflict.";
+    readonly SAVE_REVISION_CONFLICT: "保存记录已更新，请重新核对。 / Save revision conflict.";
+    readonly SAVE_TRANSITION_INVALID: "保存状态变更无效，未写入。 / Invalid save transition.";
+    readonly SAVE_OPERATION_NOT_FOUND: "未找到保存操作；这不证明从未受理。 / Save operation not found.";
+    readonly SAVE_CLOUD_CONFIG_REQUIRED: "请先配置本机云端连接。 / Cloud configuration required.";
+    readonly SAVE_OUTPUT_ROOT_REQUIRED: "请先指定本机保存目录。 / Save output root required.";
+    readonly SAVE_ROOT_NOT_ALLOWED: "本机保存目录未获准。 / Save root is not allowed.";
+    readonly SAVE_BINDING_REQUIRED: "请先绑定本机保存连接。 / Save binding required.";
+    readonly SAVE_BINDING_MISMATCH: "记录不属于当前保存连接。 / Save binding mismatch.";
+    readonly SAVE_AUTHORITY_INVALID: "本机保存记录不可核对；不会重建空记录。 / Save authority invalid.";
+    readonly SAVE_AUTHORITY_UNAVAILABLE: "暂时无法核对本机保存记录。 / Save authority unavailable.";
+    readonly STUDIO_DIRECTOR_INVALID: "3D 场景数据无效或超出容量；当前编辑不会被替换。 / Invalid director scene.";
+    readonly STUDIO_CAPTURE_PNG_INVALID: "镜头截图结构或尺寸无效，未登记素材。 / Invalid capture PNG structure or dimensions.";
+    readonly STUDIO_CAPTURE_ID_CONFLICT: "该截图标识已用于不同内容。 / Capture identity conflict.";
+    readonly STUDIO_CAPTURE_BINDING_CONFLICT: "截图回填条件已变化；素材保留，不会恢复被删除的节点或关系。 / Capture binding conflict.";
+    readonly STUDIO_CAPTURE_CAPACITY_EXCEEDED: "截图或画布已达容量上限。 / Capture or canvas capacity exceeded.";
+    readonly STUDIO_CAPTURE_NOT_FOUND: "未找到该画布的截图记录；这不代表磁盘从未写入文件。 / Capture record not found.";
+    readonly STUDIO_CAPTURE_ASSET_UNAVAILABLE: "截图文件缺失或校验失败，不能自动回填。 / Capture asset unavailable.";
+    readonly STUDIO_CAPTURE_OUTCOME_UNKNOWN: "截图写入结果无法确认；请核对本机素材与恢复记录，勿重复导出。 / Capture outcome unknown.";
+    readonly STUDIO_CANVAS_INVALID: "画布文件损坏、丢失或已被外部修改；不会覆盖原文件。 / Canvas authority is invalid or changed.";
+    readonly STUDIO_CANVAS_CONFLICT: "画布已在另一窗口更新；请保留当前编辑并重新读取。 / Canvas revision conflict.";
+    readonly STUDIO_CANVAS_CAPACITY_EXCEEDED: "本机画布文件已达容量上限，未写入本次修改。 / Canvas collection capacity exceeded; write rejected.";
+    readonly STUDIO_CANVAS_NOT_FOUND: "未找到本机画布。 / Local canvas not found.";
+    readonly STUDIO_DRAFT_INVALID: "草稿文件损坏或已被外部修改；不会覆盖原文件。 / Draft authority is invalid or changed.";
+    readonly STUDIO_DRAFT_CONFLICT: "草稿已在另一窗口更新；请保留当前编辑并重新读取。 / Draft revision conflict.";
+    readonly STUDIO_JOURNAL_INVALID: "任务记录损坏、冲突或超出容量；未提交新任务。 / Invalid or conflicting run journal.";
+    readonly STUDIO_CLOUD_DISCONNECTED: "尚未连接云端；本机会话不代表云端已连接。 / Cloud is not connected.";
+    readonly STUDIO_CLOUD_CONFIG_INVALID: "本机 CLI 云端配置未就绪，请先配置 CLI。 / CLI cloud configuration is not ready.";
+    readonly STUDIO_CLOUD_RESPONSE_INVALID: "云端响应不符合契约，已停止当前操作。 / Invalid cloud response.";
+    readonly STUDIO_CLOUD_FAILED: "云端请求失败。 / Cloud request failed.";
+    readonly STUDIO_RUN_CONFLICT: "该任务标识已用于不同请求。 / Run identity conflict.";
+    readonly STUDIO_RUN_NOT_FOUND: "当前连接下未找到该任务。 / Run not found for this connection.";
+    readonly STUDIO_MODEL_NOT_AVAILABLE: "目录中没有该可用图像或视频模型。 / Media model unavailable in catalog.";
+    readonly STUDIO_CONFIRM_REQUIRED: "需要明确确认本次报价才能提交。 / Explicit quote confirmation required.";
+    readonly STUDIO_QUOTE_EXPIRED: "报价已过期，请重新报价并确认。 / Quote expired; obtain and confirm a new quote.";
+    readonly STUDIO_SUBMISSION_UNRESOLVED: "此前提交结果待确认，已阻止重复下单；请核对平台记录。 / Submission unresolved; repeat submission blocked.";
+    readonly STUDIO_MEDIA_TYPE_INVALID: "媒体类型或文件头不受支持。 / Unsupported media type or signature.";
+    readonly STUDIO_CATALOG_INVALID: "素材清单损坏或版本不受支持；原文件已保留。 / Invalid or unsupported catalog; files preserved.";
+    readonly STUDIO_ASSET_ID_INVALID: "素材 ID 无效。 / Invalid asset ID.";
+    readonly STUDIO_OUTPUT_ROOT_REQUIRED: "请先指定绝对保存目录。 / An absolute output directory is required.";
+    readonly STUDIO_PATH_UNSAFE: "保存路径包含链接或已发生变化。 / Unsafe or changed storage path.";
+    readonly STUDIO_STORAGE_BUSY: "该目录正在使用或无法确认旧写手已退出。 / Storage is busy or ownership cannot be established.";
+    readonly STUDIO_STORAGE_FAILED: "本机文件操作失败；未确认保存成功。 / Local storage operation failed.";
+    readonly STUDIO_STORAGE_CLOSED: "本机存储已关闭。 / Storage is closed.";
+    readonly STUDIO_MEDIA_TOO_LARGE: "素材超过保存上限。 / Media exceeds the size limit.";
+    readonly STUDIO_INPUT_INVALID: "输入参数无效或数据不完整。 / Invalid or incomplete input.";
+    readonly STUDIO_ASSET_NOT_FOUND: "未找到该素材。 / Asset not found.";
+    readonly STUDIO_ASSET_CORRUPT: "素材缺失或校验失败。 / Asset missing or integrity check failed.";
+    readonly STUDIO_SESSION_REQUIRED: "请从本次启动的浏览器窗口访问。 / Open the browser launched by this runtime.";
+    readonly STUDIO_REQUEST_FORBIDDEN: "请求来源不被允许。 / Request origin is not allowed.";
+    readonly STUDIO_ROUTE_NOT_FOUND: "接口不存在。 / Route not found.";
+    readonly STUDIO_RANGE_INVALID: "读取范围无效。 / Invalid byte range.";
+    readonly STUDIO_BROWSER_OPEN_FAILED: "无法打开浏览器；请确认系统默认浏览器后重试。 / Could not open the default browser.";
+};
+export type StudioErrorCode = keyof typeof messages;
+export declare class StudioError extends Error {
+    readonly code: StudioErrorCode;
+    readonly status: number;
+    constructor(code: StudioErrorCode, status?: number);
+}
+export declare function storageError(error: unknown): StudioError;
+export declare function hasFsCode(error: unknown, code: string): boolean;
+export declare function isSaveAuthorityError(error: unknown): error is StudioError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/studio/errors.js

@@ -0,0 +1,94 @@
+const messages = {
+    SAVE_REGISTRATION_PENDING: '完整文件待登记到本机素材库。 / Local asset registration pending.',
+    SAVE_RELATION_PENDING: '本机素材已登记，输出关联待恢复。 / Local output relation pending.',
+    SAVE_FILE_MISSING: '本机素材文件缺失。 / Local asset file missing.',
+    SAVE_FILE_MODIFIED: '本机素材文件已变更。 / Local asset file modified.',
+    SAVE_FILE_UNSAFE: '本机素材文件不安全，已保留。 / Unsafe local asset file preserved.',
+    SAVE_FILE_READ_FAILED: '暂时无法核对本机素材。 / Local asset check failed.',
+    SAVE_TARGET_CONFLICT: '目标文件归属无法确认，已保留。 / Save target conflict.',
+    SAVE_PATH_UNSAFE: '保存路径不安全。 / Unsafe save path.',
+    SAVE_WRITE_FAILED: '保存写入失败，未确认成功。 / Save write failed.',
+    SAVE_NETWORK_ERROR: '保存下载暂时失败。 / Save network error.',
+    SAVE_DOWNLOAD_TIMEOUT: '保存下载超时。 / Save download timeout.',
+    SAVE_MEDIA_TOO_LARGE: '输出超过保存上限。 / Save media exceeds limit.',
+    SAVE_LENGTH_MISMATCH: '下载长度不匹配。 / Save length mismatch.',
+    SAVE_RETRY_NOT_ALLOWED: '当前保存操作不能安全重试。 / Save retry is not allowed.',
+    SAVE_OUTPUT_IDENTITY_UNVERIFIED: '输出身份尚未核实。 / Output identity unverified.',
+    SAVE_OUTPUT_IDENTITY_CONFLICT: '输出身份存在冲突。 / Output identity conflict.',
+    SAVE_JOB_NOT_TERMINAL: '云任务尚未结束。 / Job is not terminal.',
+    SAVE_MEDIA_UNSUPPORTED: '该输出格式不支持保存。 / Unsupported save media.',
+    SAVE_SOURCE_UNAVAILABLE: '输出来源当前不可用。 / Save source unavailable.',
+    SAVE_REQUEST_CONFLICT: '该保存请求标识已用于其他输出。 / Save request identity conflict.',
+    SAVE_REVISION_CONFLICT: '保存记录已更新，请重新核对。 / Save revision conflict.',
+    SAVE_TRANSITION_INVALID: '保存状态变更无效，未写入。 / Invalid save transition.',
+    SAVE_OPERATION_NOT_FOUND: '未找到保存操作；这不证明从未受理。 / Save operation not found.',
+    SAVE_CLOUD_CONFIG_REQUIRED: '请先配置本机云端连接。 / Cloud configuration required.',
+    SAVE_OUTPUT_ROOT_REQUIRED: '请先指定本机保存目录。 / Save output root required.',
+    SAVE_ROOT_NOT_ALLOWED: '本机保存目录未获准。 / Save root is not allowed.',
+    SAVE_BINDING_REQUIRED: '请先绑定本机保存连接。 / Save binding required.',
+    SAVE_BINDING_MISMATCH: '记录不属于当前保存连接。 / Save binding mismatch.',
+    SAVE_AUTHORITY_INVALID: '本机保存记录不可核对；不会重建空记录。 / Save authority invalid.',
+    SAVE_AUTHORITY_UNAVAILABLE: '暂时无法核对本机保存记录。 / Save authority unavailable.',
+    STUDIO_DIRECTOR_INVALID: '3D 场景数据无效或超出容量；当前编辑不会被替换。 / Invalid director scene.',
+    STUDIO_CAPTURE_PNG_INVALID: '镜头截图结构或尺寸无效，未登记素材。 / Invalid capture PNG structure or dimensions.',
+    STUDIO_CAPTURE_ID_CONFLICT: '该截图标识已用于不同内容。 / Capture identity conflict.',
+    STUDIO_CAPTURE_BINDING_CONFLICT: '截图回填条件已变化；素材保留，不会恢复被删除的节点或关系。 / Capture binding conflict.',
+    STUDIO_CAPTURE_CAPACITY_EXCEEDED: '截图或画布已达容量上限。 / Capture or canvas capacity exceeded.',
+    STUDIO_CAPTURE_NOT_FOUND: '未找到该画布的截图记录；这不代表磁盘从未写入文件。 / Capture record not found.',
+    STUDIO_CAPTURE_ASSET_UNAVAILABLE: '截图文件缺失或校验失败，不能自动回填。 / Capture asset unavailable.',
+    STUDIO_CAPTURE_OUTCOME_UNKNOWN: '截图写入结果无法确认；请核对本机素材与恢复记录，勿重复导出。 / Capture outcome unknown.',
+    STUDIO_CANVAS_INVALID: '画布文件损坏、丢失或已被外部修改；不会覆盖原文件。 / Canvas authority is invalid or changed.',
+    STUDIO_CANVAS_CONFLICT: '画布已在另一窗口更新；请保留当前编辑并重新读取。 / Canvas revision conflict.',
+    STUDIO_CANVAS_CAPACITY_EXCEEDED: '本机画布文件已达容量上限，未写入本次修改。 / Canvas collection capacity exceeded; write rejected.',
+    STUDIO_CANVAS_NOT_FOUND: '未找到本机画布。 / Local canvas not found.',
+    STUDIO_DRAFT_INVALID: '草稿文件损坏或已被外部修改；不会覆盖原文件。 / Draft authority is invalid or changed.',
+    STUDIO_DRAFT_CONFLICT: '草稿已在另一窗口更新；请保留当前编辑并重新读取。 / Draft revision conflict.',
+    STUDIO_JOURNAL_INVALID: '任务记录损坏、冲突或超出容量；未提交新任务。 / Invalid or conflicting run journal.',
+    STUDIO_CLOUD_DISCONNECTED: '尚未连接云端；本机会话不代表云端已连接。 / Cloud is not connected.',
+    STUDIO_CLOUD_CONFIG_INVALID: '本机 CLI 云端配置未就绪，请先配置 CLI。 / CLI cloud configuration is not ready.',
+    STUDIO_CLOUD_RESPONSE_INVALID: '云端响应不符合契约，已停止当前操作。 / Invalid cloud response.',
+    STUDIO_CLOUD_FAILED: '云端请求失败。 / Cloud request failed.',
+    STUDIO_RUN_CONFLICT: '该任务标识已用于不同请求。 / Run identity conflict.',
+    STUDIO_RUN_NOT_FOUND: '当前连接下未找到该任务。 / Run not found for this connection.',
+    STUDIO_MODEL_NOT_AVAILABLE: '目录中没有该可用图像或视频模型。 / Media model unavailable in catalog.',
+    STUDIO_CONFIRM_REQUIRED: '需要明确确认本次报价才能提交。 / Explicit quote confirmation required.',
+    STUDIO_QUOTE_EXPIRED: '报价已过期，请重新报价并确认。 / Quote expired; obtain and confirm a new quote.',
+    STUDIO_SUBMISSION_UNRESOLVED: '此前提交结果待确认，已阻止重复下单；请核对平台记录。 / Submission unresolved; repeat submission blocked.',
+    STUDIO_MEDIA_TYPE_INVALID: '媒体类型或文件头不受支持。 / Unsupported media type or signature.',
+    STUDIO_CATALOG_INVALID: '素材清单损坏或版本不受支持；原文件已保留。 / Invalid or unsupported catalog; files preserved.',
+    STUDIO_ASSET_ID_INVALID: '素材 ID 无效。 / Invalid asset ID.',
+    STUDIO_OUTPUT_ROOT_REQUIRED: '请先指定绝对保存目录。 / An absolute output directory is required.',
+    STUDIO_PATH_UNSAFE: '保存路径包含链接或已发生变化。 / Unsafe or changed storage path.',
+    STUDIO_STORAGE_BUSY: '该目录正在使用或无法确认旧写手已退出。 / Storage is busy or ownership cannot be established.',
+    STUDIO_STORAGE_FAILED: '本机文件操作失败；未确认保存成功。 / Local storage operation failed.',
+    STUDIO_STORAGE_CLOSED: '本机存储已关闭。 / Storage is closed.',
+    STUDIO_MEDIA_TOO_LARGE: '素材超过保存上限。 / Media exceeds the size limit.',
+    STUDIO_INPUT_INVALID: '输入参数无效或数据不完整。 / Invalid or incomplete input.',
+    STUDIO_ASSET_NOT_FOUND: '未找到该素材。 / Asset not found.',
+    STUDIO_ASSET_CORRUPT: '素材缺失或校验失败。 / Asset missing or integrity check failed.',
+    STUDIO_SESSION_REQUIRED: '请从本次启动的浏览器窗口访问。 / Open the browser launched by this runtime.',
+    STUDIO_REQUEST_FORBIDDEN: '请求来源不被允许。 / Request origin is not allowed.',
+    STUDIO_ROUTE_NOT_FOUND: '接口不存在。 / Route not found.',
+    STUDIO_RANGE_INVALID: '读取范围无效。 / Invalid byte range.',
+    STUDIO_BROWSER_OPEN_FAILED: '无法打开浏览器；请确认系统默认浏览器后重试。 / Could not open the default browser.',
+};
+export class StudioError extends Error {
+    code;
+    status;
+    constructor(code, status = 400) {
+        super(`${messages[code]} (${code})`);
+        this.code = code;
+        this.status = status;
+        this.name = 'StudioError';
+    }
+}
+export function storageError(error) {
+    return error instanceof StudioError ? error : new StudioError('STUDIO_STORAGE_FAILED', 500);
+}
+export function hasFsCode(error, code) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === code;
+}
+export function isSaveAuthorityError(error) {
+    return error instanceof StudioError && ['SAVE_AUTHORITY_INVALID', 'SAVE_AUTHORITY_UNAVAILABLE'].includes(error.code);
+}
+//# sourceMappingURL=errors.js.map

package/dist/studio/launch.d.ts

@@ -0,0 +1,5 @@
+export declare function runStudioCommand(options: {
+    outputDir?: string;
+    noOpen?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/studio/launch.js

@@ -0,0 +1,31 @@
+import { execFile } from 'node:child_process';
+import { startStudioServer } from './server.js';
+import { StudioError } from './errors.js';
+import { ui } from '../core/locale.js';
+async function openBrowser(url) {
+    const command = process.platform === 'win32' ? 'rundll32.exe' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+    const args = process.platform === 'win32' ? ['url.dll,FileProtocolHandler', url] : [url];
+    await new Promise((resolve, reject) => execFile(command, args, { windowsHide: true, timeout: 15_000 }, error => error ? reject(new StudioError('STUDIO_BROWSER_OPEN_FAILED', 500)) : resolve()));
+}
+export async function runStudioCommand(options) {
+    const server = await startStudioServer({ outputDir: options.outputDir });
+    let stop;
+    const stopped = new Promise(resolve => { stop = resolve; });
+    process.once('SIGINT', stop);
+    process.once('SIGTERM', stop);
+    try {
+        console.log(`${ui('Local Studio:', '本机工作台：')} ${server.origin}/studio/`);
+        console.log(options.outputDir ? `${ui('Save location:', '保存位置：')} ${options.outputDir}` : ui('Save location: not configured', '保存位置：未设置'));
+        if (options.noOpen)
+            console.log(ui('Headless diagnostic mode. The printed address does not authorize access. Restart without --no-open for browser access.', '无浏览器诊断模式。打印的地址不带访问授权；交互使用请去掉 --no-open 重新启动。'));
+        else
+            await openBrowser(server.launchUrl);
+        await stopped;
+    }
+    finally {
+        process.removeListener('SIGINT', stop);
+        process.removeListener('SIGTERM', stop);
+        await server.close();
+    }
+}
+//# sourceMappingURL=launch.js.map

package/dist/studio/media.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import type { StudioCatalog, StudioMediaType } from './types.js';
+export declare const mediaExtensions: Record<StudioMediaType, string>;
+export declare const displayNameSchema: z.ZodEffects<z.ZodString, string, string>;
+export declare function validateStudioCatalog(value: unknown): StudioCatalog;
+export declare function validateStudioAssetId(value: unknown): string;
+export declare function detectStudioMediaType(prefix: Uint8Array): StudioMediaType;
+export declare function assertStudioMediaType(prefix: Uint8Array, declared: string): StudioMediaType;
+//# sourceMappingURL=media.d.ts.map

package/dist/studio/media.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { StudioError } from './errors.js';
+import { directorProvenanceSchema } from './director-contract.js';
+export const mediaExtensions = {
+    'image/png': 'png', 'image/jpeg': 'jpg', 'image/webp': 'webp', 'video/mp4': 'mp4', 'video/webm': 'webm',
+};
+const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+export const displayNameSchema = z.string().trim().min(1).max(200).refine(v => !/[\u0000-\u001f\u007f]/.test(v));
+const assetSchema = z.object({
+    directorCapture: directorProvenanceSchema.optional(),
+    assetId: z.string().regex(uuid), displayName: displayNameSchema,
+    mediaType: z.enum(['image/png', 'image/jpeg', 'image/webp', 'video/mp4', 'video/webm']),
+    relativePath: z.string(), byteLength: z.number().int().positive().safe(),
+    sha256: z.string().regex(/^[0-9a-f]{64}$/), savedAt: z.string().datetime(),
+}).strict().refine(a => a.relativePath === `assets/${a.assetId}.${mediaExtensions[a.mediaType]}` && (!a.directorCapture || (a.mediaType === 'image/png' && a.byteLength <= 8 * 1024 * 1024)));
+const catalogSchema = z.object({
+    schemaVersion: z.literal(1), revision: z.number().int().nonnegative().safe(), assets: z.array(assetSchema).max(100_000),
+}).strict().refine(c => new Set(c.assets.map(a => a.assetId)).size === c.assets.length && new Set(c.assets.flatMap(a => a.directorCapture ? [a.directorCapture.captureId] : [])).size === c.assets.filter(a => a.directorCapture).length);
+export function validateStudioCatalog(value) {
+    const parsed = catalogSchema.safeParse(value);
+    if (!parsed.success)
+        throw new StudioError('STUDIO_CATALOG_INVALID', 500);
+    return parsed.data;
+}
+export function validateStudioAssetId(value) {
+    if (typeof value !== 'string' || !uuid.test(value))
+        throw new StudioError('STUDIO_ASSET_ID_INVALID');
+    return value;
+}
+export function detectStudioMediaType(prefix) {
+    const b = Buffer.from(prefix);
+    if (b.length >= 16 && b.subarray(0, 8).equals(Buffer.from('89504e470d0a1a0a', 'hex')) && b.toString('ascii', 12, 16) === 'IHDR')
+        return 'image/png';
+    if (b.length >= 4 && b[0] === 0xff && b[1] === 0xd8 && b[2] === 0xff && b[3] !== 0x00 && b[3] !== 0xff)
+        return 'image/jpeg';
+    if (b.length >= 16 && b.toString('ascii', 0, 4) === 'RIFF' && b.toString('ascii', 8, 12) === 'WEBP' && ['VP8 ', 'VP8L', 'VP8X'].includes(b.toString('ascii', 12, 16)))
+        return 'image/webp';
+    if (b.length >= 16 && b.readUInt32BE(0) >= 16 && b.toString('ascii', 4, 8) === 'ftyp' && /^(isom|iso[2-9]|mp4[12]|avc1|M4V |dash)$/.test(b.toString('ascii', 8, 12)))
+        return 'video/mp4';
+    if (b.length >= 11 && b.subarray(0, 4).equals(Buffer.from('1a45dfa3', 'hex')) && b.includes(Buffer.from('4282847765626d', 'hex')))
+        return 'video/webm';
+    throw new StudioError('STUDIO_MEDIA_TYPE_INVALID', 415);
+}
+export function assertStudioMediaType(prefix, declared) {
+    const type = detectStudioMediaType(prefix);
+    if (declared !== type)
+        throw new StudioError('STUDIO_MEDIA_TYPE_INVALID', 415);
+    return type;
+}
+//# sourceMappingURL=media.js.map