@lumenkey/cli 0.3.0 → 0.4.0-rc.1

package/dist/studio/web/model.js

@@ -0,0 +1,182 @@
+// Browser-safe contract: no Node imports and no credentials.
+import { messageForCode } from './messages.js';
+// Source (read-only r13 zh-CN): F:/光钥/_admin-manual-approval-20261007-cn-frontend/workbench-suno-audio-r13-20261016/candidate/src/i18n/locales/zh-CN.json
+// SHA256 b5f9ce939088eab3. Field names only; no fallback/unspecified or audio-only Suno keys.
+const fieldLabels = Object.freeze({
+    'playground.fields.prompt': '提示词',
+    'playground.fields.image_size': '图像尺寸',
+    'playground.fields.num_images': '图像数量',
+    'playground.fields.duration': '时长',
+    'playground.fields.aspect_ratio': '画面比例',
+    'playground.fields.size': '自定义尺寸（宽 × 高）',
+    'playground.fields.prompt_extend': '扩展提示词',
+    'playground.fields.resolution': '清晰度',
+    'playground.fields.generate_audio': '生成音频',
+    'playground.fields.source': '源图像',
+    'playground.fields.outputs': '输出数量',
+    'playground.fields.seed': '种子',
+    'playground.fields.count': '数量',
+    'playground.fields.containsRealPerson': '包含真人',
+});
+const displayControls = new Set(['upload', 'select', 'textarea', 'checkbox', 'number', 'text']);
+export function modelsFor(models, mode) { return models.filter(m => m.type === mode || m.capabilities?.includes(mode)); }
+const dangerous = (key) => ['__proto__', 'constructor', 'prototype'].includes(key);
+function safe(value, depth = 0) {
+    if (depth > 20)
+        return false;
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return true;
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(v => safe(v, depth + 1));
+    return !!value && typeof value === 'object' && Object.entries(value).every(([k, v]) => !dangerous(k) && safe(v, depth + 1));
+}
+const encode = (value) => typeof value === 'string' ? value : JSON.stringify(value);
+const record = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const schemaTypes = new Set(['string', 'number', 'integer', 'boolean', 'object', 'array', 'null']);
+const validType = (value) => typeof value === 'string' && schemaTypes.has(value);
+const catalogInvalid = () => { throw Object.assign(new Error('模型目录字段不符合表单契约；当前编辑已保留。'), { code: 'STUDIO_CATALOG_RESPONSE_INVALID' }); };
+export function validateModels(value) {
+    if (!Array.isArray(value) || value.length > 10000)
+        return catalogInvalid();
+    const ids = new Set();
+    for (const model of value) {
+        if (!record(model) || typeof model.id !== 'string' || !model.id || ids.has(model.id) || !safe(model))
+            return catalogInvalid();
+        ids.add(model.id);
+        if ((model.type !== undefined && typeof model.type !== 'string') || (model.capabilities !== undefined && (!Array.isArray(model.capabilities) || !model.capabilities.every(v => typeof v === 'string'))))
+            return catalogInvalid();
+        const schema = model.inputSchema;
+        if (!record(schema) || !record(schema.properties) || (schema.required !== undefined && (!Array.isArray(schema.required) || !schema.required.every(v => typeof v === 'string'))))
+            return catalogInvalid();
+        for (const [key, spec] of Object.entries(schema.properties)) {
+            if (dangerous(key) || !record(spec) || (spec.title !== undefined && typeof spec.title !== 'string') || (spec.enum !== undefined && (!Array.isArray(spec.enum) || !spec.enum.length || new Set(spec.enum.map(v => JSON.stringify(v))).size !== spec.enum.length)))
+                return catalogInvalid();
+            if (spec.type !== undefined && !validType(spec.type) && !(Array.isArray(spec.type) && spec.type.length > 0 && spec.type.every(validType) && new Set(spec.type).size === spec.type.length))
+                return catalogInvalid();
+        }
+    }
+    return value;
+}
+export function describeFields(model) {
+    validateModels([model]);
+    const schema = model.inputSchema, candidate = schema['x-lumenkey-ui'];
+    const ui = record(candidate) && candidate.version === 1 && (candidate.mode === 'image' || candidate.mode === 'video')
+        && Array.isArray(candidate.core) && candidate.core.every((key) => typeof key === 'string')
+        && Array.isArray(candidate.advanced) && candidate.advanced.every((key) => typeof key === 'string')
+        ? { core: candidate.core, advanced: candidate.advanced } : undefined;
+    const core = new Set(ui?.core), advanced = new Set(ui?.advanced);
+    const keys = ui ? [...new Set([...ui.core, ...ui.advanced, ...Object.keys(schema.properties)])].filter(key => Object.hasOwn(schema.properties, key)) : Object.keys(schema.properties);
+    return keys.map(key => {
+        const spec = schema.properties[key];
+        const type = spec.type;
+        const values = Array.isArray(spec.enum) ? spec.enum : undefined;
+        const control = spec['x-lumenkey-control'], knownControl = typeof control === 'string' && displayControls.has(control);
+        const unlisted = !!ui && !core.has(key) && !advanced.has(key);
+        const labelKey = spec['x-lumenkey-label-key'];
+        const labelKnown = !unlisted && (control === undefined || knownControl) && typeof labelKey === 'string' && Object.hasOwn(fieldLabels, labelKey);
+        const field = { key, title: labelKnown ? fieldLabels[labelKey] : key, labelKnown, spec, required: schema.required?.includes(key) ?? false,
+            kind: values ? 'enum' : type === 'string' ? 'text' : type === 'integer' || type === 'number' ? 'number' : type === 'boolean' ? 'boolean' : 'json',
+            ...(values ? { options: values.map(v => ({ value: JSON.stringify(v), label: v === '' ? '空字符串（显式值）' : encode(v) + (values.filter(other => encode(other) === encode(v)).length > 1 ? `（${typeof v}）` : '') })) } : {}),
+            ...(Object.hasOwn(spec, 'default') ? { defaultHint: encode(spec.default) } : {}), };
+        if (ui)
+            field.placement = unlisted ? 'advanced' : !knownControl ? fieldPlacement(field) : core.has(key) ? control === 'textarea' || control === 'upload' ? 'input' : 'common' : 'advanced';
+        return field;
+    });
+}
+export function parseFields(model, fields) {
+    const specs = new Map(describeFields(model).map(f => [f.key, f]));
+    const input = {};
+    for (const [key, raw] of Object.entries(fields)) {
+        if (raw === '')
+            continue;
+        const f = specs.get(key);
+        const fail = () => { throw Object.assign(new Error(`请检查参数 ${key} 的格式。`), { code: 'STUDIO_INPUT_INVALID' }); };
+        if (!f || dangerous(key))
+            fail();
+        let value;
+        if (f.kind === 'text')
+            value = raw;
+        else if (f.kind === 'enum') {
+            const matches = f.spec.enum.filter(v => JSON.stringify(v) === raw);
+            if (matches.length !== 1)
+                fail();
+            value = matches[0];
+        }
+        else if (f.kind === 'number') {
+            if (!/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/.test(raw))
+                fail();
+            value = Number(raw);
+            if (!Number.isFinite(value) || (f.spec.type === 'integer' && !Number.isSafeInteger(value)))
+                fail();
+        }
+        else if (f.kind === 'boolean') {
+            if (!['true', 'false'].includes(raw))
+                fail();
+            value = raw === 'true';
+        }
+        else {
+            try {
+                value = JSON.parse(raw);
+            }
+            catch {
+                fail();
+            }
+        }
+        if (!safe(value))
+            fail();
+        input[key] = value;
+    }
+    return input;
+}
+export function runLabel(run) {
+    if (run.state === 'SUBMISSION_REJECTED')
+        return '提交被拒';
+    if (run.state === 'SUBMISSION_UNKNOWN' || run.state === 'SUBMITTING')
+        return run.job ? '任务已建立 · 状态待核对' : '提交结果待确认';
+    if (run.job?.error)
+        return '任务失败 / 返回错误';
+    if (run.job?.status === 'succeeded')
+        return run.job.outputs.length ? '云端完成' : '未取得可用输出';
+    if (run.job && ['failed', 'rejected', 'cancelled', 'expired'].includes(run.job.status))
+        return `任务失败或结束 · ${run.job.status}`;
+    if (run.job)
+        return `云端处理中 · ${run.job.status}`;
+    return run.state === 'QUOTED' ? '已报价 · 未提交' : '状态待核对';
+}
+export function runDiagnosticText(run) {
+    const diagnostic = run.failure ?? run.job?.error;
+    if (diagnostic)
+        return `${messageForCode(diagnostic.code, diagnostic.message || '请核对平台记录。')} (${diagnostic.code})`;
+    if (run.lastErrorCode)
+        return `${run.state === 'SUBMISSION_REJECTED' ? '本次提交被拒，请核对原因后重新报价。' : '请核对任务状态，不要重复提交。'} (${run.lastErrorCode})`;
+}
+export function runRecoveryText(run) {
+    // Studio's journal is not CLI/MCP pending storage; no replay command/window exists.
+    if (!run.job && ['SUBMISSION_UNKNOWN', 'SUBMITTING'].includes(run.state))
+        return '请到平台核对任务与账单记录；当前页面不能确认这次提交结果，请勿重复提交。';
+}
+export function safeOutputUrl(value) {
+    try {
+        const u = new URL(value);
+        if (['http:', 'https:'].includes(u.protocol) && !u.username && !u.password)
+            return u.href;
+    }
+    catch { /* reject */ }
+}
+// Frozen v1 display metadata wins; absent/unknown metadata falls back by schema type.
+export function fieldPlacement(field) {
+    return field.placement ?? (field.kind === 'json' ? 'advanced' : field.kind === 'text' ? 'input' : 'common');
+}
+export function fieldDisplayLabel(field) {
+    return field.title + (field.required ? ' *' : '');
+}
+export function compactLocation(path) {
+    if (path.length <= 42)
+        return path;
+    const separator = path.includes('\\') ? '\\' : '/', parts = path.split(/[\\/]+/).filter(Boolean);
+    const root = /^[A-Za-z]:/.exec(path)?.[0] ?? (path.startsWith('/') ? '' : parts.shift() ?? '');
+    return root + separator + '…' + separator + parts.slice(-2).join(separator);
+}
+//# sourceMappingURL=model.js.map

package/dist/studio/web/save-controller.d.ts

@@ -0,0 +1,85 @@
+import { uiError, type Resource, type StudioApi } from './controller.js';
+import { type SaveReceipt } from './save-model.js';
+import { createSaveQueue } from './save-queue.js';
+export interface SaveScope {
+    rootId: string | null;
+    connectionId: string;
+}
+export interface SaveBinding {
+    scope: SaveScope;
+    root: {
+        absolutePath: string;
+    } | null;
+    code: 'SAVE_OUTPUT_ROOT_REQUIRED' | null;
+}
+export type IdentityReason = 'LEGACY_AWAITING_FRESH_GET' | 'JOB_UNAVAILABLE' | 'NO_VERIFIABLE_OUTPUTS' | 'IDENTITY_CONFLICT';
+export interface OutputView {
+    localOutputId: string | null;
+    runId: string;
+    jobId: string;
+    gatewayAssetId: string | null;
+    outputIndex: number | null;
+    displayOrdinal: number;
+    outputType: 'image' | 'video' | 'audio' | null;
+    mediaType: string | null;
+    identity: {
+        status: 'VERIFIED' | 'UNVERIFIED';
+        reason: IdentityReason | null;
+    };
+    acceptance: 'ACCEPTED' | 'NEVER_ACCEPTED' | 'UNKNOWN';
+    saveAllowed: boolean;
+    saveBlockedCode: string | null;
+    saveOperationId: string | null;
+    save: SaveReceipt | null;
+}
+export interface OutputList {
+    scope: SaveScope;
+    revision: number;
+    items: OutputView[];
+}
+export interface SaveState {
+    binding: Resource<SaveBinding>;
+    outputs: Record<string, Resource<OutputList>>;
+    operations: Record<string, Resource<SaveReceipt> & {
+        notice?: string;
+    }>;
+    targets: Record<string, {
+        status: 'idle' | 'submitting' | 'unknown' | 'known';
+        operationId?: string;
+        checking?: boolean;
+        error?: ReturnType<typeof uiError>;
+    }>;
+}
+export declare function parseBinding(value: unknown): SaveBinding;
+export declare function parseOutputs(value: unknown, scope: SaveScope, runId: string): OutputList;
+interface SaveClock {
+    now(): number;
+    setTimeout(fn: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+export declare function createSaveController(options: {
+    api: StudioApi;
+    onChange?: () => void;
+    uuid?: () => string;
+    clock?: SaveClock;
+    queue?: ReturnType<typeof createSaveQueue>;
+}): {
+    state: SaveState;
+    invalidate: () => void;
+    bind: () => Promise<void>;
+    readOutputs: (runId: string, retry?: boolean) => Promise<void>;
+    rememberReceipt: (next: SaveReceipt) => SaveReceipt;
+    readOperation: (id: string, readOptions?: {
+        manual?: boolean;
+        automatic?: boolean;
+        lazy?: boolean;
+    }) => Promise<void>;
+    checkOutput: (runId: string, outputId: string) => Promise<void>;
+    saveOutput: (runId: string, outputId: string) => Promise<void>;
+    retryOperation: (id: string) => Promise<void>;
+    markVisible: (id: string, onScreen: boolean) => void;
+    setPageVisible: (value: boolean) => void;
+    dispose: () => void;
+};
+export {};
+//# sourceMappingURL=save-controller.d.ts.map