@playcraft/cli 0.1.85-beta → 0.1.86

package/dist/commands/tools-request.js

@@ -0,0 +1,24 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { AgentApiClient } from '../utils/agent-api-client.js';
+export async function toolRequestCommand(operation, serializedBody) {
+    if (!['generate-image', 'generate-bgm', 'generate-sfx'].includes(operation))
+        throw new Error('Unsupported generation operation');
+    const body = JSON.parse(serializedBody);
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        throw new Error('Generation request must be a JSON object');
+    return new AgentApiClient({
+        configFile: process.env.PLAYCRAFT_SANDBOX_CONFIG_PATH || join(process.cwd(), '.playcraft.json'),
+        operationNamespace: 'opencode',
+    }).post(`/${operation}`, body);
+}
+/** Static sandbox plugins cannot import command-line modules; use this client for transport. */
+export function registerToolRequestCommand(tools) {
+    tools
+        .command('request <operation>', { hidden: true })
+        .description('Send a generation request from JSON on stdin and print its durable result as JSON')
+        .action(async (operation) => {
+        const result = await toolRequestCommand(operation, readFileSync(0, 'utf8'));
+        process.stdout.write(`${JSON.stringify(result)}\n`);
+    });
+}

package/dist/commands/tools.js

@@ -6,11 +6,13 @@ import { registerDetectCommand } from './tools-detect.js';
 import { registerVideoReviewCommand } from './tools-video-review.js';
 import { registerImageContextCommand } from './tools-image-context.js';
 import { registerContextCommands } from './tools-context.js';
+import { registerToolRequestCommand } from './tools-request.js';
 export function registerToolsCommands(program) {
     const tools = program
         .command('tools')
         .description('后端 /api/agent/tools；运行 playcraft login 后即可直接使用，也支持 .playcraft.json 或 PLAYCRAFT_SANDBOX_TOKEN 环境变量');
     registerGenerationCommands(tools);
+    registerToolRequestCommand(tools);
     registerImageContextCommand(tools);
     registerProjectCommands(tools);
     registerBatchCommands(tools);

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

@@ -1,10 +1,10 @@
 import { readFileSync, existsSync } from 'fs';
 import { createWriteStream } from 'node:fs';
 import { link, mkdir, stat, unlink } from 'node:fs/promises';
-import { randomUUID } from 'node:crypto';
+import { createHash, randomUUID } from 'node:crypto';
 import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
-import { dirname, join } from 'path';
+import { dirname, join, resolve } from 'path';
 import { homedir } from 'os';
 import { loadGlobalConfig } from '../config.js';
 import { DEFAULT_PLAYCRAFT_CLOUD_BASE } from '../commands/login.js';
@@ -41,20 +41,28 @@ export class AgentApiClient {
     credentialFile;
     playcraftEnv;
     cloudRuntimeCredential;
-    constructor() {
-        const localConfig = AgentApiClient.loadLocalConfig();
-        const globalConfig = loadGlobalConfig();
+    explicitConfig;
+    operationDirectory;
+    constructor(options = {}) {
+        const localConfig = options.configFile
+            ? AgentApiClient.requireLocalConfig(options.configFile)
+            : AgentApiClient.loadLocalConfig();
+        const globalConfig = options.configFile ? {} : loadGlobalConfig();
         // URL: 环境变量 → 本地 .playcraft.json → 全局 login 配置 → 公有云默认地址
-        const apiUrl = (process.env.PLAYCRAFT_API_URL ||
-            localConfig.apiUrl ||
-            globalConfig.backendUrl ||
-            globalConfig.url ||
-            DEFAULT_PLAYCRAFT_CLOUD_BASE).replace(/\/+$/, '');
+        const apiUrl = (options.configFile
+            ? localConfig.apiUrl
+            : process.env.PLAYCRAFT_API_URL ||
+                localConfig.apiUrl ||
+                globalConfig.backendUrl ||
+                globalConfig.url ||
+                DEFAULT_PLAYCRAFT_CLOUD_BASE).replace(/\/+$/, '');
         // Token: 环境变量 → 沙箱全局配置 → 项目配置 → 用户登录配置
-        const token = process.env.PLAYCRAFT_SANDBOX_TOKEN ||
-            localConfig.token ||
-            globalConfig.token ||
-            '';
+        const token = options.configFile
+            ? localConfig.token
+            : process.env.PLAYCRAFT_SANDBOX_TOKEN ||
+                localConfig.token ||
+                globalConfig.token ||
+                '';
         if (!token) {
             throw new Error('Missing PlayCraft API credentials. ' +
                 'Run `playcraft login` to authenticate, or set PLAYCRAFT_SANDBOX_TOKEN / create a .playcraft.json file.');
@@ -62,14 +70,29 @@ export class AgentApiClient {
         this.apiUrl = apiUrl;
         this.token = token;
         this.credentialFile = localConfig.credentialFile;
-        this.playcraftEnv = (process.env.PLAYCRAFT_ENV || localConfig.env || '').trim();
+        this.explicitConfig = Boolean(options.configFile);
+        this.playcraftEnv = (options.configFile
+            ? localConfig.env || process.env.PLAYCRAFT_ENV || ''
+            : process.env.PLAYCRAFT_ENV || localConfig.env || '').trim();
         this.cloudRuntimeCredential = cloudRuntimeCredentialHint(token, token === localConfig.token ? localConfig : undefined);
+        if (options.operationNamespace) {
+            if (!options.configFile)
+                throw new Error('Operation namespace requires an explicit sandbox configuration');
+            const scope = JSON.stringify([
+                resolve(options.configFile),
+                apiUrl,
+                this.playcraftEnv,
+                localConfig.projectId,
+                localConfig.branch,
+            ]);
+            this.operationDirectory = join(process.env.PLAYCRAFT_TOOL_REQUEST_DIR ?? join(homedir(), '.playcraft', 'tool-requests'), options.operationNamespace, createHash('sha256').update(scope).digest('hex'));
+        }
     }
     /** 根据 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) {
+        if (this.credentialFile && (this.explicitConfig || !process.env.PLAYCRAFT_SANDBOX_TOKEN)) {
             try {
                 token = JSON.parse(readFileSync(this.credentialFile, 'utf8')).token || token;
             }
@@ -96,12 +119,12 @@ export class AgentApiClient {
         const recoverId = options?.requestId ?? process.env.PLAYCRAFT_TOOL_REQUEST_ID;
         const newRequest = options?.newRequest ?? process.env.PLAYCRAFT_TOOL_NEW_REQUEST === '1';
         const originalReceipt = recoverId !== undefined && !newRequest && isWorkspaceGenerationPath(path)
-            ? findToolOperation(url.pathname, originalBody, recoverId) : undefined;
+            ? findToolOperation(url.pathname, originalBody, recoverId, this.operationDirectory) : undefined;
         let serializedBody = originalReceipt ? originalBody : JSON.stringify(await withGenerationWorkspaceScope(path, body, this.cloudRuntimeCredential));
         if (serializedBody === undefined)
             throw new Error('Tool request body is required');
         if (serializedBody !== originalBody && !newRequest) {
-            const previous = findToolOperation(url.pathname, originalBody, recoverId);
+            const previous = findToolOperation(url.pathname, originalBody, recoverId, this.operationDirectory);
             if (previous && recoverId !== undefined)
                 serializedBody = originalBody;
             else if (previous)
@@ -110,6 +133,7 @@ export class AgentApiClient {
         }
         const operation = beginToolOperation(url.pathname, serializedBody, recoverId, {
             newRequest,
+            directory: this.operationDirectory,
         });
         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 ` +
@@ -384,6 +408,21 @@ export class AgentApiClient {
         }
         return { apiUrl: '', token: '' };
     }
+    /** A static plugin's slot must never fall back to another workspace or a global login. */
+    static requireLocalConfig(file) {
+        try {
+            const config = JSON.parse(readFileSync(file, 'utf8'));
+            if (typeof config?.apiUrl !== 'string' ||
+                !config.apiUrl.trim() ||
+                typeof config.token !== 'string' ||
+                !config.token.trim())
+                throw new Error('invalid');
+            return { ...config, credentialFile: file };
+        }
+        catch {
+            throw new Error('A valid project .playcraft.json with apiUrl and token is required; no generation request was sent');
+        }
+    }
 }
 /** A failure whose meaning is settled; no recovery hint applies. */
 class ToolRequestError extends Error {

package/dist/utils/tool-operation-journal.js

@@ -29,7 +29,7 @@ function holderAlive(holder) {
 }
 /** Persist an identity before sending. Store neither credentials nor request/response bodies. */
 export function beginToolOperation(path, serializedBody, recoverId, options = {}) {
-    const directory = process.env.PLAYCRAFT_TOOL_REQUEST_DIR ?? join(homedir(), '.playcraft', 'tool-requests');
+    const directory = options.directory ?? process.env.PLAYCRAFT_TOOL_REQUEST_DIR ?? join(homedir(), '.playcraft', 'tool-requests');
     if (!isAbsolute(directory))
         throw new Error('PLAYCRAFT_TOOL_REQUEST_DIR must be an absolute path');
     mkdirSync(directory, { recursive: true, mode: 0o700 });
@@ -98,8 +98,8 @@ export function beginToolOperation(path, serializedBody, recoverId, options = {}
     };
 }
 /** Read an existing identity without creating an intent or changing its receipt state. */
-export function findToolOperation(path, serializedBody, requestId) {
-    const directory = process.env.PLAYCRAFT_TOOL_REQUEST_DIR ?? join(homedir(), '.playcraft', 'tool-requests');
+export function findToolOperation(path, serializedBody, requestId, directoryOverride) {
+    const directory = directoryOverride ?? process.env.PLAYCRAFT_TOOL_REQUEST_DIR ?? join(homedir(), '.playcraft', 'tool-requests');
     if (!isAbsolute(directory))
         throw new Error('PLAYCRAFT_TOOL_REQUEST_DIR must be an absolute path');
     const inputHash = createHash('sha256').update(serializedBody).digest('hex');