@walkhi/code-relax 0.1.0-beta.50 → 0.1.0-beta.51

package/dist/src/managed-endpoint.mjs

@@ -1,25 +1,25 @@
-import path from 'node:path';
-import { readRecord } from './service-lifecycle.mjs';
-
-export const defaultManagedPort = 45839;
-export function managedEndpointUrl(value) {
-  if (typeof value !== 'string' || !/^ws:\/\/127\.0\.0\.1:[1-9][0-9]{0,4}$/.test(value)) return null;
-  const port = Number(value.slice(value.lastIndexOf(':') + 1));
-  return port <= 65535 ? `ws://127.0.0.1:${port}` : null;
-}
-export function managedProcessUrl(record) {
-  if (!record) return null;
-  let value;
-  if (Array.isArray(record.args)) {
-    if (record.args.length !== 4 || record.args[1] !== 'app-server' || record.args[2] !== '--listen') return null;
-    value = record.args[3];
-  } else {
-    const match = /^\s*(?:"[^"]+"|\S+)\s+app-server\s+--listen\s+(?:"(ws:\/\/127\.0\.0\.1:[0-9]+)"|(ws:\/\/127\.0\.0\.1:[0-9]+))\s*$/i.exec(record.command || '');
-    value = match?.[1] || match?.[2];
-  }
-  const url = managedEndpointUrl(value);
-  return url && (!record.url || record.url === url) ? url : null;
-}
-export function readManagedEndpoint(stateRoot) {
-  return managedProcessUrl(readRecord(path.join(stateRoot, 'managed-app-server.json')));
-}
+import path from 'node:path';
+import { readRecord } from './service-lifecycle.mjs';
+
+export const defaultManagedPort = 45839;
+export function managedEndpointUrl(value) {
+  if (typeof value !== 'string' || !/^ws:\/\/127\.0\.0\.1:[1-9][0-9]{0,4}$/.test(value)) return null;
+  const port = Number(value.slice(value.lastIndexOf(':') + 1));
+  return port <= 65535 ? `ws://127.0.0.1:${port}` : null;
+}
+export function managedProcessUrl(record) {
+  if (!record) return null;
+  let value;
+  if (Array.isArray(record.args)) {
+    if (record.args.length !== 4 || record.args[1] !== 'app-server' || record.args[2] !== '--listen') return null;
+    value = record.args[3];
+  } else {
+    const match = /^\s*(?:"[^"]+"|\S+)\s+app-server\s+--listen\s+(?:"(ws:\/\/127\.0\.0\.1:[0-9]+)"|(ws:\/\/127\.0\.0\.1:[0-9]+))\s*$/i.exec(record.command || '');
+    value = match?.[1] || match?.[2];
+  }
+  const url = managedEndpointUrl(value);
+  return url && (!record.url || record.url === url) ? url : null;
+}
+export function readManagedEndpoint(stateRoot) {
+  return managedProcessUrl(readRecord(path.join(stateRoot, 'managed-app-server.json')));
+}

package/dist/src/message-upload-files.mjs

@@ -1,109 +1,109 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import crypto from 'node:crypto';
-import sharp from 'sharp';
-import media from '../shared/code-browser.cjs';
-import { validateInlineImage } from './message-images.mjs';
-import { createFileUploadSession, FILE_CHUNK_BYTES, MAX_FILE_BYTES, MAX_FILE_COUNT, MAX_TOTAL_BYTES } from './file-upload-session.mjs';
-import { fileRevision } from './file-transfer-range.mjs';
-
-const mimeTypes = { pdf: 'application/pdf', txt: 'text/plain', md: 'text/markdown', csv: 'text/csv',
-  json: 'application/json', zip: 'application/zip', doc: 'application/msword',
-  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-  xls: 'application/vnd.ms-excel', xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-  ppt: 'application/vnd.ms-powerpoint', pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation' };
-
-// Reuse the incoming-file contract without sending workstation bytes to the phone.
-export async function stageWorkstationMessageFile(file, uploadsRoot) {
-  const handle = await fs.open(file.path, 'r');
-  const session = createFileUploadSession(uploadsRoot);
-  try {
-    const stat = await handle.stat();
-    if (!stat.isFile() || stat.size < 1 || stat.size > MAX_FILE_BYTES) throw new Error('附件为空或超过 20 MiB。');
-    const validate = async () => {
-      if (fileRevision(await handle.stat()) !== file.revision || fileRevision(await fs.stat(file.path)) !== file.revision) {
-        throw new Error('电脑文件已变化，请重新添加。');
-      }
-    };
-    await validate();
-    const bytes = Buffer.alloc(stat.size);
-    for (let offset = 0; offset < bytes.length;) {
-      const { bytesRead } = await handle.read(bytes, offset, bytes.length - offset, offset);
-      if (!bytesRead) throw new Error('电脑文件读取不完整，请重新添加。');
-      offset += bytesRead;
-    }
-    await validate();
-    const sha256 = crypto.createHash('sha256').update(bytes).digest('hex');
-    const started = await session.receive({ type: 'start', name: file.name, size: bytes.length, sha256 });
-    for (let offset = 0; offset < bytes.length; offset += FILE_CHUNK_BYTES) {
-      await session.receive({ type: 'chunk', id: started.id, offset, data: bytes.subarray(offset, offset + FILE_CHUNK_BYTES) });
-    }
-    await validate();
-    const result = await session.receive({ type: 'finish', id: started.id });
-    await session.receive({ type: 'commit' });
-    return { ...result, mediaKind: media.mediaKind(file),
-      mimeType: media.mediaMime(file) || mimeTypes[path.extname(file.name).slice(1).toLowerCase()] || 'application/octet-stream' };
-  } finally { await handle.close(); await session.close(); }
-}
-
-async function localFile(file, directory) {
-  if (typeof file?.path !== 'string' || typeof file.name !== 'string' || !file.name || /[\r\n\0]/.test(file.name)) {
-    throw new Error('附件信息无效，请重新选择。');
-  }
-  const root = await fs.realpath(directory), resolved = await fs.realpath(file.path);
-  if (path.relative(root, path.dirname(resolved)) !== '') throw new Error('附件必须来自本次工作站上传目录。');
-  const handle = await fs.open(resolved, 'r');
-  try {
-    const stat = await handle.stat();
-    if (!stat.isFile() || stat.size < 1 || stat.size > MAX_FILE_BYTES) throw new Error('附件为空或超过 20 MiB。');
-    const bytes = await handle.readFile();
-    if (bytes.length !== stat.size) throw new Error('附件在读取时发生变化，请重新上传。');
-    const mimeType = media.mediaMime(file) || mimeTypes[path.extname(file.name).slice(1).toLowerCase()] || 'application/octet-stream';
-    if (!/^[a-z0-9.+-]+\/[a-z0-9.+-]+$/i.test(mimeType)) throw new Error('附件类型无效。');
-    return { name: file.name, mimeType, bytes };
-  } finally { await handle.close(); }
-}
-
-export async function readMessageUploads(body, uploadsRoot) {
-  const images = body.images ?? [], originals = body.originalImages ?? [], files = body.files ?? [];
-  if (![images, originals, files].every(Array.isArray) || images.length + originals.length > 4 || files.length + originals.length > MAX_FILE_COUNT) {
-    throw new Error('每条消息最多 4 张图片、4 个文件。');
-  }
-  const uploads = [];
-  let imageBytes = 0, fileBytes = 0;
-  for (const image of images) {
-    let file;
-    if (typeof image === 'string' && image.startsWith('data:')) {
-      validateInlineImage(image);
-      const mimeType = image.slice(5, image.indexOf(';'));
-      file = { name: `image.${mimeType.split('/')[1]}`, mimeType, bytes: Buffer.from(image.slice(image.indexOf(',') + 1), 'base64') };
-    } else {
-      if (typeof image !== 'string' || !/^[a-f0-9]{64}$/.test(image)) throw new Error('图片标识无效。');
-      let extension = 'webp';
-      try { await fs.access(path.join(uploadsRoot, `${image}.webp`)); }
-      catch (error) { if (error.code !== 'ENOENT') throw error; extension = 'png'; }
-      file = await localFile({ path: path.join(uploadsRoot, `${image}.${extension}`), name: `image.${extension}` }, uploadsRoot);
-    }
-    imageBytes += file.bytes.length;
-    if (imageBytes > 8 * 1024 * 1024) throw new Error('压缩图片合计不能超过 8 MiB。');
-    uploads.push(file);
-  }
-  for (const original of originals) {
-    if (typeof original !== 'string' || !/\.(png|jpe?g|webp|gif)$/i.test(original)) throw new Error('原图路径无效。');
-  }
-  for (const file of [...originals.map(value => ({ path: value, name: path.basename(value) })), ...files]) {
-    const uploaded = await localFile(file, path.join(uploadsRoot, 'incoming'));
-    fileBytes += uploaded.bytes.length;
-    if (fileBytes > MAX_TOTAL_BYTES) throw new Error('文件合计不能超过 40 MiB。');
-    uploads.push(uploaded);
-  }
-  for (const file of uploads) {
-    if (/^image\/(?:png|jpeg|webp|gif)$/.test(file.mimeType)) {
-      const metadata = await sharp(file.bytes).metadata();
-      file.width = metadata.width; file.height = metadata.height;
-      if (!file.width || !file.height) throw new Error('无法读取 图片尺寸。');
-    }
-  }
-  if (uploads.filter(file => file.width).length > 4) throw new Error('每条消息最多 4 张图片。');
-  return uploads;
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import sharp from 'sharp';
+import media from '../shared/code-browser.cjs';
+import { validateInlineImage } from './message-images.mjs';
+import { createFileUploadSession, FILE_CHUNK_BYTES, MAX_FILE_BYTES, MAX_FILE_COUNT, MAX_TOTAL_BYTES } from './file-upload-session.mjs';
+import { fileRevision } from './file-transfer-range.mjs';
+
+const mimeTypes = { pdf: 'application/pdf', txt: 'text/plain', md: 'text/markdown', csv: 'text/csv',
+  json: 'application/json', zip: 'application/zip', doc: 'application/msword',
+  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+  xls: 'application/vnd.ms-excel', xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+  ppt: 'application/vnd.ms-powerpoint', pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation' };
+
+// Reuse the incoming-file contract without sending workstation bytes to the phone.
+export async function stageWorkstationMessageFile(file, uploadsRoot) {
+  const handle = await fs.open(file.path, 'r');
+  const session = createFileUploadSession(uploadsRoot);
+  try {
+    const stat = await handle.stat();
+    if (!stat.isFile() || stat.size < 1 || stat.size > MAX_FILE_BYTES) throw new Error('附件为空或超过 20 MiB。');
+    const validate = async () => {
+      if (fileRevision(await handle.stat()) !== file.revision || fileRevision(await fs.stat(file.path)) !== file.revision) {
+        throw new Error('电脑文件已变化，请重新添加。');
+      }
+    };
+    await validate();
+    const bytes = Buffer.alloc(stat.size);
+    for (let offset = 0; offset < bytes.length;) {
+      const { bytesRead } = await handle.read(bytes, offset, bytes.length - offset, offset);
+      if (!bytesRead) throw new Error('电脑文件读取不完整，请重新添加。');
+      offset += bytesRead;
+    }
+    await validate();
+    const sha256 = crypto.createHash('sha256').update(bytes).digest('hex');
+    const started = await session.receive({ type: 'start', name: file.name, size: bytes.length, sha256 });
+    for (let offset = 0; offset < bytes.length; offset += FILE_CHUNK_BYTES) {
+      await session.receive({ type: 'chunk', id: started.id, offset, data: bytes.subarray(offset, offset + FILE_CHUNK_BYTES) });
+    }
+    await validate();
+    const result = await session.receive({ type: 'finish', id: started.id });
+    await session.receive({ type: 'commit' });
+    return { ...result, mediaKind: media.mediaKind(file),
+      mimeType: media.mediaMime(file) || mimeTypes[path.extname(file.name).slice(1).toLowerCase()] || 'application/octet-stream' };
+  } finally { await handle.close(); await session.close(); }
+}
+
+async function localFile(file, directory) {
+  if (typeof file?.path !== 'string' || typeof file.name !== 'string' || !file.name || /[\r\n\0]/.test(file.name)) {
+    throw new Error('附件信息无效，请重新选择。');
+  }
+  const root = await fs.realpath(directory), resolved = await fs.realpath(file.path);
+  if (path.relative(root, path.dirname(resolved)) !== '') throw new Error('附件必须来自本次工作站上传目录。');
+  const handle = await fs.open(resolved, 'r');
+  try {
+    const stat = await handle.stat();
+    if (!stat.isFile() || stat.size < 1 || stat.size > MAX_FILE_BYTES) throw new Error('附件为空或超过 20 MiB。');
+    const bytes = await handle.readFile();
+    if (bytes.length !== stat.size) throw new Error('附件在读取时发生变化，请重新上传。');
+    const mimeType = media.mediaMime(file) || mimeTypes[path.extname(file.name).slice(1).toLowerCase()] || 'application/octet-stream';
+    if (!/^[a-z0-9.+-]+\/[a-z0-9.+-]+$/i.test(mimeType)) throw new Error('附件类型无效。');
+    return { name: file.name, mimeType, bytes };
+  } finally { await handle.close(); }
+}
+
+export async function readMessageUploads(body, uploadsRoot) {
+  const images = body.images ?? [], originals = body.originalImages ?? [], files = body.files ?? [];
+  if (![images, originals, files].every(Array.isArray) || images.length + originals.length > 4 || files.length + originals.length > MAX_FILE_COUNT) {
+    throw new Error('每条消息最多 4 张图片、4 个文件。');
+  }
+  const uploads = [];
+  let imageBytes = 0, fileBytes = 0;
+  for (const image of images) {
+    let file;
+    if (typeof image === 'string' && image.startsWith('data:')) {
+      validateInlineImage(image);
+      const mimeType = image.slice(5, image.indexOf(';'));
+      file = { name: `image.${mimeType.split('/')[1]}`, mimeType, bytes: Buffer.from(image.slice(image.indexOf(',') + 1), 'base64') };
+    } else {
+      if (typeof image !== 'string' || !/^[a-f0-9]{64}$/.test(image)) throw new Error('图片标识无效。');
+      let extension = 'webp';
+      try { await fs.access(path.join(uploadsRoot, `${image}.webp`)); }
+      catch (error) { if (error.code !== 'ENOENT') throw error; extension = 'png'; }
+      file = await localFile({ path: path.join(uploadsRoot, `${image}.${extension}`), name: `image.${extension}` }, uploadsRoot);
+    }
+    imageBytes += file.bytes.length;
+    if (imageBytes > 8 * 1024 * 1024) throw new Error('压缩图片合计不能超过 8 MiB。');
+    uploads.push(file);
+  }
+  for (const original of originals) {
+    if (typeof original !== 'string' || !/\.(png|jpe?g|webp|gif)$/i.test(original)) throw new Error('原图路径无效。');
+  }
+  for (const file of [...originals.map(value => ({ path: value, name: path.basename(value) })), ...files]) {
+    const uploaded = await localFile(file, path.join(uploadsRoot, 'incoming'));
+    fileBytes += uploaded.bytes.length;
+    if (fileBytes > MAX_TOTAL_BYTES) throw new Error('文件合计不能超过 40 MiB。');
+    uploads.push(uploaded);
+  }
+  for (const file of uploads) {
+    if (/^image\/(?:png|jpeg|webp|gif)$/.test(file.mimeType)) {
+      const metadata = await sharp(file.bytes).metadata();
+      file.width = metadata.width; file.height = metadata.height;
+      if (!file.width || !file.height) throw new Error('无法读取 图片尺寸。');
+    }
+  }
+  if (uploads.filter(file => file.width).length > 4) throw new Error('每条消息最多 4 张图片。');
+  return uploads;
+}

package/dist/src/onboarding.mjs

@@ -1,12 +1,12 @@
-export function phonePairingSteps(_transportMode, paired = false) {
-  return paired ? ['已配对设备可直接连接。添加设备：relax pair']
-    : ['生成配对二维码：relax pair', '用 Code Relax App 扫码添加工作站。'];
-}
-export const desktopSetupSteps = [
-  '工作站服务和 Codex 内核已就绪，已启用登录自启。',
-  '生成配对二维码：relax pair',
-];
-
-export function pairingDisplayText(nextSteps) {
-  return ['Code Relax 工作站已启动。', ...nextSteps].join('\n');
-}
+export function phonePairingSteps(_transportMode, paired = false) {
+  return paired ? ['已配对设备可直接连接。添加设备：relax pair']
+    : ['生成配对二维码：relax pair', '用 Code Relax App 扫码添加工作站。'];
+}
+export const desktopSetupSteps = [
+  '工作站服务和 Codex 内核已就绪，已启用登录自启。',
+  '生成配对二维码：relax pair',
+];
+
+export function pairingDisplayText(nextSteps) {
+  return ['Code Relax 工作站已启动。', ...nextSteps].join('\n');
+}

package/dist/src/platform/README.md

@@ -9,4 +9,4 @@
 
 Windows 专有脚本兼容系统自带 PowerShell 5.1。通用生命周期使用 Node 接口；系统检测和凭据保护不扩散到业务代码。
 
-macOS、Linux 目录仅保留规划说明，尚无路径、IPC、进程或安装实现。接入排在控制端扩展之后，并需分别验证 Codex Desktop/app-server 的可用连接方式；只有独立 app-server 时不能宣称接管 Desktop 当前任务。
+macOS、Linux 目录仅保留规划说明，尚无路径、IPC、进程或安装实现。接入排在控制端扩展之后，并需分别验证 Codex Desktop/app-server 的可用连接方式；只有独立 app-server 时不能宣称接管 Desktop 当前任务。

package/dist/src/platform/codex-protocol.mjs

@@ -1,46 +1,46 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-
-const exec = promisify(execFile);
-const requiredMethods = ['thread/start', 'thread/resume', 'thread/list', 'thread/turns/list',
-  'thread/items/list', 'turn/start', 'turn/steer', 'turn/interrupt', 'model/list', 'project/list',
-  'project/create', 'project/update', 'project/move',
-  'fs/getMetadata', 'fs/readDirectory', 'fs/createDirectory', 'command/exec',
-  'thread/settings/update', 'configRequirements/read', 'thread/queue/list', 'thread/queue/add',
-  'thread/queue/delete', 'thread/queue/start', 'thread/read', 'thread/unsubscribe', 'config/read', 'account/rateLimits/read'];
-
-export function compareVersions(a, b) {
-  const parse = v => v.split(/[.-]/).map(part => /^\d+$/.test(part) ? Number(part) : part);
-  const aa = parse(a), bb = parse(b);
-  for (let i = 0; i < Math.max(aa.length, bb.length); i++) {
-    if (aa[i] === bb[i]) continue;
-    if (aa[i] === undefined) return 1;
-    if (bb[i] === undefined) return -1;
-    return typeof aa[i] === 'number' && typeof bb[i] === 'number' ? aa[i] - bb[i] : String(aa[i]).localeCompare(String(bb[i]));
-  }
-  return 0;
-}
-
-export async function verifyProtocol(executable, stateRoot) {
-  const directory = fs.mkdtempSync(path.join(stateRoot, 'cli-schema-'));
-  try {
-    await exec(executable, ['app-server', 'generate-json-schema', '--experimental', '--out', directory],
-      { windowsHide: true, timeout: 30000, maxBuffer: 4 * 1024 * 1024 });
-    const request = fs.readFileSync(path.join(directory, 'ClientRequest.json'), 'utf8');
-    const missing = requiredMethods.filter(method => !request.includes(`"${method}"`));
-    const turns = fs.readFileSync(path.join(directory, 'v2/ThreadTurnsListParams.json'), 'utf8');
-    if (!turns.includes('"itemsView"') || !turns.includes('"summary"')) missing.push('turn summary pagination');
-    if (missing.length) throw new Error(`缺少协议能力：${missing.join(', ')}`);
-  } finally {
-    const remove = dir => {
-      for (const item of fs.readdirSync(dir, { withFileTypes: true })) {
-        const file = path.join(dir, item.name);
-        if (item.isDirectory()) remove(file); else fs.unlinkSync(file);
-      }
-      fs.rmdirSync(dir);
-    };
-    remove(directory);
-  }
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+
+const exec = promisify(execFile);
+const requiredMethods = ['thread/start', 'thread/resume', 'thread/list', 'thread/turns/list',
+  'thread/items/list', 'turn/start', 'turn/steer', 'turn/interrupt', 'model/list', 'project/list',
+  'project/create', 'project/update', 'project/move',
+  'fs/getMetadata', 'fs/readDirectory', 'fs/createDirectory', 'command/exec',
+  'thread/settings/update', 'configRequirements/read', 'thread/queue/list', 'thread/queue/add',
+  'thread/queue/delete', 'thread/queue/start', 'thread/read', 'thread/unsubscribe', 'config/read', 'account/rateLimits/read'];
+
+export function compareVersions(a, b) {
+  const parse = v => v.split(/[.-]/).map(part => /^\d+$/.test(part) ? Number(part) : part);
+  const aa = parse(a), bb = parse(b);
+  for (let i = 0; i < Math.max(aa.length, bb.length); i++) {
+    if (aa[i] === bb[i]) continue;
+    if (aa[i] === undefined) return 1;
+    if (bb[i] === undefined) return -1;
+    return typeof aa[i] === 'number' && typeof bb[i] === 'number' ? aa[i] - bb[i] : String(aa[i]).localeCompare(String(bb[i]));
+  }
+  return 0;
+}
+
+export async function verifyProtocol(executable, stateRoot) {
+  const directory = fs.mkdtempSync(path.join(stateRoot, 'cli-schema-'));
+  try {
+    await exec(executable, ['app-server', 'generate-json-schema', '--experimental', '--out', directory],
+      { windowsHide: true, timeout: 30000, maxBuffer: 4 * 1024 * 1024 });
+    const request = fs.readFileSync(path.join(directory, 'ClientRequest.json'), 'utf8');
+    const missing = requiredMethods.filter(method => !request.includes(`"${method}"`));
+    const turns = fs.readFileSync(path.join(directory, 'v2/ThreadTurnsListParams.json'), 'utf8');
+    if (!turns.includes('"itemsView"') || !turns.includes('"summary"')) missing.push('turn summary pagination');
+    if (missing.length) throw new Error(`缺少协议能力：${missing.join(', ')}`);
+  } finally {
+    const remove = dir => {
+      for (const item of fs.readdirSync(dir, { withFileTypes: true })) {
+        const file = path.join(dir, item.name);
+        if (item.isDirectory()) remove(file); else fs.unlinkSync(file);
+      }
+      fs.rmdirSync(dir);
+    };
+    remove(directory);
+  }
+}