@harness-mix/cli 0.1.7 → 0.1.9

package/src/main/host/session-history.js

@@ -2,6 +2,10 @@ const { listNative, readNative } = require('./native-history');
 const external = id => ({ codex: 'codex-harness', claude: 'claude-code', dsh: 'deepseek-harness' }[id] || id);
 const local = id => ({ workbuddy: 'codebuddy', 'codex-harness': 'codex', 'claude-code': 'claude', 'deepseek-harness': 'dsh' }[id] || id);
 
+// 引用会话读取：发送时的预取信封只带最近一页；MCP 只读工具按 offset 逐页向更早翻
+const MAX_PAGE = 50;
+const TRANSCRIPT_BUDGET = 24000;
+
 class SessionHistory {
   constructor(runtime, providers = { listNative, readNative }) { this.runtime = runtime; this.providers = providers; this.imports = new Map(); }
   sources() { return { harnesses: [{ harnessId: 'all-harnesses', name: '全部历史' }, ...[...this.runtime.adapters.values()].map(a => ({ harnessId: external(a.manifest.id), name: a.manifest.name + (['pi', 'claude', 'codex', 'codebuddy'].includes(a.manifest.id) ? '' : '（Host 历史）') }))] }; }
@@ -20,18 +24,11 @@ class SessionHistory {
     const rows = (await this.rows(harnessId)).filter(r => `${r.title} ${r.cwd} ${r.nativeSessionId}`.toLowerCase().includes(needle)).sort((a, b) => b.updatedAt - a.updatedAt || a.nativeSessionId.localeCompare(b.nativeSessionId));
     return { total: rows.length, candidates: rows.slice(offset, offset + limit).map(({ nativeSessionId, title, cwd, updatedAt, running }) => ({ nativeSessionId, title: title?.slice(0, 4096) || null, cwd, updatedAt, running })) };
   }
-  async import({ harnessId, nativeSessionId }) {
-    if (harnessId === 'all-harnesses') {
-      const decoded = JSON.parse(Buffer.from(nativeSessionId, 'base64url').toString());
-      if (!Array.isArray(decoded) || decoded.length !== 2 || !decoded.every(v => typeof v === 'string')) throw new Error('Invalid history identity');
-      [harnessId, nativeSessionId] = decoded;
-    }
-    harnessId = local(harnessId);
-    const key = JSON.stringify([harnessId, nativeSessionId]);
+  async import(identity) {
+    const key = JSON.stringify([identity.harnessId, identity.nativeSessionId]);
     if (this.imports.has(key)) return this.imports.get(key);
     const operation = (async () => {
-      const row = (await this.rows(harnessId)).find(r => r.nativeSessionId === nativeSessionId);
-      if (!row) throw new Error('Native session no longer exists');
+      const { harnessId, nativeSessionId, row } = await this.#locate(identity);
       if (row.threadId) return { threadId: row.threadId };
       if (row.running) throw new Error('Native session is active');
       const messages = await this.providers.readNative(harnessId, row);
@@ -42,7 +39,9 @@ class SessionHistory {
     return operation;
   }
 
-  async context({ harnessId = 'all-harnesses', nativeSessionId }) {
+  /** 解码 harness-mix://session/<id> 引用（all-harnesses 时为 base64url 的 [harnessId, nativeSessionId]）并定位行 */
+  async #locate({ harnessId = 'all-harnesses', nativeSessionId }) {
+    const sessionRef = nativeSessionId;
     if (harnessId === 'all-harnesses') {
       const decoded = JSON.parse(Buffer.from(nativeSessionId, 'base64url').toString());
       if (!Array.isArray(decoded) || decoded.length !== 2 || !decoded.every(v => typeof v === 'string')) throw new Error('Invalid history identity');
@@ -51,12 +50,52 @@ class SessionHistory {
     harnessId = local(harnessId);
     const row = (await this.rows(harnessId)).find(candidate => candidate.nativeSessionId === nativeSessionId);
     if (!row) throw new Error('Referenced native session no longer exists');
-    const managed = row.threadId && this.runtime.threads.find(thread => thread.id === row.threadId);
+    return { harnessId, nativeSessionId, sessionRef, row };
+  }
+
+  #managed(row) { return row.threadId ? this.runtime.threads.find(thread => thread.id === row.threadId) : undefined; }
+
+  #metadata(harnessId, row, messageCount) {
+    const managed = this.#managed(row);
+    return {
+      harnessId: external(harnessId),
+      title: row.title || '未命名会话',
+      cwd: row.cwd,
+      branch: managed?.gitInfo?.branch ?? null,
+      model: managed?.model ?? null,
+      messageCount: messageCount ?? null,
+      usage: managed?.usage ?? null,
+      updatedAt: row.updatedAt ?? null,
+      running: row.running ?? (managed ? this.runtime.execution.isRunning(managed.id) : null),
+    };
+  }
+
+  /** 引用会话元数据：保持廉价，不为统计拉取原生全文（无内嵌消息的行 messageCount 为 null） */
+  async info(identity) {
+    const { harnessId, sessionRef, row } = await this.#locate(identity);
+    const messages = this.#managed(row)?.messages ?? row.messages ?? null;
+    const count = messages ? messages.filter(m => ['user', 'assistant'].includes(m.role) && m.text).length : null;
+    return { sessionRef, ...this.#metadata(harnessId, row, count) };
+  }
+
+  /** 引用会话正文：offset 0 为最近一页，按 nextOffset 逐页向更早翻；transcript 受字符预算约束 */
+  async context({ offset = 0, limit = 12, ...identity }) {
+    if (!Number.isSafeInteger(offset) || offset < 0 || !Number.isInteger(limit) || limit < 1 || limit > MAX_PAGE) throw new Error('Invalid history paging');
+    const { harnessId, sessionRef, row } = await this.#locate(identity);
+    const managed = this.#managed(row);
     const messages = managed ? managed.messages : await this.providers.readNative(harnessId, row);
-    const selected = messages.filter(message => ['user', 'assistant'].includes(message.role) && message.text).slice(-12);
+    const all = messages.filter(message => ['user', 'assistant'].includes(message.role) && message.text);
+    const end = Math.max(0, all.length - offset);
+    const start = Math.max(0, end - limit);
+    const page = all.slice(start, end);
     return {
-      harnessId: external(harnessId), title: row.title || '未命名会话', cwd: row.cwd,
-      transcript: selected.map(message => `${message.role === 'user' ? 'User' : 'Assistant'}: ${message.text}`).join('\n').slice(-24000),
+      sessionRef,
+      ...this.#metadata(harnessId, row, all.length),
+      offset,
+      returned: page.length,
+      hasMore: start > 0,
+      nextOffset: start > 0 ? offset + page.length : null,
+      transcript: page.map(message => `${message.role === 'user' ? 'User' : 'Assistant'}: ${message.text}`).join('\n').slice(-TRANSCRIPT_BUDGET),
     };
   }
 }

package/src/main/native/icons.js

@@ -20,8 +20,8 @@ const MODEL_FAMILIES = [
 
 const HARNESS_ICONS = [
   { id: 'kiro-cli', file: 'kiro-cli-color.svg', label: 'Kiro' },
-  { id: 'cursor-cli', file: 'cursor.svg', label: 'Cursor' },
-  { id: 'cursor', file: 'cursor.svg', label: 'Cursor' },
+  { id: 'cursor-cli', file: 'cursor.svg', label: 'Cursor' },
+  { id: 'cursor', file: 'cursor.svg', label: 'Cursor' },
   { id: 'antigravity', file: 'antigravity-color.svg', label: 'Antigravity' },
   { id: 'claude', file: 'claude-color.svg', label: 'Claude Code' },
   { id: 'codex', file: 'codex-harness.svg', label: 'Codex' },
@@ -36,6 +36,7 @@ const HARNESS_ICONS = [
   { id: 'codebuddy', file: 'codebuddy-color.svg', label: 'CodeBuddy' },
   { id: 'zcode', file: 'zcode-color.svg', label: 'ZCode' },
   { id: 'trae', file: 'trae-color.svg', label: 'Trae' },
+  { id: 'cline', file: 'cline-color.svg', label: 'Cline' },
 ];
 
 const svgCache = new Map();

package/src/main/native/pets.js

@@ -0,0 +1,234 @@
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+// 桌宠市场数据源（只读官方资产，不随 Harness Mix 分发）：
+// - 官方预载：Codex Desktop 安装包 app.asar 内嵌的 *-spritesheet-vN-<hash>.webp，运行时按需提取；
+// - 已安装：~/.codex/pets/<id>/{pet.json, spritesheet.webp}（官方 Pets 设置页读取同一目录）。
+// 选择动作始终留给官方 Pets 设置页 / /pet 指令，Harness Mix 不代理账号级 accessory_id。
+
+const PET_ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
+const SPRITESHEET_PATTERN = /^([a-z0-9]+(?:-[a-z0-9]+)*)-spritesheet-v\d+-[0-9a-f]+\.webp$/;
+const MAX_SPRITESHEET_BYTES = 16 * 1024 * 1024;
+
+function titleCase(id) {
+  if (id === 'bsod') return 'BSOD';
+  return id.split('-').map(part => part[0].toUpperCase() + part.slice(1)).join(' ');
+}
+
+function petsDirectory(env = process.env) {
+  return env.HARNESS_MIX_PETS_DIR || path.join(os.homedir(), '.codex', 'pets');
+}
+
+// CODEXHOST_STOCK_CODEX_PATH 指向安装包内的 codex CLI（win: <root>/app/resources/codex.exe，
+// mac: <root>/Contents/Resources/codex），app.asar 与其同目录。Host 进程由 Shim 启动时该变量已注入；
+// 缺失时按平台探测（Windows 走 AppX 查询，macOS 检查标准 .app 路径），结果进程内缓存。
+let resolvedAsarPath;
+function resolveAsarPath(env = process.env) {
+  if (resolvedAsarPath !== undefined) return resolvedAsarPath;
+  const candidates = [];
+  if (typeof env.CODEXHOST_STOCK_CODEX_PATH === 'string' && env.CODEXHOST_STOCK_CODEX_PATH) {
+    candidates.push(path.join(path.dirname(env.CODEXHOST_STOCK_CODEX_PATH), 'app.asar'));
+  }
+  if (typeof env.HARNESS_MIX_DESKTOP_APP === 'string' && env.HARNESS_MIX_DESKTOP_APP) {
+    candidates.push(path.join(env.HARNESS_MIX_DESKTOP_APP, 'Contents', 'Resources', 'app.asar'));
+  }
+  resolvedAsarPath = candidates.find(file => fs.existsSync(file)) ?? null;
+  if (resolvedAsarPath) return resolvedAsarPath;
+  try {
+    if (process.platform === 'win32') {
+      const { execFileSync } = require('child_process');
+      const root = execFileSync('powershell', ['-NoProfile', '-Command',
+        '(Get-AppxPackage -Name OpenAI.Codex | Select-Object -First 1).InstallLocation'], { encoding: 'utf8', windowsHide: true }).trim();
+      if (root) resolvedAsarPath = [path.join(root, 'app', 'resources', 'app.asar')].find(file => fs.existsSync(file)) ?? null;
+    } else if (process.platform === 'darwin') {
+      resolvedAsarPath = ['/Applications/Codex.app', path.join(os.homedir(), 'Applications', 'Codex.app')]
+        .map(app => path.join(app, 'Contents', 'Resources', 'app.asar'))
+        .find(file => fs.existsSync(file)) ?? null;
+    }
+  } catch { /* 未安装或无权查询时按无官方源处理 */ }
+  return resolvedAsarPath;
+}
+
+// 最小 asar 读取器：| u32:4 | u32:pickleSize | u32:jsonSizeField | u32:jsonSize | json | pad | blobs |
+// blob 起始 = 8 + pickleSize（已用真实 Codex app.asar 的 RIFF/WEBP 魔数验证）
+function readAsarHeader(asarPath) {
+  const fd = fs.openSync(asarPath, 'r');
+  try {
+    const head = Buffer.alloc(16);
+    if (fs.readSync(fd, head, 0, 16, 0) !== 16) throw new Error('asar header too short');
+    const pickleSize = head.readUInt32LE(4);
+    const jsonSize = head.readUInt32LE(12);
+    if (jsonSize <= 0 || jsonSize > 64 * 1024 * 1024) throw new Error('asar header JSON size out of range');
+    const buffer = Buffer.alloc(jsonSize);
+    if (fs.readSync(fd, buffer, 0, jsonSize, 16) !== jsonSize) throw new Error('asar header JSON truncated');
+    return { tree: JSON.parse(buffer.toString('utf8')), blobBase: 8 + pickleSize };
+  } finally {
+    fs.closeSync(fd);
+  }
+}
+
+function assetEntries(header) {
+  const files = header.tree?.files?.webview?.files?.assets?.files;
+  return files && typeof files === 'object' ? files : {};
+}
+
+function createPetMarket({ env = process.env } = {}) {
+  const headerCache = new Map(); // asarPath -> { mtimeMs, header }
+  const previewCache = new Map(); // cacheKey -> { mime, dataBase64 }
+
+  function asarHeader() {
+    const asarPath = resolveAsarPath(env);
+    if (!asarPath) return null;
+    const mtimeMs = fs.statSync(asarPath).mtimeMs;
+    const cached = headerCache.get(asarPath);
+    if (cached && cached.mtimeMs === mtimeMs) return { asarPath, header: cached.header };
+    const header = readAsarHeader(asarPath);
+    headerCache.set(asarPath, { mtimeMs, header });
+    return { asarPath, header };
+  }
+
+  function officialPets() {
+    const resolved = asarHeader();
+    if (!resolved) return { asarPath: null, header: null, pets: [] };
+    const pets = [];
+    for (const [name, entry] of Object.entries(assetEntries(resolved.header))) {
+      const match = name.match(SPRITESHEET_PATTERN);
+      if (!match || entry?.unpacked === true) continue;
+      const size = Number(entry.size);
+      if (!Number.isFinite(size) || size <= 0 || size > MAX_SPRITESHEET_BYTES) continue;
+      const id = match[1];
+      pets.push({
+        id,
+        displayName: titleCase(id),
+        description: 'Codex 官方内置桌宠',
+        source: 'official',
+        spritesheet: { name, size, offset: String(entry.offset ?? '0') },
+      });
+    }
+    pets.sort((a, b) => a.id.localeCompare(b.id));
+    return { asarPath: resolved.asarPath, header: resolved.header, pets };
+  }
+
+  function installedPets() {
+    const dir = petsDirectory(env);
+    let names = [];
+    try { names = fs.readdirSync(dir, { withFileTypes: true }); } catch { return []; }
+    const pets = [];
+    for (const entry of names) {
+      if (!entry.isDirectory() || !PET_ID_PATTERN.test(entry.name)) continue;
+      const petJsonPath = path.join(dir, entry.name, 'pet.json');
+      let meta = {};
+      try { meta = JSON.parse(fs.readFileSync(petJsonPath, 'utf8')); } catch { continue; }
+      const spritesheet = typeof meta.spritesheetPath === 'string' && meta.spritesheetPath ? meta.spritesheetPath : 'spritesheet.webp';
+      if (spritesheet.includes('..') || path.isAbsolute(spritesheet) || spritesheet.includes('/') || spritesheet.includes('\\')) continue;
+      if (!fs.existsSync(path.join(dir, entry.name, spritesheet))) continue;
+      pets.push({
+        id: entry.name,
+        displayName: typeof meta.displayName === 'string' && meta.displayName ? meta.displayName : titleCase(entry.name),
+        description: typeof meta.description === 'string' ? meta.description : '',
+        source: 'installed',
+        spritesheet: { name: spritesheet },
+      });
+    }
+    pets.sort((a, b) => a.id.localeCompare(b.id));
+    return pets;
+  }
+
+  return {
+    catalog() {
+      const official = officialPets();
+      const installed = installedPets();
+      const installedIds = new Set(installed.map(pet => pet.id));
+      const data = [
+        ...installed,
+        ...official.pets.filter(pet => !installedIds.has(pet.id)).map(pet => ({ ...pet, installed: false })),
+      ];
+      for (const pet of data) pet.installed = pet.installed ?? installedIds.has(pet.id);
+      return {
+        data,
+        officialAvailable: official.asarPath !== null,
+        petsDir: petsDirectory(env),
+      };
+    },
+
+    preview({ id } = {}) {
+      if (!PET_ID_PATTERN.test(String(id || ''))) throw new Error('Invalid pet id');
+      const cached = previewCache.get(id);
+      if (cached) return cached;
+      const local = installedPets().find(pet => pet.id === id);
+      let buffer;
+      if (local) {
+        buffer = fs.readFileSync(path.join(petsDirectory(env), id, local.spritesheet.name));
+      } else {
+        const official = officialPets();
+        const pet = official.pets.find(entry => entry.id === id);
+        if (!pet) throw new Error(`Unknown pet: ${id}`);
+        const fd = fs.openSync(official.asarPath, 'r');
+        try {
+          buffer = Buffer.alloc(pet.spritesheet.size);
+          const position = official.header.blobBase + Number(pet.spritesheet.offset);
+          if (fs.readSync(fd, buffer, 0, pet.spritesheet.size, position) !== pet.spritesheet.size) {
+            throw new Error('Spritesheet truncated');
+          }
+        } finally {
+          fs.closeSync(fd);
+        }
+      }
+      if (buffer.length > MAX_SPRITESHEET_BYTES) throw new Error('Spritesheet too large');
+      const result = { id, mime: 'image/webp', dataBase64: buffer.toString('base64') };
+      previewCache.set(id, result);
+      if (previewCache.size > 24) previewCache.delete(previewCache.keys().next().value);
+      return result;
+    },
+
+    install({ id } = {}) {
+      if (!PET_ID_PATTERN.test(String(id || ''))) throw new Error('Invalid pet id');
+      const official = officialPets();
+      const pet = official.pets.find(entry => entry.id === id);
+      if (!pet) throw new Error(official.asarPath ? `桌宠 ${id} 不在官方预载目录中` : '未找到 Codex Desktop 安装，无法获取官方桌宠');
+      const targetDir = path.join(petsDirectory(env), id);
+      const petJsonPath = path.join(targetDir, 'pet.json');
+      const spritesheetPath = path.join(targetDir, 'spritesheet.webp');
+      if (fs.existsSync(petJsonPath) && fs.existsSync(spritesheetPath)) {
+        return { id, path: targetDir, installed: true, alreadyInstalled: true };
+      }
+      const fd = fs.openSync(official.asarPath, 'r');
+      let buffer;
+      try {
+        buffer = Buffer.alloc(pet.spritesheet.size);
+        const position = official.header.blobBase + Number(pet.spritesheet.offset);
+        if (fs.readSync(fd, buffer, 0, pet.spritesheet.size, position) !== pet.spritesheet.size) {
+          throw new Error('Spritesheet truncated');
+        }
+      } finally {
+        fs.closeSync(fd);
+      }
+      fs.mkdirSync(targetDir, { recursive: true });
+      fs.writeFileSync(spritesheetPath, buffer);
+      fs.writeFileSync(petJsonPath, `${JSON.stringify({
+        id,
+        displayName: pet.displayName,
+        description: pet.description,
+        spritesheetPath: 'spritesheet.webp',
+      }, null, 2)}\n`);
+      previewCache.delete(id);
+      return { id, path: targetDir, installed: true, alreadyInstalled: false };
+    },
+
+    uninstall({ id } = {}) {
+      if (!PET_ID_PATTERN.test(String(id || ''))) throw new Error('Invalid pet id');
+      const root = petsDirectory(env);
+      const targetDir = path.join(root, id);
+      if (path.relative(root, targetDir).startsWith('..')) throw new Error('Invalid pet directory');
+      if (!fs.existsSync(targetDir)) return { id, removed: false };
+      fs.rmSync(targetDir, { recursive: true, force: true });
+      previewCache.delete(id);
+      return { id, removed: true };
+    },
+  };
+}
+
+module.exports = { createPetMarket, petsDirectory, resolveAsarPath, readAsarHeader };