@playcraft/cli 0.1.28 → 0.1.29

package/dist/utils/agent-api-client.js

@@ -1,12 +1,8 @@
 import { readFileSync, existsSync } from 'fs';
-import { dirname, join } from 'path';
+import { join } from 'path';
 import { homedir } from 'os';
 import { loadGlobalConfig } from '../config.js';
 import { DEFAULT_PLAYCRAFT_CLOUD_BASE } from '../commands/login.js';
-import { AGENT_TOOL_OPERATION_PROTOCOL, AGENT_TOOL_OPERATION_HEADERS, AGENT_TOOL_OPERATION_CAPABILITIES_PATH, } from '@playcraft/common/agent-tools';
-import { beginToolOperation } from './tool-operation-journal.js';
-import { businessEndpoint } from './environment-endpoints.js';
-import { AccountActivationError, parseErrorPayload, pendingAccountActivationError, } from '../auth/account-activation.js';
 /**
  * 判断 token 是否为用户 PAT（Personal Access Token）。
  * PAT 以 "playcraft_pat_" 开头；沙箱 JWT 为三段式 base64。
@@ -19,8 +15,8 @@ function isPatToken(token) {
  * or from the CLI after `playcraft login`.
  *
  * 凭证解析优先级：
- *   API URL : PLAYCRAFT_API_URL → sandbox global .playcraft.json → project .playcraft.json → ~/.playcraft/config.json → DEFAULT_PLAYCRAFT_CLOUD_BASE
- *   Token   : PLAYCRAFT_SANDBOX_TOKEN → sandbox global .playcraft.json → project .playcraft.json → ~/.playcraft/config.json token (PAT)
+ *   API URL : PLAYCRAFT_API_URL → .playcraft.json → ~/.playcraft/config.json → DEFAULT_PLAYCRAFT_CLOUD_BASE
+ *   Token   : PLAYCRAFT_SANDBOX_TOKEN → .playcraft.json token → ~/.playcraft/config.json token (PAT)
  *
  * 鉴权 header 自动选择：
  *   - 沙箱 JWT (非 PAT) → X-Sandbox-Token: <token>（后端 @SandboxToken 路由的沙箱分支）
@@ -29,7 +25,7 @@ function isPatToken(token) {
 export class AgentApiClient {
     apiUrl;
     token;
-    credentialFile;
+    isPat;
     playcraftEnv;
     constructor() {
         const localConfig = AgentApiClient.loadLocalConfig();
@@ -40,7 +36,7 @@ export class AgentApiClient {
             globalConfig.backendUrl ||
             globalConfig.url ||
             DEFAULT_PLAYCRAFT_CLOUD_BASE).replace(/\/+$/, '');
-        // Token: 环境变量 → 沙箱全局配置 → 项目配置 → 用户登录配置
+        // Token: 沙箱 token 环境变量 → 本地 .playcraft.json → 全局 login 配置（PAT）
         const token = process.env.PLAYCRAFT_SANDBOX_TOKEN ||
             localConfig.token ||
             globalConfig.token ||
@@ -51,147 +47,43 @@ export class AgentApiClient {
         }
         this.apiUrl = apiUrl;
         this.token = token;
-        this.credentialFile = localConfig.credentialFile;
-        this.playcraftEnv = (process.env.PLAYCRAFT_ENV || localConfig.env || '').trim();
+        this.isPat = isPatToken(token);
+        this.playcraftEnv = (process.env.PLAYCRAFT_ENV ||
+            localConfig.env ||
+            '').trim();
     }
     /** 根据 token 类型构造鉴权 headers */
     authHeaders() {
-        let token = this.token;
-        // Polling commands can outlive a credential: read the atomically refreshed file per request.
-        if (this.credentialFile && !process.env.PLAYCRAFT_SANDBOX_TOKEN) {
-            try {
-                token = JSON.parse(readFileSync(this.credentialFile, 'utf8')).token || token;
-            }
-            catch { /* Keep the last credential if a local file is temporarily unavailable. */ }
-        }
-        const headers = isPatToken(token)
-            ? { Authorization: `Bearer ${token}` }
-            : { 'X-Sandbox-Token': token };
+        const headers = this.isPat
+            ? { Authorization: `Bearer ${this.token}` }
+            : { 'X-Sandbox-Token': this.token };
         if (this.playcraftEnv) {
             headers['playcraft-env'] = this.playcraftEnv;
         }
         return headers;
     }
-    /** Deployment-relative pathname under /api/agent/tools (path may omit leading slash). */
+    /** Absolute pathname under /api/agent/tools (path may omit leading slash). */
     toolsRequestUrl(path) {
         const p = path.startsWith('/') ? path : `/${path}`;
-        return businessEndpoint(this.apiUrl, `/api/agent/tools${p}`);
+        return new URL(`/api/agent/tools${p}`, this.apiUrl);
     }
-    async post(path, body, options) {
-        const url = this.toolsRequestUrl(path);
-        const serializedBody = JSON.stringify(body);
-        if (serializedBody === undefined)
-            throw new Error('Tool request body is required');
-        const recoverId = options?.requestId ?? process.env.PLAYCRAFT_TOOL_REQUEST_ID;
-        const operation = beginToolOperation(url.pathname, serializedBody, recoverId, {
-            newRequest: options?.newRequest ?? process.env.PLAYCRAFT_TOOL_NEW_REQUEST === '1',
+    async post(path, body) {
+        const url = this.toolsRequestUrl(path).href;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.authHeaders(),
+            },
+            body: JSON.stringify(body),
         });
-        const unknownOutcome = `Tool request ${operation.requestId}: the outcome is unknown. Rerun the same command to ` +
-            `continue this request: it returns the result if the request finished, or finishes it if ` +
-            `the tool can be safely redone; it never starts a second operation. Record: ${operation.file}.`;
-        try {
-            try {
-                await options?.onPrepared?.({ requestId: operation.requestId, file: operation.file });
-            }
-            catch {
-                operation.reject();
-                throw new ToolRequestError('Tool request preparation failed; no operation was sent');
-            }
-            const capabilityResponse = await fetch(this.toolsRequestUrl(AGENT_TOOL_OPERATION_CAPABILITIES_PATH), {
-                headers: this.authHeaders(),
-                redirect: 'error',
-                signal: options?.signal
-                    ? AbortSignal.any([options.signal, AbortSignal.timeout(30_000)])
-                    : AbortSignal.timeout(30_000),
-            });
-            if (!capabilityResponse.ok) {
-                if (capabilityResponse.status === 403) {
-                    const pending = pendingAccountActivationError(403, parseErrorPayload(await capabilityResponse.clone().text().catch(() => '')));
-                    if (pending) {
-                        if (operation.createdNew && !operation.settledOnly)
-                            operation.reject();
-                        throw pending;
-                    }
-                }
-                await capabilityResponse.body?.cancel();
-                throw new ToolRequestError(`Business tool protocol unavailable (${capabilityResponse.status}); no operation was sent`);
-            }
-            const capabilities = (await capabilityResponse.json());
-            if (capabilities.protocol !== AGENT_TOOL_OPERATION_PROTOCOL ||
-                capabilities.settledOnly !== true)
-                throw new ToolRequestError('Business tool protocol is incompatible; no operation was sent');
-            const res = await fetch(url, {
-                method: 'POST',
-                redirect: 'error',
-                signal: options?.signal
-                    ? AbortSignal.any([options.signal, AbortSignal.timeout(30 * 60_000)])
-                    : AbortSignal.timeout(30 * 60_000),
-                headers: {
-                    'Content-Type': 'application/json',
-                    ...this.authHeaders(),
-                    [AGENT_TOOL_OPERATION_HEADERS.protocol]: AGENT_TOOL_OPERATION_PROTOCOL,
-                    [AGENT_TOOL_OPERATION_HEADERS.requestId]: operation.requestId,
-                    ...(operation.settledOnly ? { [AGENT_TOOL_OPERATION_HEADERS.settledOnly]: 'true' } : {}),
-                },
-                body: serializedBody,
-            });
-            if (res.headers.get(AGENT_TOOL_OPERATION_HEADERS.protocol) !== AGENT_TOOL_OPERATION_PROTOCOL ||
-                res.headers.get(AGENT_TOOL_OPERATION_HEADERS.requestId) !== operation.requestId) {
-                if (res.status === 403) {
-                    const pending = pendingAccountActivationError(403, parseErrorPayload(await res.clone().text().catch(() => '')));
-                    if (pending) {
-                        if (operation.createdNew && !operation.settledOnly)
-                            operation.reject();
-                        throw pending;
-                    }
-                }
-                await res.body?.cancel();
-                // Possibly an instance that ignores identities: a rerun may only read the receipt.
-                operation.requireReceipt();
-                throw new Error('Business did not acknowledge a durable receipt; outcome remains unconfirmed');
-            }
-            if (!res.ok) {
-                const text = await res.text().catch(() => res.statusText);
-                const pending = pendingAccountActivationError(res.status, parseErrorPayload(text));
-                if (pending)
-                    throw pending;
-                const code = errorCode(text);
-                if (res.status === 409 && code === 'business_operation_in_progress')
-                    throw new ToolRequestError(`API 409: ${text}\nTool request ${operation.requestId} is still running. Rerun the ` +
-                        'same command later to get its result.');
-                if (res.status === 409 && code === 'business_operation_requires_reconciliation')
-                    throw new ToolRequestError(recoverId !== undefined
-                        ? // A receipt query never runs the request, even for a tool that can be safely redone.
-                            `API 409: ${text}\nTool request ${operation.requestId} has no settled result yet. ` +
-                                'Rerun the same command without PLAYCRAFT_TOOL_REQUEST_ID: a tool that can be ' +
-                                'safely redone continues this request; any other tool then needs reconciliation.'
-                        : `API 409: ${text}\nTool request ${operation.requestId} needs reconciliation: its ` +
-                            'outcome is unknown, and rerunning the same command will not run it again. Only ' +
-                            'after confirming it had no effect, rerun with PLAYCRAFT_TOOL_NEW_REQUEST=1 to ' +
-                            'start a new operation.');
-                if (res.status >= 400 && res.status < 500) {
-                    // The request itself was refused and not carried out: a rerun is a new operation.
-                    operation.reject();
-                    throw new ToolRequestError(`API ${res.status}: ${text}`);
-                }
-                throw new Error(`API ${res.status}: ${text}`);
-            }
-            const result = (await res.json());
-            operation.complete();
-            return result;
-        }
-        catch (error) {
-            if (error instanceof ToolRequestError || error instanceof AccountActivationError)
-                throw error;
-            throw new Error(`${error instanceof Error ? error.message : String(error)}\n${operation.settledOnly
-                ? `Tool request ${operation.requestId}; record: ${operation.file}. Its settled result is not available yet.`
-                : unknownOutcome}`);
-        }
-        finally {
-            operation.release();
+        if (!res.ok) {
+            const text = await res.text().catch(() => res.statusText);
+            throw new Error(`API ${res.status}: ${text}`);
         }
+        return res.json();
     }
-    async get(path, params, options) {
+    async get(path, params) {
         const url = this.toolsRequestUrl(path);
         if (params) {
             for (const [k, v] of Object.entries(params)) {
@@ -201,62 +93,27 @@ export class AgentApiClient {
         }
         const res = await fetch(url, {
             headers: this.authHeaders(),
-            redirect: 'error',
-            signal: options?.signal ?? AbortSignal.timeout(30_000),
         });
         if (!res.ok) {
             const text = await res.text().catch(() => res.statusText);
-            const pending = pendingAccountActivationError(res.status, parseErrorPayload(text));
-            if (pending)
-                throw pending;
             throw new Error(`API ${res.status}: ${text}`);
         }
         return res.json();
     }
-    /** Stream only to the authenticated, same-service video upload endpoint. */
-    async putVideoMedia(path, body, headers, signal) {
-        if (!/^\/video-media\/[a-f0-9-]{36}\/content\?/.test(path))
-            throw new Error('invalid_video_upload_target');
-        const url = this.toolsRequestUrl(path);
-        const keys = [...url.searchParams.keys()].sort();
-        if (keys.join(',') !== 'expires,signature,workspaceId')
-            throw new Error('invalid_video_upload_target');
-        const allowed = new Set(['content-type', 'content-md5', 'content-length']);
-        if (Object.keys(headers).some(key => !allowed.has(key.toLowerCase())))
-            throw new Error('invalid_video_upload_headers');
-        const response = await fetch(url, {
-            method: 'PUT', redirect: 'error', signal,
-            headers: { ...headers, ...this.authHeaders() },
-            body: body,
-            duplex: 'half',
-        });
-        if (!response.ok) {
-            await response.body?.cancel();
-            throw new Error(`video_upload_failed:${response.status}`);
-        }
-        await response.body?.cancel();
-    }
     /**
      * 按顺序搜索本地 .playcraft.json 文件（沙箱内或项目目录）。
      * 与全局 login 配置（~/.playcraft/config.json）不同，前者专用于沙箱 token。
      */
     static loadLocalConfig() {
-        const ancestors = [];
-        for (let directory = process.cwd();; directory = dirname(directory)) {
-            ancestors.push(join(directory, '.playcraft.json'));
-            if (dirname(directory) === directory)
-                break;
-        }
         const searchPaths = [
-            process.env.PLAYCRAFT_SANDBOX_CONFIG_PATH || '/workspaces/.playcraft.json',
-            ...ancestors,
+            join(process.cwd(), '.playcraft.json'),
             '/project/.playcraft.json',
             join(homedir(), '.playcraft.json'),
         ];
         for (const p of searchPaths) {
             if (existsSync(p)) {
                 try {
-                    return { ...JSON.parse(readFileSync(p, 'utf-8')), credentialFile: p };
+                    return JSON.parse(readFileSync(p, 'utf-8'));
                 }
                 catch {
                     continue;
@@ -266,15 +123,3 @@ export class AgentApiClient {
         return { apiUrl: '', token: '' };
     }
 }
-/** A failure whose meaning is settled; no recovery hint applies. */
-class ToolRequestError extends Error {
-}
-function errorCode(text) {
-    try {
-        const message = JSON.parse(text).message;
-        return typeof message === 'string' ? message : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}

package/dist/utils/image-asset-context.js

@@ -0,0 +1,105 @@
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import JSON5 from 'json5';
+import sharp from 'sharp';
+import { extractAssetFields, getByPath, resolveAiImageTargetConstraints, resolveImageBackgroundRequirement, THEME_SCHEMA_PATH, themeDataPath, } from '@playcraft/common/prefab';
+/** Resolve only real files in this project, including legacy /project aliases. */
+function projectFile(root, input) {
+    const mapped = input.startsWith('/project/') ? input.slice('/project/'.length) : input;
+    const file = path.resolve(root, mapped);
+    const prefix = path.resolve(root) + path.sep;
+    if (!file.startsWith(prefix))
+        throw new Error(`Image asset path is outside the project: ${input}`);
+    const real = realpathSync(file);
+    if (!real.startsWith(realpathSync(root) + path.sep))
+        throw new Error(`Image asset symlink is outside the project: ${input}`);
+    return file;
+}
+/** Read the same per-field constraints used by the asset image dialog. */
+export async function readImageAssetContext(assetPath, projectDir = process.cwd(), options = {}) {
+    const root = path.resolve(projectDir);
+    const target = projectFile(root, assetPath);
+    const relativeTarget = path.relative(root, target).replace(/\\/g, '/');
+    const themeMatch = relativeTarget.match(/^src\/theme\/([^/]+)\/assets\//);
+    let field;
+    const schemaFile = path.join(root, THEME_SCHEMA_PATH);
+    if (themeMatch && existsSync(schemaFile)) {
+        const schema = JSON5.parse(readFileSync(projectFile(root, THEME_SCHEMA_PATH), 'utf8'));
+        const dataPath = themeDataPath(themeMatch[1]);
+        const data = existsSync(path.join(root, dataPath))
+            ? JSON5.parse(readFileSync(projectFile(root, dataPath), 'utf8')) : {};
+        const themeRoot = path.dirname(path.join(root, dataPath));
+        const matches = extractAssetFields(schema, data).filter(candidate => {
+            let configured = getByPath(data, candidate.path);
+            if (configured === undefined && ['gameplay', 'gamePlay'].includes(candidate.path[0])) {
+                configured = getByPath(data, [candidate.path[0] === 'gameplay' ? 'gamePlay' : 'gameplay', ...candidate.path.slice(1)]);
+            }
+            const value = typeof configured === 'string' ? configured : candidate.schema.default;
+            if (typeof value !== 'string' || /^https?:\/\//i.test(value))
+                return false;
+            return path.resolve(themeRoot, value) === target;
+        });
+        if (matches.length > 1)
+            throw new Error('Multiple image fields use this asset; specify an unambiguous target asset.');
+        field = matches[0];
+        if (!field)
+            throw new Error(`No image schema field matches ${relativeTarget}; check theme.data.json5 before generating.`);
+    }
+    const xp = field?.schema.xplatform;
+    const ext = xp?.ext;
+    // Schema references follow the dialog's root/theme conventions; explicit tool paths do not change.
+    const schemaReferences = Array.isArray(ext?.reference_image)
+        ? ext.reference_image.filter(ref => typeof ref === 'string' && ref.trim()).map(ref => {
+            const raw = ref.trim().replace(/\\/g, '/');
+            const normalized = raw.replace(/^\.\/+/, '').replace(/^\/+/, '').replace(/\/{2,}/g, '/');
+            if (/^\/?(?:assets|src|public)\//.test(raw) || normalized.startsWith('src/'))
+                return normalized;
+            if (!themeMatch || path.isAbsolute(raw) || /^https?:\/\//i.test(raw))
+                return raw;
+            return path.posix.join('src/theme', themeMatch[1], normalized);
+        }) : [];
+    const referenceImagePaths = options.referenceImagePaths?.length ? options.referenceImagePaths
+        : options.useTargetReference === false ? [] : schemaReferences.length ? schemaReferences : [relativeTarget];
+    if (referenceImagePaths.length > 8)
+        throw new Error('At most 8 reference images are allowed.');
+    for (const ref of referenceImagePaths) {
+        if (/^https?:\/\//i.test(ref))
+            throw new Error('Download the schema reference into the project before generating.');
+        await sharp(projectFile(root, ref)).metadata();
+    }
+    const targetMeta = await sharp(target).metadata();
+    const hasSchemaBackground = typeof ext?.remove_background === 'boolean';
+    const targetStats = !hasSchemaBackground && targetMeta.hasAlpha ? await sharp(target).stats() : undefined;
+    const targetHasTransparency = !!targetStats && targetStats.channels.at(-1).min < 250;
+    const removeBackground = resolveImageBackgroundRequirement({
+        prompt: options.prompt ?? '',
+        schemaRemoveBackground: hasSchemaBackground ? ext.remove_background : undefined,
+        removeBackground: options.removeBackground,
+        fallbackRemoveBackground: targetHasTransparency,
+    });
+    const delivery = resolveAiImageTargetConstraints({
+        schemaResolution: ext?.resolution,
+        schemaMimeType: xp?.mime_type,
+        schemaFitMode: xp?.fit_mode ?? ext?.fit_mode,
+        schemaRemoveBackground: removeBackground,
+        schemaPaddingColor: ext?.padding_color,
+        assetPath: relativeTarget,
+        referenceWidth: targetMeta.width,
+        referenceHeight: targetMeta.height,
+        referenceFormat: targetMeta.format,
+    });
+    if (!['png', 'webp', 'jpeg'].includes(delivery.format))
+        throw new Error('Unsupported image delivery format; use a dedicated animation or vector workflow.');
+    return {
+        targetAssetPath: relativeTarget,
+        fieldPath: field?.path,
+        referenceImagePaths,
+        width: delivery.width, height: delivery.height,
+        aspectRatio: typeof ext?.ratio === 'string' ? ext.ratio : `${delivery.width}:${delivery.height}`,
+        outputFormat: (removeBackground && delivery.format === 'jpeg' && !delivery.fromSchemaMimeType
+            ? 'png' : delivery.format),
+        fitMode: delivery.fitMode, removeBackground: delivery.removeBackground, paddingColor: delivery.paddingColor,
+        removeBackgroundFromSchema: hasSchemaBackground,
+        imageModelRef: typeof ext?.imageModelRef === 'string' ? ext.imageModelRef : undefined,
+    };
+}

package/dist/utils/playcraft-http-client.js

@@ -1,7 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { loadGlobalConfig } from '../config.js';
 import { DEFAULT_PLAYCRAFT_CLOUD_BASE } from '../commands/login.js';
-import { pendingAccountActivationError } from '../auth/account-activation.js';
 export class PlayCraftApiError extends Error {
     code;
     status;
@@ -96,20 +95,19 @@ export class PlayCraftHttpClient {
                 }
                 if (!response.ok) {
                     const error = payload?.error;
-                    const pending = pendingAccountActivationError(response.status, payload);
-                    const code = pending?.code ?? (typeof error?.code === 'string' ? error.code : statusCode(response.status));
-                    const message = pending?.message ?? (typeof error?.message === 'string'
+                    const code = typeof error?.code === 'string' ? error.code : statusCode(response.status);
+                    const message = typeof error?.message === 'string'
                         ? error.message
                         : typeof payload?.message === 'string'
                             ? payload.message
                             : typeof payload === 'string'
                                 ? payload
-                                : response.statusText || 'PlayCraft request failed');
+                                : response.statusText || 'PlayCraft request failed';
                     throw new PlayCraftApiError({
                         code,
                         message,
                         status: response.status,
-                        details: pending ? { loginCommand: 'playcraft login --activate' } : error?.details ?? payload,
+                        details: error?.details ?? payload,
                         retryable: response.status >= 500,
                     });
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/cli",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "private": false,
   "type": "module",
   "engines": {
@@ -14,7 +14,6 @@
     "dist",
     "templates",
     "project-template",
-    "project-template-v2",
     "engine-packs",
     "project-templates",
     "REMIX.md",
@@ -22,9 +21,9 @@
   ],
   "scripts": {
     "dev": "tsc -w",
-    "build": "node scripts/generate-video-skills.mjs && tsc",
+    "build": "tsc",
     "start": "node dist/index.js",
-    "test": "pnpm build && vitest run",
+    "test": "vitest run",
     "test:agent": "node scripts/run-agent-tests.mjs --list",
     "test:agent:designer": "node scripts/run-agent-tests.mjs game-designer",
     "test:agent:developer": "node scripts/run-agent-tests.mjs developer",
@@ -36,10 +35,6 @@
     "test:agent:gate": "node scripts/run-agent-tests.mjs gate",
     "test:agent:vlm": "node scripts/run-agent-tests.mjs vlm",
     "test:agent:stop": "node scripts/run-agent-tests.mjs stop",
-    "generate:platform-skills": "node scripts/generate-platform-skills.mjs",
-    "verify:platform-skills": "node scripts/generate-platform-skills.mjs --check",
-    "generate:video-skills": "node scripts/generate-video-skills.mjs",
-    "verify:video-skills": "node scripts/generate-video-skills.mjs --check && node --test scripts/generate-video-skills.test.mjs",
     "verify:agent-stop": "node scripts/verify-agent-stop.mjs",
     "verify-sprite-overlay": "node scripts/verify-sprite-overlay.mjs",
     "link": "node scripts/bump-local.js && pnpm build && npm link",
@@ -52,7 +47,6 @@
     "@gltf-transform/functions": "^4.3.0",
     "@playcraft/build": "^0.1.28",
     "@playcraft/common": "^0.1.28",
-    "better-sqlite3-pinned": "npm:better-sqlite3@13.0.3",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "cors": "^2.8.6",
@@ -68,10 +62,8 @@
     "json5": "^2.2.3",
     "latest-version": "^7.0.0",
     "music-metadata": "^11.12.3",
-    "node-pty": "1.0.0",
     "ora": "^8.2.0",
     "picocolors": "^1.1.1",
-    "playwright-core": "1.52.0",
     "sharp": "^0.34.5",
     "update-notifier": "^7.3.1",
     "ws": "^8.19.0",
@@ -87,7 +79,6 @@
     "@types/sharp": "^0.32.0",
     "@types/update-notifier": "^6.0.8",
     "@types/ws": "^8.18.1",
-    "esbuild": "^0.28.1",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4"
   }