harness-mix 0.1.0

package/package.json

@@ -0,0 +1,142 @@
+{
+  "name": "harness-mix",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "Harness Mix native Codex UI bridge — local HostRuntime/ProtocolCore kernel driving Pi, Claude Code, DeepSeek Harness, Antigravity and Codex inside the official Codex Desktop.",
+  "keywords": [
+    "codex",
+    "codex-desktop",
+    "coding-agent",
+    "harness",
+    "pi",
+    "claude-code",
+    "deepseek",
+    "antigravity",
+    "ai"
+  ],
+  "homepage": "https://github.com/emo-xiaoyu/harness-mix#readme",
+  "bugs": "https://github.com/emo-xiaoyu/harness-mix/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/emo-xiaoyu/harness-mix.git"
+  },
+  "bin": {
+    "harness-mix": "scripts/launch-codex.cjs"
+  },
+  "files": [
+    "src",
+    "scripts",
+    "config",
+    "docs",
+    "licenses",
+    "NOTICE",
+    "Start-Codex.cmd",
+    "output/native-build/harness-mix-shim.exe",
+    "output/native-build/harness-mix-appx.exe",
+    "output/native-build/desktop-controller.mjs",
+    "output/native-build/renderer-extension.js",
+    "!src/main/native/rs/target",
+    "!**/*.log"
+  ],
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "workspaces": [
+    "src/native-ui/shared-contracts",
+    "src/native-ui/desktop-control",
+    "src/native-ui/renderer-extension"
+  ],
+  "engines": {
+    "node": ">=22.19.0 <23 || >=24 <25"
+  },
+  "scripts": {
+    "test:docs": "node scripts/docs-command-test.cjs",
+    "typecheck:native-ui": "tsc -b src/native-ui/shared-contracts/tsconfig.json src/native-ui/desktop-control/tsconfig.json src/native-ui/renderer-extension/tsconfig.json --pretty false",
+    "test:native-ui": "vitest run --config vitest.config.mjs",
+    "test:ci": "npm run test:docs && npm run check && npm run typecheck:native-ui && npm run test:native-ui && npm run test:core-all && npm run test:native-protocol && npm run test:native-compatibility",
+    "test:collaboration": "node scripts/collaboration-test.cjs",
+    "test:switch-harness": "node scripts/switch-harness-test.cjs",
+    "smoke:collaboration-ui": "electron scripts/collaboration-ui-smoke.cjs",
+    "e2e:collaboration": "node scripts/e2e-collaboration.cjs",
+    "test:native-rollback": "node scripts/native-rollback-test.cjs",
+    "test:native-images": "node scripts/native-images-test.cjs",
+    "build:native": "node scripts/build-native.cjs",
+    "test:native-protocol": "node scripts/native-protocol-test.cjs",
+    "test:native-sidebar": "node scripts/native-sidebar-test.cjs",
+    "smoke:native-ui": "electron scripts/native-ui-smoke.cjs",
+    "start": "node scripts/launch-codex.cjs",
+    "prepublishOnly": "npm run check && npm run test:core-all && npm run build:native",
+    "check:native": "node scripts/launch-codex.cjs --check",
+    "test:native-config": "node scripts/native-config-test.cjs",
+    "test:native-compatibility": "node scripts/native-compatibility-test.cjs",
+    "e2e:native": "node scripts/e2e-native-host.cjs",
+    "e2e:native:pi": "node scripts/e2e-native-host.cjs --live --harness=pi",
+    "e2e:native:dsh": "node scripts/e2e-native-host.cjs --live --harness=deepseek-harness",
+    "e2e:native:claude": "node scripts/e2e-native-host.cjs --live --harness=claude-code",
+    "start:codex": "node scripts/launch-codex.cjs",
+    "check": "node scripts/check.cjs",
+    "test:contracts": "node scripts/contracts-test.cjs",
+    "test:projector": "node scripts/projector-test.cjs",
+    "test:turn": "node scripts/turn-manager-test.cjs",
+    "test:sequence": "node scripts/sequence-test.cjs",
+    "test:shadow": "node scripts/shadow-test.cjs",
+    "test:arch": "node scripts/architecture-test.cjs",
+    "test:core-replay": "node scripts/core-replay-test.cjs",
+    "test:adapters": "node scripts/adapters-test.cjs",
+    "test:dsh-adapter": "node scripts/dsh-adapter-test.cjs",
+    "test:codex-adapter": "node scripts/codex-adapter-test.cjs",
+    "test:antigravity-adapter": "node scripts/antigravity-adapter-test.cjs",
+    "test:openclaw-adapter": "node scripts/openclaw-adapter-test.cjs",
+    "test:core-concurrency": "node scripts/core-concurrency-test.cjs",
+    "test:concurrency-layers": "node scripts/concurrency-layers-test.cjs",
+    "test:core-all": "node scripts/contracts-test.cjs && node scripts/projector-test.cjs && node scripts/turn-manager-test.cjs && node scripts/sequence-test.cjs && node scripts/shadow-test.cjs && node scripts/architecture-test.cjs && node scripts/adapters-test.cjs && node scripts/dsh-adapter-test.cjs && node scripts/codex-adapter-test.cjs && node scripts/antigravity-adapter-test.cjs && node scripts/openclaw-adapter-test.cjs && node scripts/core-replay-test.cjs && node scripts/determinism-test.cjs && node scripts/core-runtime-test.cjs && node scripts/core-services-test.cjs && node scripts/native-file-change-test.cjs && node scripts/native-updater-test.cjs && node scripts/native-vendor-adapters-test.cjs && node scripts/core-concurrency-test.cjs && node scripts/concurrency-layers-test.cjs && node scripts/tool-concurrency-regression-test.cjs && node scripts/switch-harness-test.cjs",
+    "test:transcript": "node scripts/transcript-test.cjs",
+    "test:workspace": "node scripts/workspace-test.cjs",
+    "test:git": "node scripts/git-test.cjs",
+    "e2e:pi": "node scripts/e2e-pi.cjs",
+    "e2e:shadow-pi": "node scripts/e2e-shadow.cjs pi",
+    "e2e:shadow-claude": "node scripts/e2e-shadow.cjs claude",
+    "e2e:shadow-dsh": "node scripts/e2e-shadow.cjs dsh",
+    "e2e:dsh": "node scripts/e2e-dsh.cjs",
+    "e2e:openclaw": "node scripts/e2e-openclaw.cjs",
+    "e2e:openclaw:image": "node scripts/e2e-openclaw-image.cjs",
+    "e2e:codex": "node scripts/e2e-codex.cjs",
+    "e2e:delegate": "node scripts/e2e-delegate.cjs",
+    "test:determinism": "node scripts/determinism-test.cjs",
+    "test:core-runtime": "node scripts/core-runtime-test.cjs",
+    "e2e:core-pi": "node scripts/e2e-core-resume.cjs pi",
+    "e2e:core-claude": "node scripts/e2e-core-resume.cjs claude",
+    "e2e:core-dsh": "node scripts/e2e-core-resume.cjs dsh",
+    "e2e:core-openclaw": "node scripts/e2e-core-resume.cjs openclaw",
+    "test:services": "node scripts/core-services-test.cjs",
+    "e2e:core-fork": "node scripts/e2e-core-fork.cjs",
+    "e2e:commands-pi": "node scripts/e2e-native-commands.cjs pi",
+    "e2e:commands-claude": "node scripts/e2e-native-commands.cjs claude",
+    "test:core": "npm run test:core-all",
+    "test:interactions": "node scripts/core-services-test.cjs",
+    "test:native-files": "node scripts/native-file-change-test.cjs",
+    "e2e:core-files": "node scripts/e2e-core-files.cjs",
+    "e2e:claude": "node scripts/e2e-core-resume.cjs claude",
+    "update": "node scripts/launch-codex.cjs --update",
+    "test:native-updater": "node scripts/native-updater-test.cjs",
+    "test:native-vendors": "node scripts/native-vendor-adapters-test.cjs",
+    "test:collaboration-recovery": "node scripts/collaboration-recovery-test.cjs",
+    "test:tool-concurrency": "node scripts/tool-concurrency-regression-test.cjs"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "electron": "^43.3.0",
+    "esbuild": "0.28.1",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.263",
+    "@deepseek-ai/dsh": "0.1.2-rc.1",
+    "lucide": "1.28.0",
+    "zod": "4.4.3"
+  }
+}

package/scripts/acp-capabilities-probe.cjs

@@ -0,0 +1,100 @@
+// ACP 家族能力探针：对 qoder / workbuddy / zcode / trae / hermes 逐一
+//   1) initialize          → 报告 agentCapabilities（promptCapabilities.image、mcpCapabilities 等）
+//   2) session/new 带 dummy stdio MCP server → 验证 MCP 注入是否被接受（多 Agent 协作的接线前提）
+// 结果只读打印，不修改任何适配器。运行：node scripts/acp-capabilities-probe.cjs [harnessId...]
+const { spawn } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+const { cliSpawn } = require('../src/main/host/jsonl');
+
+const TARGETS = {
+  qoder: () => cliSpawn(process.env.HARNESS_MIX_QODER_EXECUTABLE || 'qodercli', ['--acp']),
+  workbuddy: () => {
+    const candidates = [
+      process.env.HARNESS_MIX_WORKBUDDY_EXECUTABLE,
+      'C:\\Program Files\\WorkBuddy\\resources\\app.asar.unpacked\\cli\\bin\\codebuddy',
+      path.join(process.env.LOCALAPPDATA || '', 'Programs', 'WorkBuddy', 'resources', 'app.asar.unpacked', 'cli', 'bin', 'codebuddy'),
+    ].filter(Boolean);
+    const found = candidates.find(p => fs.existsSync(p));
+    return found ? { command: process.execPath, args: [found, '--acp'] } : cliSpawn('codebuddy', ['--acp']);
+  },
+  zcode: () => cliSpawn(process.env.HARNESS_MIX_ZCODE_EXECUTABLE || 'zcode', ['acp']),
+  trae: () => cliSpawn(process.env.HARNESS_MIX_TRAE_EXECUTABLE || 'traecli', ['acp', 'serve']),
+  hermes: () => ({ command: process.env.HARNESS_MIX_HERMES_EXECUTABLE || 'hermes.exe', args: ['acp'] }),
+};
+
+// 最小 MCP stdio server：应答 initialize / tools/list，让 agent 完成 MCP 握手
+const PROBE_SERVER = path.join(__dirname, '..', 'output', 'acp-probe-mcp.cjs');
+fs.mkdirSync(path.dirname(PROBE_SERVER), { recursive: true });
+fs.writeFileSync(PROBE_SERVER, `let buf='';
+process.stdin.on('data',c=>{buf+=c;let i;while((i=buf.indexOf('\\\\n'))>=0){const line=buf.slice(0,i).trim();buf=buf.slice(i+1);if(!line)continue;let msg;try{msg=JSON.parse(line)}catch{continue}
+if(msg.method==='initialize')reply(msg.id,{protocolVersion:'2024-11-05',capabilities:{tools:{}},serverInfo:{name:'harness-mix-probe',version:'0'}});
+else if(msg.method==='tools/list')reply(msg.id,{tools:[{name:'probe_tool',description:'probe',inputSchema:{type:'object',properties:{}}}]});
+else if(msg.id!==undefined)reply(msg.id,{});}});
+function reply(id,result){process.stdout.write(JSON.stringify({jsonrpc:'2.0',id,result})+'\\\\n');}
+`);
+
+function probe(id, makeCli) {
+  return new Promise((resolve) => {
+    const cli = makeCli();
+    const report = { id, image: null, audio: null, mcpCapabilities: null, loadSession: null, mcpAccepted: null, detail: '' };
+    let child;
+    try { child = spawn(cli.command, cli.args, { windowsHide: true, stdio: ['pipe', 'pipe', 'pipe'] }); }
+    catch (error) { report.detail = `spawn 失败: ${error.message}`; return resolve(report); }
+    let buf = '';
+    let stderr = '';
+    const timer = setTimeout(() => { report.mcpAccepted = report.mcpAccepted ?? 'timeout'; done(); }, 30000);
+    function done() { clearTimeout(timer); try { child.kill(); } catch {} resolve(report); }
+    function send(msg) { child.stdin.write(JSON.stringify(msg) + '\n'); }
+    child.on('error', (error) => { report.detail = `不可用: ${error.message}`; done(); });
+    child.on('exit', (code) => { if (report.mcpAccepted === null) { report.mcpAccepted = 'exited'; report.detail = `进程退出(${code}) ${stderr.slice(-200)}`; } done(); });
+    child.stderr.on('data', (c) => { stderr += String(c); });
+    child.stdout.on('data', (c) => {
+      buf += c;
+      let idx;
+      while ((idx = buf.indexOf('\n')) >= 0) {
+        const line = buf.slice(0, idx).trim();
+        buf = buf.slice(idx + 1);
+        if (!line) continue;
+        let msg;
+        try { msg = JSON.parse(line); } catch { continue; }
+        if (msg.id === 0 && msg.result) {
+          const caps = msg.result.agentCapabilities || {};
+          report.image = caps.promptCapabilities?.image ?? null;
+          report.audio = caps.promptCapabilities?.audio ?? null;
+          report.mcpCapabilities = caps.mcpCapabilities ?? null;
+          report.loadSession = caps.loadSession ?? null;
+          send({ jsonrpc: '2.0', id: 1, method: 'session/new', params: { cwd: process.cwd(), mcpServers: [
+            { name: 'harness-mix-probe', command: process.execPath, args: [PROBE_SERVER], env: [] },
+          ] } });
+        } else if (msg.id === 0 && msg.error) {
+          report.detail = `initialize 拒绝: ${msg.error.message}`; report.mcpAccepted = 'n/a'; done();
+        } else if (msg.id === 1) {
+          if (msg.result?.sessionId) report.mcpAccepted = true;
+          else { report.mcpAccepted = false; report.detail = `session/new 拒绝: ${msg.error?.message || 'unknown'}`; }
+          done();
+        }
+      }
+    });
+    send({ jsonrpc: '2.0', id: 0, method: 'initialize', params: { protocolVersion: 1, clientCapabilities: { fs: { readTextFile: false, writeTextFile: false }, terminal: false }, clientInfo: { name: 'harness-mix-probe', version: '0.1.0' } } });
+  });
+}
+
+async function main() {
+  const only = process.argv.slice(2);
+  const entries = Object.entries(TARGETS).filter(([id]) => !only.length || only.includes(id));
+  console.log('harness      image   audio   loadSession  mcpCaps            mcpServers 注入  备注');
+  for (const [id, makeCli] of entries) {
+    const r = await probe(id, makeCli);
+    console.log([
+      id.padEnd(12),
+      String(r.image).padEnd(7),
+      String(r.audio).padEnd(7),
+      String(r.loadSession).padEnd(12),
+      JSON.stringify(r.mcpCapabilities).padEnd(18),
+      String(r.mcpAccepted).padEnd(12),
+      r.detail.slice(0, 80),
+    ].join(' '));
+  }
+}
+main().catch((e) => { console.error(e); process.exitCode = 1; });

package/scripts/adapters-test.cjs

@@ -0,0 +1,17 @@
+// PR 5 验收：对注册表中全部 Adapter 执行同一组契约测试（无 Electron、不启动原生进程）。
+const { buildAdapters } = require('../src/main/adapters');
+const { runAdapterContractTests } = require('../src/main/harness-adapter/contract-test');
+
+let passed = 0;
+let failed = 0;
+function test(name, fn) {
+  try { fn(); passed++; console.log('ok', name); }
+  catch (error) { failed++; console.error('FAIL', name, '-', error.message); process.exitCode = 1; }
+}
+
+const adapters = buildAdapters(() => {});
+if (adapters.length === 0) { console.error('FAIL adapter registry is empty'); process.exit(1); }
+
+for (const adapter of adapters) runAdapterContractTests(adapter, test);
+
+console.log(`adapters: ${passed} passed${failed ? `, ${failed} failed` : ''} (${adapters.length} adapters)`);

package/scripts/antigravity-adapter-test.cjs

@@ -0,0 +1,174 @@
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const antigravity = require('../src/main/adapters/antigravity');
+
+(async () => {
+  const { manifest, create, parseModelsOutput, parseUsage, formatPrompt, prepareImageAttachments, ANTIGRAVITY_PERMISSION_MODES } = antigravity;
+
+  // 1. Manifest
+  assert.equal(manifest.id, 'antigravity');
+  assert.equal(manifest.name, 'Antigravity');
+  assert.equal(manifest.icon, 'antigravity-color.svg');
+  assert.equal(manifest.capabilities.streaming, true);
+  assert.equal(manifest.capabilities.thinking, true);
+  assert.equal(manifest.capabilities.tools, true);
+  assert.equal(manifest.capabilities.approvals, true);
+  assert.equal(manifest.capabilities.questions, true);
+  assert.equal(manifest.capabilities.models, true);
+  assert.equal(manifest.capabilities.thinkingLevels, true);
+  assert.equal(manifest.capabilities.permissionModes, true);
+  assert.equal(manifest.capabilities.resume, true);
+  assert.equal(manifest.capabilities.fork, true);
+  assert.equal(manifest.capabilities.attachments, true);
+
+  // 2. parseModelsOutput
+  const sampleModelsOutput = `
+Fetching available models...
+gemini-3.8-flash-high\tGemini 3.8 Flash (High)
+gemini-3.8-flash-medium\tGemini 3.8 Flash (Medium)
+gemini-3.8-flash-low\tGemini 3.8 Flash (Low)
+gemini-3.1-pro-high\tGemini 3.1 Pro (High)
+gemini-3.1-pro-low\tGemini 3.1 Pro (Low)
+claude-sonnet-4-6\tClaude Sonnet 4.6 (Thinking)
+gpt-oss-120b-medium\tGPT-OSS 120B (Medium)
+`;
+  const models = parseModelsOutput(sampleModelsOutput);
+  assert.ok(models.length >= 4);
+
+  const flash = models.find(m => m.id === 'gemini-3.8-flash');
+  assert.ok(flash);
+  assert.equal(flash.name, 'Gemini 3.8 Flash');
+  assert.equal(flash.provider, 'google');
+  assert.equal(flash.efforts.length, 3);
+  assert.equal(flash.efforts[0].id, 'low');
+  assert.equal(flash.efforts[2].id, 'high');
+  assert.equal(flash.defaultEffort, 'high');
+  assert.equal(flash.contextWindow, 1_048_576);
+
+  const claude = models.find(m => m.id === 'claude-sonnet-4-6');
+  assert.ok(claude);
+  assert.equal(claude.provider, 'anthropic');
+  assert.equal(claude.contextWindow, 200_000);
+
+  // 3. parseUsage
+  const usage = parseUsage({
+    input_tokens: 1200,
+    output_tokens: 300,
+    thinking_tokens: 150,
+    total_tokens: 1650,
+    context_used_tokens: 25000,
+  }, 'gemini-3.8-flash');
+  assert.equal(usage.inputTokens, 1200);
+  assert.equal(usage.outputTokens, 300);
+  assert.equal(usage.reasoningOutputTokens, 150);
+  assert.equal(usage.contextWindow, 1_048_576);
+  assert.equal(usage.tokens, 25000);
+  assert.ok(usage.contextPercent > 2.3 && usage.contextPercent < 2.5);
+
+  // 4. formatPrompt
+  const rawPrompt = '帮我修改 app.js';
+  const formatted = formatPrompt(rawPrompt);
+  assert.ok(formatted.includes('write_to_file'));
+  assert.ok(formatted.includes('replace_file_content'));
+  assert.ok(formatted.includes(rawPrompt));
+
+  // Slash commands / already instruction formatted should not duplicate
+  assert.equal(formatPrompt('/usage'), '/usage');
+  assert.equal(formatPrompt(formatted), formatted);
+
+  // 5. Adapter lifecycle and Session
+  const adapter = create(() => {});
+  assert.equal(typeof adapter.open, 'function');
+  assert.equal(typeof adapter.send, 'function');
+  assert.equal(typeof adapter.cancel, 'function');
+  assert.equal(typeof adapter.close, 'function');
+  assert.equal(typeof adapter.respond, 'function');
+  assert.equal(typeof adapter.fork, 'function');
+  assert.equal(typeof adapter.listModelsFor, 'function');
+  assert.equal(typeof adapter.setModel, 'function');
+  assert.equal(typeof adapter.setThinkingLevel, 'function');
+  assert.equal(typeof adapter.setPermissionMode, 'function');
+
+  // 6. Inspect
+  const inspection = await adapter.inspect();
+  assert.ok(typeof inspection.available === 'boolean');
+  assert.ok(typeof inspection.detail === 'string');
+
+  // 7. Open session
+  const openEvents = [];
+  const session = await adapter.open({
+    thread: {
+      id: 'thread-1',
+      nativeSessionId: 'conv-12345',
+      cwd: 'E:\\harness-mix',
+      restore: true,
+      options: {
+        model: { id: 'gemini-3.8-flash', name: 'Gemini 3.8 Flash' },
+        thinking: 'medium',
+        permissionMode: 'desktop',
+      },
+    },
+    emit: (event) => openEvents.push(event),
+    diagnostic: () => {},
+  });
+  assert.equal(session.nativeSessionId, 'conv-12345');
+  assert.equal(session.thinkingLevel, 'medium');
+  assert.equal(session.permissionMode, 'desktop');
+  assert.ok(openEvents.some(e => e.kind === 'session' && e.nativeSessionId === 'conv-12345'));
+
+  // 8. setModel, setThinkingLevel, setPermissionMode
+  await adapter.setModel(session, { id: 'gemini-3.1-pro', name: 'Gemini 3.1 Pro' });
+  assert.equal(session.model.id, 'gemini-3.1-pro');
+  await adapter.setThinkingLevel(session, 'high');
+  assert.equal(session.thinkingLevel, 'high');
+  await adapter.setPermissionMode(session, 'skip');
+  assert.equal(session.permissionMode, 'skip');
+
+  // 9. Describe
+  const desc = await adapter.describe();
+  assert.ok(Array.isArray(desc.models));
+  assert.equal(desc.thinkingLevels.length, 3);
+  assert.equal(desc.permissionModes.length, 3);
+
+  // 10. Fork session
+  const forkEvents = [];
+  const forked = await adapter.fork({
+    id: 'thread-1',
+    nativeSessionId: 'conv-12345',
+    cwd: 'E:\\harness-mix',
+    model: { id: 'gemini-3.8-flash', name: 'Gemini 3.8 Flash' },
+    options: { thinking: 'high', permissionMode: 'default' },
+  }, {
+    emit: (e) => forkEvents.push(e),
+    diagnostic: () => {},
+  });
+  assert.ok(forked.nativeSessionId);
+  assert.notEqual(forked.nativeSessionId, 'conv-12345');
+  assert.equal(forked.session.nativeSessionId, forked.nativeSessionId);
+  assert.ok(forkEvents.some(e => e.kind === 'session' && e.nativeSessionId === forked.nativeSessionId));
+
+  // 11. Image attachments
+  const tmpRoot = path.join(os.tmpdir(), `agy-attach-test-${Date.now()}`);
+  await fs.promises.mkdir(tmpRoot, { recursive: true });
+  const localImg = path.join(tmpRoot, 'test.png');
+  await fs.promises.writeFile(localImg, Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII=', 'base64'));
+  const prepared = await prepareImageAttachments([
+    { name: 'test.png', path: localImg },
+    { name: 'inline.png', mime: 'image/png', data: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jRZkAAAAASUVORK5CYII=' },
+  ], tmpRoot);
+  assert.equal(prepared.imageEntries.length, 2);
+  assert.equal(prepared.imageEntries[0].name, 'test.png');
+  assert.equal(prepared.imageEntries[0].path, localImg.replace(/\\/g, '/'));
+  assert.ok(fs.existsSync(prepared.imageEntries[1].path));
+  await fs.promises.rm(tmpRoot, { recursive: true, force: true }).catch(() => {});
+
+  // 12. Close session
+  await adapter.close(session);
+
+  console.log('antigravity adapter: manifest, models catalog, usage projection, prompt formatting, image attachments, session lifecycle, model switching, describe and fork passed');
+})().catch((err) => {
+  console.error(err);
+  process.exitCode = 1;
+});

package/scripts/architecture-test.cjs

@@ -0,0 +1,62 @@
+// P0-10 / §55：Architecture Guard —— 静态检查 Core 边界，防止 Harness 泄漏。
+// 规则：
+//   1. protocol-core/ 与 shared-contracts/ 不得 import adapters/*
+//   2. 上述目录不得出现 'pi' / 'claude' / 'dsh' 字面量（Harness 名称分支）
+//   3. harness-adapter/event-normalizer 同样保持 Harness 名称零感知
+const { readdirSync, statSync, readFileSync } = require('node:fs');
+const { join, relative } = require('node:path');
+
+const GUARDED_DIRS = ['src/main/protocol-core', 'src/main/shared-contracts', 'src/main/harness-adapter'];
+const FORBIDDEN_PATTERNS = [
+  { re: /require\(['"`][^'"`]*adapters[/-]/, label: 'import from adapters/*' },
+  { re: /require\(['"`][^'"`]*renderer[/-]/, label: 'import from renderer/*' },
+  { re: /(['"`])(pi|claude|dsh)\1/, label: 'harness name literal' },
+];
+
+function* walk(dir) {
+  for (const entry of readdirSync(dir)) {
+    const full = join(dir, entry);
+    if (statSync(full).isDirectory()) yield* walk(full);
+    else if (/\.js$/.test(entry)) yield full;
+  }
+}
+
+let violations = 0;
+for (const dir of GUARDED_DIRS) {
+  for (const file of walk(dir)) {
+    const source = readFileSync(file, 'utf8');
+    for (const { re, label } of FORBIDDEN_PATTERNS) {
+      const match = source.match(re);
+      if (match) {
+        violations++;
+        console.error(`VIOLATION ${relative('.', file)}: ${label} (${match[0]})`);
+      }
+    }
+  }
+}
+
+for (const file of walk('src/main/adapters')) {
+  if (/require\(['"`][^'"`]*renderer[/-]/.test(readFileSync(file, 'utf8'))) {
+    violations++; console.error(`VIOLATION ${file}: adapter imports Renderer`);
+  }
+}
+for (const file of walk('src')) {
+  if (/require\(['"`][^'"`]*(?:legacy[-/]|scripts\/support)/.test(readFileSync(file, 'utf8'))) {
+    violations++; console.error(`VIOLATION ${file}: production imports legacy test oracle`);
+  }
+}
+for (const file of ['src/main/host/runtime.js']) {
+  if (/(['"`])(pi|claude|dsh)\1/.test(readFileSync(file, 'utf8'))) {
+    violations++; console.error(`VIOLATION ${file}: execution branches on harness name`);
+  }
+}
+if (/PROTOCOL_CORE_(SHADOW|RENDERER)|finishMessage|ensureAssistantMessage/.test(readFileSync('src/main/host/runtime.js', 'utf8'))) {
+  violations++; console.error('VIOLATION Runtime retains legacy execution path');
+}
+
+if (violations) {
+  console.error(`architecture: ${violations} violation(s)`);
+  process.exitCode = 1;
+} else {
+  console.log(`architecture: core boundaries clean (${GUARDED_DIRS.join(', ')})`);
+}

package/scripts/build-native.cjs

@@ -0,0 +1,46 @@
+const fs = require('node:fs');
+const path = require('node:path');
+const { execFileSync } = require('node:child_process');
+const esbuild = require('esbuild');
+const { getAllIconsDictionary, MODEL_FAMILIES } = require('../src/main/native/icons');
+const root = path.resolve(__dirname, '..');
+const out = path.join(root, 'output/native-build');
+
+function cargoCommand() {
+  const candidates = ['cargo', path.join(process.env.USERPROFILE || '', '.cargo/bin/cargo.exe')];
+  for (const candidate of candidates) {
+    try {
+      execFileSync(candidate, ['--version'], { stdio: 'ignore', windowsHide: true });
+      return candidate;
+    } catch { /* try the next candidate */ }
+  }
+  throw new Error('Rust toolchain (cargo) not found; install via https://rustup.rs (use the x86_64-pc-windows-gnu host when Visual Studio Build Tools are absent)');
+}
+
+async function main() {
+  fs.mkdirSync(out, { recursive: true });
+  const alias = { '@codexhost/shared-contracts': path.join(root, 'src/native-ui/shared-contracts/src/index.ts') };
+  const common = { bundle: true, alias, logLevel: 'warning', target: 'es2024' };
+  const icons = getAllIconsDictionary();
+  icons.harnesses['claude-code'] = icons.harnesses.claude;
+  icons.harnesses['deepseek-harness'] = icons.harnesses.dsh;
+  await esbuild.build({ ...common, entryPoints: ['src/native-ui/renderer-extension/src/production-entry.ts'],
+    platform: 'browser', format: 'iife', outfile: path.join(out, 'renderer-extension.js'),
+    loader: { '.svg': 'dataurl', '.png': 'dataurl', '.css': 'text' },
+    banner: { js: `globalThis.__HARNESS_MIX_ICONS__=${JSON.stringify(icons)};globalThis.__HARNESS_MIX_MODEL_FAMILIES__=${JSON.stringify(MODEL_FAMILIES.map(f => ({ id: f.id, pattern: f.regex.source })))};` } });
+  await esbuild.build({ ...common, entryPoints: ['src/native-ui/desktop-control/src/release-main.ts'],
+    platform: 'node', format: 'esm', outfile: path.join(out, 'desktop-controller.mjs') });
+  if (process.platform !== 'win32') throw new Error('Native executable build currently supports Windows only');
+  execFileSync(cargoCommand(), ['build', '--release', '--manifest-path', path.join(root, 'src/main/native/rs/Cargo.toml')], { stdio: 'inherit', windowsHide: true });
+  const target = path.join(root, 'src/main/native/rs/target/release');
+  for (const exe of ['harness-mix-shim.exe', 'harness-mix-appx.exe']) {
+    const source = path.join(target, exe);
+    const destination = path.join(out, exe);
+    // An unchanged executable may be running while UI-only fixes are built.
+    if (fs.existsSync(destination) && fs.readFileSync(source).equals(fs.readFileSync(destination))) continue;
+    fs.copyFileSync(source, destination);
+  }
+  fs.writeFileSync(path.join(out, 'node-path.txt'), process.execPath);
+  console.log('Harness Mix local Renderer, Desktop Controller and Shim built.');
+}
+main().catch(error => { console.error(error); process.exitCode = 1; });

package/scripts/catalog-test.cjs

@@ -0,0 +1,25 @@
+const assert = require('node:assert/strict');
+const fs = require('node:fs/promises');
+const os = require('node:os');
+const path = require('node:path');
+const { HostRuntime } = require('../src/main/host/runtime');
+(async () => {
+  const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'hm-catalog-'));
+  const rt = new HostRuntime({ dataDirectory: dir });
+  try {
+    await rt.initialize();
+    for (const harnessId of ['pi', 'dsh']) {
+      const thread = await rt.createThread({ harnessId, cwd: dir });
+      const session = rt.sessions.get(thread.id);
+      const catalog = await rt.describe(harnessId);
+      assert.ok(catalog.models.length, harnessId + ' live model catalog');
+      assert.equal(rt.sessions.get(thread.id), session);
+      assert.equal(await rt.describe(harnessId), catalog, 'cached catalog reused');
+      await session.adapter.close(session); rt.sessions.delete(thread.id);
+      const commands = await rt.listCommands({ threadId: thread.id });
+      assert.equal(rt.sessions.has(thread.id), false, 'menu never restores session');
+      if (harnessId === 'pi') assert.ok(commands.some(c => c.id === 'compact'));
+    }
+    console.log('native Pi/DSH catalogs reused; command menu does not restore sessions');
+  } finally { await rt.close(); }
+})().catch(error => { console.error(error); process.exitCode = 1; });

package/scripts/cdp-eval.cjs

@@ -0,0 +1,40 @@
+// CDP driver: evaluate JS and/or send raw CDP commands against the live Codex Desktop.
+// usage: node scripts/cdp-eval.cjs <port> <expression>          -> Runtime.evaluate
+//        node scripts/cdp-eval.cjs <port> --cmd <method> <json> -> raw command
+const http = require('node:http');
+
+function getJson(url) {
+  return new Promise((resolve, reject) => {
+    http.get(url, res => {
+      let data = '';
+      res.on('data', c => (data += c));
+      res.on('end', () => { try { resolve(JSON.parse(data)); } catch (e) { reject(e); } });
+    }).on('error', reject);
+  });
+}
+
+async function main() {
+  const port = process.argv[2];
+  const targets = await getJson(`http://127.0.0.1:${port}/json/list`);
+  const page = targets.find(t => t.type === 'page' && t.url === 'app://-/index.html');
+  if (!page) throw new Error('main page not found');
+  const ws = new WebSocket(page.webSocketDebuggerUrl);
+  await new Promise((res, rej) => { ws.onopen = res; ws.onerror = rej; });
+  let id = 0;
+  const pending = new Map();
+  ws.onmessage = ev => {
+    const msg = JSON.parse(ev.data);
+    if (msg.id && pending.has(msg.id)) { pending.get(msg.id)(msg); pending.delete(msg.id); }
+  };
+  const send = (method, params) => new Promise(res => { const i = ++id; pending.set(i, res); ws.send(JSON.stringify({ id: i, method, params })); });
+  if (process.argv[3] === '--cmd') {
+    const result = await send(process.argv[4], JSON.parse(process.argv[5] || '{}'));
+    console.log(JSON.stringify(result.result ?? result.error ?? null));
+  } else {
+    const result = await send('Runtime.evaluate', { expression: process.argv[3], returnByValue: true, awaitPromise: true });
+    if (result.result?.exceptionDetails) console.error('EX:', JSON.stringify(result.result.exceptionDetails).slice(0, 400));
+    else console.log(JSON.stringify(result.result?.result?.value ?? result, null, 2));
+  }
+  ws.close();
+}
+main().catch(e => { console.error(e.message); process.exit(1); });

package/scripts/cdp-watch.cjs

@@ -0,0 +1,36 @@
+// Watch renderer console/log for N milliseconds.
+const http = require('node:http');
+function getJson(url) {
+  return new Promise((resolve, reject) => {
+    http.get(url, res => { let d = ''; res.on('data', c => (d += c)); res.on('end', () => { try { resolve(JSON.parse(d)); } catch (e) { reject(e); } }); }).on('error', reject);
+  });
+}
+async function main() {
+  const port = process.argv[2];
+  const seconds = Number(process.argv[3] || 60);
+  const filter = process.argv[4] ? new RegExp(process.argv[4], 'i') : null;
+  const targets = await getJson(`http://127.0.0.1:${port}/json/list`);
+  const page = targets.find(t => t.type === 'page' && t.url === 'app://-/index.html');
+  const ws = new WebSocket(page.webSocketDebuggerUrl);
+  await new Promise((res, rej) => { ws.onopen = res; ws.onerror = rej; });
+  let id = 0;
+  const send = (method, params) => { ws.send(JSON.stringify({ id: ++id, method, params })); };
+  send('Runtime.enable');
+  send('Log.enable');
+  ws.onmessage = ev => {
+    const msg = JSON.parse(ev.data);
+    let line = null;
+    if (msg.method === 'Runtime.consoleAPICalled') {
+      line = 'console.' + msg.params.type + ': ' + msg.params.args.map(a => a.value ?? a.description ?? JSON.stringify(a)).join(' ').slice(0, 500);
+    } else if (msg.method === 'Log.entryAdded') {
+      const e = msg.params.entry;
+      line = `log.${e.level}: ${(e.text || '').slice(0, 500)}`;
+    } else if (msg.method === 'Runtime.exceptionThrown') {
+      line = 'EXCEPTION: ' + JSON.stringify(msg.params.exceptionDetails).slice(0, 500);
+    }
+    if (line && (!filter || filter.test(line))) console.log(new Date().toLocaleTimeString(), line);
+  };
+  console.log('watching for', seconds, 's');
+  setTimeout(() => { ws.close(); process.exit(0); }, seconds * 1000);
+}
+main().catch(e => { console.error(e.message); process.exit(1); });