@harness-mix/cli 0.1.4 → 0.1.6

package/scripts/native-skill-roots-test.cjs

@@ -0,0 +1,90 @@
+const assert = require('node:assert/strict');
+const fs = require('node:fs/promises');
+const os = require('node:os');
+const path = require('node:path');
+const { ParityObserver } = require('./support/parity-observer.cjs');
+const { HostRuntime } = require('../src/main/host/runtime');
+
+// 用户可见契约：打开原生会话时，先为每个 Harness 创建缺失的原生技能根目录，
+// 这样刚安装、从未运行过的 Harness 也能立即被 Harness Mix 发现并安装技能。
+// 单个目录创建失败只提示、不阻断会话；项目作用域不可用时退化为全局根目录。
+
+const skills = { global: ['.test-harness/skills'], project: ['.agents/skills'] };
+const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
+async function until(fn) { for (let i = 0; i < 200; i++) { if (fn()) return; await sleep(10); } throw new Error('timed out'); }
+
+function stubAdapter(id, onOpen) {
+  return {
+    manifest: { id, name: 'Test Harness', capabilities: {}, integrations: { mcp: false, skills: JSON.parse(JSON.stringify(skills)) } },
+    async open(input) { onOpen?.(input); return {}; },
+    async send() {}, async cancel() {}, async respond() {}, async close() {},
+  };
+}
+
+async function main() {
+  const directory = await fs.mkdtemp(path.join(os.tmpdir(), 'hm-skill-roots-'));
+  const workspace = path.join(directory, 'workspace');
+  const home = path.join(directory, 'home');
+  await fs.mkdir(workspace); await fs.mkdir(home);
+
+  const rt = new HostRuntime({ observer: new ParityObserver(), dataDirectory: directory });
+  await rt.store.load();
+  rt.integrations.home = home;
+  rt.integrations.environment = {};
+
+  // 1) 缺失的技能目录在会话打开时被创建（全局 + 项目）。
+  let opened = 0, emit = null;
+  const adapter = stubAdapter('test-harness', input => { opened++; emit = input.emit; });
+  rt.adapters.set(adapter.manifest.id, adapter);
+  rt.status[adapter.manifest.id] = { available: true };
+  const thread = await rt.createThread({ harnessId: adapter.manifest.id, cwd: workspace });
+  const toasts = [];
+  rt.subscribe(event => { if (event.type === 'toast') toasts.push(event); });
+  await rt.send(thread.id, 'hello');
+  assert.equal(opened, 1, 'native session opened');
+  for (const root of [path.join(home, '.test-harness', 'skills'), path.join(workspace, '.agents', 'skills')]) {
+    assert.equal((await fs.stat(root)).isDirectory(), true, `${root} created on launch`);
+  }
+  assert.deepEqual(toasts, [], 'a successful launch reports no skill-root failure');
+  emit({ kind: 'completed', finalAnswer: true });
+  await until(() => thread.status === 'ready' && !thread.reviewPending);
+
+  // 2) 已存在的根目录被复用，重复打开不会失败。
+  await fs.mkdir(path.join(home, '.test-harness', 'skills', 'existing'), { recursive: true });
+  await rt.send(thread.id, 'again');
+  assert.equal(opened, 1, 'same thread reuses the native session');
+  emit({ kind: 'completed', finalAnswer: true });
+  await until(() => thread.status === 'ready' && !thread.reviewPending);
+  assert.equal((await fs.stat(path.join(home, '.test-harness', 'skills', 'existing'))).isDirectory(), true, 'existing skill content untouched');
+
+  // 3) 无法创建的根目录只提示并跳过，会话照常打开。
+  const blockedHome = path.join(directory, 'blocked-home');
+  await fs.mkdir(path.join(blockedHome, '.test-harness'), { recursive: true });
+  await fs.writeFile(path.join(blockedHome, '.test-harness', 'skills'), 'not a directory');
+  const blockedWorkspace = path.join(directory, 'blocked-workspace');
+  await fs.mkdir(blockedWorkspace);
+  const blocked = new HostRuntime({ observer: new ParityObserver(), dataDirectory: path.join(directory, 'blocked-data') });
+  await blocked.store.load();
+  blocked.integrations.home = blockedHome;
+  blocked.integrations.environment = {};
+  let blockedOpened = 0;
+  const blockedAdapter = stubAdapter('test-harness', () => { blockedOpened++; });
+  blocked.adapters.set(blockedAdapter.manifest.id, blockedAdapter);
+  blocked.status[blockedAdapter.manifest.id] = { available: true };
+  const blockedThread = await blocked.createThread({ harnessId: blockedAdapter.manifest.id, cwd: blockedWorkspace });
+  const blockedToasts = [];
+  console.log('DBG blocked.integrations.home =', blocked.integrations.home);
+  console.log('DBG global root stat type =', (await fs.lstat(path.join(blockedHome, '.test-harness', 'skills'))).isFile() ? 'FILE' : 'other');
+  blocked.subscribe(event => { if (event.type === 'toast') blockedToasts.push(event); });
+  await blocked.send(blockedThread.id, 'hello');
+  assert.equal(blockedOpened, 1, 'session still opens when a skill root cannot be created');
+  assert.equal(blocked.sessions.has(blockedThread.id), true, 'native session attached despite the uncreatable root');
+  assert.equal(blockedThread.error, undefined, 'no session error from the uncreatable root');
+  assert.equal((await fs.stat(path.join(blockedWorkspace, '.agents', 'skills'))).isDirectory(), true, 'the remaining root is still created');
+  console.log('TOASTS:', JSON.stringify(blockedToasts.map(t => ({ type: t.type, level: t.level, text: String(t.text).slice(0, 140) }))));
+  assert.equal(blockedToasts.filter(event => /原生技能目录准备失败/.test(event.text)).length, 1, 'the skipped root is reported once');
+
+  console.log('native skill roots: created on session open, reused when present, and never fatal PASS');
+  await fs.rm(directory, { recursive: true, force: true });
+}
+main().catch(error => { console.error(error); process.exitCode = 1; });

package/scripts/native-ui-smoke.cjs

@@ -12,7 +12,7 @@ app.whenReady().then(async () => {
   const icons = getAllIconsDictionary();
   icons.harnesses['claude-code'] = icons.harnesses.claude;
   icons.harnesses['deepseek-harness'] = icons.harnesses.dsh;
-  const bundle = await esbuild.build({ stdin: { contents: `export { createRendererAgentIcon } from './src/native-ui/renderer-extension/src/renderer-agent-icon.ts'; export { mountRendererModelPicker, renderRendererModelPicker } from './src/native-ui/renderer-extension/src/renderer-model-picker.ts'; export { restoredThreadOwnership } from './src/native-ui/renderer-extension/src/renderer-binding-probe.ts'; export { installRendererSidebarAgentIcons } from './src/native-ui/renderer-extension/src/renderer-sidebar-agent-icons.ts';`, resolveDir: process.cwd() }, bundle: true, alias: { '@codexhost/shared-contracts': path.resolve('src/native-ui/shared-contracts/src/index.ts') }, platform: 'browser', format: 'iife', globalName: 'NativeUI', write: false, loader: { '.svg': 'dataurl', '.png': 'dataurl', '.css': 'text' }, logLevel: 'silent' });
+  const bundle = await esbuild.build({ stdin: { contents: `export { createRendererAgentIcon } from './src/native-ui/renderer-extension/src/renderer-agent-icon.ts'; export { mountRendererAgentPicker, renderRendererAgentPicker } from './src/native-ui/renderer-extension/src/renderer-agent-picker.ts'; export { mountRendererModelPicker, renderRendererModelPicker } from './src/native-ui/renderer-extension/src/renderer-model-picker.ts'; export { mountRendererHarnessHandoff } from './src/native-ui/renderer-extension/src/renderer-harness-handoff.ts'; export { restoredThreadOwnership } from './src/native-ui/renderer-extension/src/renderer-binding-probe.ts'; export { installRendererSidebarAgentIcons } from './src/native-ui/renderer-extension/src/renderer-sidebar-agent-icons.ts'; export { createAccountsSettingsPage } from './src/native-ui/renderer-extension/src/settings/accounts-page.ts'; export { aboutPage } from './src/native-ui/renderer-extension/src/settings/pages.ts'; export { rendererSettingsMessages } from './src/native-ui/renderer-extension/src/settings/localization.ts'; export { installRendererSettingsShell } from './src/native-ui/renderer-extension/src/settings/shell.ts';`, resolveDir: process.cwd() }, bundle: true, alias: { '@codexhost/shared-contracts': path.resolve('src/native-ui/shared-contracts/src/index.ts') }, platform: 'browser', format: 'iife', globalName: 'NativeUI', write: false, loader: { '.svg': 'dataurl', '.png': 'dataurl', '.css': 'text' }, logLevel: 'silent' });
   const win = new BrowserWindow({ show: false, width: 900, height: 650, webPreferences: { contextIsolation: true, sandbox: true, offscreen: true, backgroundThrottling: false } });
   await win.loadURL('data:text/html,<html><head><style>body{background:%2317191d;color:white;font:16px Arial;padding:40px}button{background:%23272a30;color:white;border:0;padding:12px}img{vertical-align:middle}main{display:flex;gap:25px;margin-bottom:40px}</style></head><body><h2>Harness Mix native components</h2><main></main></body></html>');
   await win.webContents.executeJavaScript(`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 })))};${bundle.outputFiles[0].text}`);
@@ -82,13 +82,69 @@ app.whenReady().then(async () => {
   assert.deepEqual(result.restored.map(item => item.agent), ['pi','claude-code','deepseek-harness','antigravity']);
   assert.deepEqual(result.restored.map(item => item.model), inspections.map(item => item.effectiveModel));
   for (const id of ['harnesses/codex','harnesses/pi','harnesses/claude-code','harnesses/deepseek-harness','harnesses/antigravity','models/claude','models/deepseek','models/gemini']) assert.ok(result.icons.includes(id), id);
+  const handoffView = await win.webContents.executeJavaScript(`(() => {
+    globalThis.handoffRequest = null;
+    globalThis.testHandoff = NativeUI.mountRendererHarnessHandoff('smoke', request => { globalThis.handoffRequest = request; });
+    globalThis.testAgentPicker = NativeUI.mountRendererAgentPicker('handoff-entry', ['codex','pi','claude-code'], target => testHandoff.open('pi', target, 'zh-CN'), () => {}, () => {});
+    document.body.append(testAgentPicker.root);
+    NativeUI.renderRendererAgentPicker(testAgentPicker, {agent:'pi',phase:'locked'}, 'ready', false, {pi:'ready','claude-code':'ready'});
+    testAgentPicker.trigger.click();
+    testAgentPicker.options['claude-code'].button.click();
+    testHandoff.note.value = '按上一位给出的方案继续执行';
+    return { open:testHandoff.dialog.open, title:testHandoff.dialog.querySelector('h2').textContent, text:testHandoff.dialog.textContent, pickerLabel:testAgentPicker.trigger.getAttribute('aria-label'), targetEnabled:!testAgentPicker.options['claude-code'].button.disabled };
+  })()`);
+  assert.equal(handoffView.open, true);
+  assert.equal(handoffView.title, '接力当前任务');
+  assert.match(handoffView.text, /Pi.*Claude Code/s);
+  assert.match(handoffView.text, /对话记录和文件现场/);
+  assert.match(handoffView.pickerLabel, /Hand off task from Pi/);
+  assert.equal(handoffView.targetEnabled, true);
+  await new Promise(resolve => setTimeout(resolve, 100));
+  fs.writeFileSync(path.join(out, 'harness-handoff.png'), (await win.webContents.capturePage()).toPNG());
+  const handoffRequest = await win.webContents.executeJavaScript(`(() => { testHandoff.confirm.click(); const request = globalThis.handoffRequest; testHandoff.close(); testHandoff.dispose(); return request; })()`);
+  assert.deepEqual(handoffRequest, {
+    from:'pi', to:'claude-code', note:'按上一位给出的方案继续执行', intent:'continue',
+    includes:{ conversation:true, plan:true, evidence:true, files:true, unresolved:true },
+  });
+  await win.webContents.executeJavaScript('testAgentPicker.dispose()');
   await win.webContents.executeJavaScript('testModelPicker.trigger.click();document.querySelector("main").style.flexWrap="wrap"');
   await new Promise(resolve => setTimeout(resolve, 300));
   fs.writeFileSync(path.join(out, 'native-components.png'), (await win.webContents.capturePage()).toPNG());
   await win.webContents.executeJavaScript(`document.body.style.background='#fff';document.body.style.color='#17191d';document.querySelector('main').style.flexWrap='wrap'`);
   await new Promise(resolve => setTimeout(resolve, 100));
   fs.writeFileSync(path.join(out, 'native-components-light.png'), (await win.webContents.capturePage()).toPNG());
+  const settingsResult = await win.webContents.executeJavaScript(`(async () => {
+    document.body.innerHTML = '';
+    const messages = NativeUI.rendererSettingsMessages('zh-CN');
+    const account = { accountId:'official-codex', label:'native@example.com', email:'native@example.com', planType:'plus', codexHome:'C:/Users/test/.codex', active:true, isDefault:true, authenticated:true, management:'native' };
+    const client = {
+      listCodexAccounts: async () => ({ accounts:[account] }),
+      refreshCodexAccounts: async () => ({ accounts:[account] }),
+      inspectCodexAccountUsage: async () => ({ accountId:account.accountId, usage:{planFiveHourUsedPercent:33,planSevenDayUsedPercent:29}, accountCredits:{usedPercent:33,periodType:'five_hour',productUsage:[{product:'7-day window',usagePercent:29}]} }),
+      createCodexAccount: async () => ({account}), deleteCodexAccount: async () => ({deletedAccountId:account.accountId}), activateCodexAccount: async () => ({account}),
+      startCodexAccountLogin: async () => { throw new Error('not expected'); }, cancelCodexAccountLogin: async () => ({cancelled:true}), logoutCodexAccount: async () => ({account:{...account,email:undefined,authenticated:false}}),
+    };
+    const shell = NativeUI.installRendererSettingsShell([
+      NativeUI.createAccountsSettingsPage(messages, () => client),
+      NativeUI.aboutPage(messages, () => ({ readCurrentVersion:async () => ({version:'0.1.4'}), checkUpdate:async () => { throw new Error('not expected'); } })),
+    ], messages, document);
+    shell.openSettings(undefined, 'accounts');
+    await new Promise(resolve => setTimeout(resolve, 150));
+    const shadow = shell.root.shadowRoot;
+    return { text:shadow.textContent, addHidden:[...shadow.querySelectorAll('button')].find(button => button.textContent.includes('添加账号'))?.hidden };
+  })()`);
+  assert.match(settingsResult.text, /native.*example\.com/s);
+  assert.match(settingsResult.text, /Plus/);
+  assert.equal(settingsResult.addHidden, true);
+  fs.writeFileSync(path.join(out, 'settings-account.png'), (await win.webContents.capturePage()).toPNG());
+  const aboutText = await win.webContents.executeJavaScript(`(async () => {
+    globalThis.__codexhostSettingsShellV1.openSettings(undefined, 'about');
+    await new Promise(resolve => setTimeout(resolve, 100));
+    return globalThis.__codexhostSettingsShellV1.root.shadowRoot.textContent;
+  })()`);
+  assert.match(aboutText, /v0\.1\.4/);
+  fs.writeFileSync(path.join(out, 'settings-about.png'), (await win.webContents.capturePage()).toPNG());
   win.destroy();
-  console.log('PASS: real Electron native picker selection and all project Harness/model SVGs load');
+  console.log('PASS: real Electron native picker, graphical Harness handoff, official Account/Usage, live About version and all project Harness/model SVGs load');
   app.quit();
 }).catch(error => { console.error(error); app.exit(1); });

package/scripts/publish-native-package.cjs

@@ -14,13 +14,16 @@ const pkg = path.join(work, 'package');
 fs.mkdirSync(path.join(pkg, 'bin'), { recursive: true });
 const version = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).version;
 const names = platform === 'win32' ? ['harness-mix-shim.exe', 'harness-mix-appx.exe', 'harness-mix-secret.exe'] : ['harness-mix-shim'];
-for (const name of names) {
-  const source = path.join(output, name);
-  if (!fs.existsSync(source)) throw new Error(`Missing ${source}; build the target runtime first`);
-  fs.copyFileSync(source, path.join(pkg, 'bin', name));
+const sourceOnly = flags.includes('--source-only');
+if (!sourceOnly) {
+  for (const name of names) {
+    const source = path.join(output, name);
+    if (!fs.existsSync(source)) throw new Error(`Missing ${source}; build the target runtime first (or use --source-only)`);
+    fs.copyFileSync(source, path.join(pkg, 'bin', name));
+  }
 }
 fs.writeFileSync(path.join(pkg, 'package.json'), JSON.stringify({
-  name: `@harness-mix/native-${key}`, version, description: `Harness Mix native runtime for ${key}`,
+  name: `@harness-mix/native-${key}`, version, description: `Harness Mix native runtime for ${key}${sourceOnly ? ' (source-only; build locally)' : ''}`,
   license: 'Apache-2.0', os: [platform], cpu: [arch], files: ['bin'], publishConfig: { access: 'public' },
 }, null, 2) + '\n');
 fs.writeFileSync(path.join(pkg, 'README.md'), `# @harness-mix/native-${key}\n\nNative runtime selected automatically by @harness-mix/cli.\n`);

package/scripts/support/integrations-mcp-fixture.cjs

@@ -0,0 +1,15 @@
+// Local read-only MCP server used by the native integration acceptance probe.
+const readline = require('node:readline');
+const fs = require('node:fs');
+readline.createInterface({ input: process.stdin }).on('line', line => {
+  let request; try { request = JSON.parse(line); } catch { return; }
+  if (process.argv[2]) fs.appendFileSync(process.argv[2], `${request.method}\n`);
+  if (request.id === undefined) return;
+  let result;
+  if (request.method === 'initialize') result = { protocolVersion: request.params.protocolVersion, capabilities: { tools: {} }, serverInfo: { name: 'harness-mix-integration-probe', version: '1.0.0' } };
+  else if (request.method === 'tools/list') result = { tools: [{ name: 'integration_probe', description: 'Return a fixed test token without side effects.', inputSchema: { type: 'object', properties: {}, additionalProperties: false }, annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false } }] };
+  else if (request.method === 'tools/call') result = { content: [{ type: 'text', text: 'HARNESS_MIX_MCP_OK' }] };
+  else if (request.method === 'ping') result = {};
+  else { process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id: request.id, error: { code: -32601, message: 'Unknown method' } })}\n`); return; }
+  process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id: request.id, result })}\n`);
+});

package/scripts/switch-harness-test.cjs

@@ -2,6 +2,7 @@ const assert = require('node:assert/strict');
 const fs = require('node:fs/promises');
 const path = require('node:path');
 const { HostRuntime } = require('../src/main/host/runtime');
+const { CAP, buildHandoffContext } = require('../src/main/host/handoff');
 
 /**
  * 跨 Harness 原地切换（switchHarness）脚本级测试：
@@ -33,6 +34,19 @@ function fakeHarness(id, name) {
 }
 
 async function main() {
+  const longSolution = `方案开头-${'x'.repeat(5000)}-方案结尾`;
+  const optimized = buildHandoffContext({
+    cwd: 'E:/project', title: '登录重构', messages: [
+      { role: 'user', text: '先分析问题' },
+      { role: 'assistant', text: '初步判断' },
+      { role: 'user', text: '给出完整方案' },
+      { role: 'assistant', text: longSolution },
+    ],
+  });
+  assert.deepEqual(optimized.conversationTail.map(message => message.role), ['user', 'assistant', 'user', 'assistant']);
+  assert.equal(optimized.conversationTail.at(-1).text, longSolution, '最新方案应获得更大的交接预算');
+  assert.ok(optimized.conversationTail.reduce((sum, message) => sum + message.text.length, 0) <= CAP.totalChars);
+
   await fs.mkdir('output', { recursive: true });
   const root = await fs.mkdtemp(path.resolve('output/switch-harness-'));
   const rt = new HostRuntime({ dataDirectory: path.join(root, 'data') });
@@ -71,6 +85,12 @@ async function main() {
     assert.equal(thread.harnessChain[0].nativeSessionId, aNativeId);
     assert.equal(thread.pendingHandoff.fromHarnessId, 'a');
     assert.equal(thread.pendingHandoff.note, '优先把测试补完');
+    assert.match(thread.pendingHandoff.checkpointId, /^handoff_[a-f0-9]{24}$/);
+    const firstCheckpointId = thread.pendingHandoff.checkpointId;
+    const checkpointBeforeSend = rt.handoffs.get(thread.id, firstCheckpointId);
+    assert.equal(checkpointBeforeSend.intent, 'continue');
+    assert.equal(checkpointBeforeSend.fileState.files.some(file => file.path === 'src/login.ts' && file.changeType === 'added'), true);
+    assert.equal(rt.handoffs.owned(thread.id, firstCheckpointId).status, 'checkpoint-created');
     assert.equal(thread.restore, false, '新 Harness 上是全新原生会话');
     assert.equal(rt.sessions.has(thread.id), false, '切换后旧原生会话已关闭');
     assert.equal(a.state.closed, 1);
@@ -87,11 +107,12 @@ async function main() {
     assert.match(b.state.sent[0], /untrusted historical data/);
     assert.match(b.state.sent[0], /帮我重构登录模块/);
     assert.match(b.state.sent[0], /Alpha 回复/);
-    assert.match(b.state.sent[0], /added src\/login\.ts/);
+    assert.match(b.state.sent[0], /"path":"src\/login\.ts","changeType":"added"/);
     assert.match(b.state.sent[0], /优先把测试补完/);
     const visible = thread.messages.filter(m => m.role === 'user').at(-1);
     assert.equal(visible.text, '继续', '信封不进用户可见消息');
     assert.equal(thread.pendingHandoff, undefined, '信封发送成功后标记已清除');
+    assert.equal(rt.handoffs.owned(thread.id, firstCheckpointId).status, 'active');
 
     // 5) 第二轮起不再注入
     await rt.send(thread.id, '第二步');
@@ -123,6 +144,9 @@ async function main() {
     await settle(thread.id);
     await assert.rejects(rt.switchHarness(thread.id, 'a'), /已经在该 Harness/);
     await assert.rejects(rt.switchHarness(thread.id, 'Nope'), /未知 Harness/);
+    rt.status.b = { available: false, detail: '测试连接不可用' };
+    await assert.rejects(rt.switchHarness(thread.id, 'b'), /测试连接不可用/);
+    rt.status.b = { available: true };
     const draft = await rt.createThread({ harnessId: 'a', cwd: root, ephemeral: true });
     await assert.rejects(rt.switchHarness(draft.id, 'b'), /草稿任务/);
     const child = await rt.createThread({ harnessId: 'a', cwd: root, parentThreadId: thread.id });
@@ -138,6 +162,8 @@ async function main() {
     // 重启恢复的真正契约是持久化的 harnessId + nativeSessionId（指向 A 的原生会话）。
     assert.equal(persisted.nativeSessionId, aNativeId);
     assert.equal(persisted.restore, undefined);
+    const persistedCheckpoints = JSON.parse(await fs.readFile(path.join(root, 'data', 'handoff', 'checkpoints.json'), 'utf8'));
+    assert.equal(persistedCheckpoints.some(row => row.checkpointId === firstCheckpointId && row.status === 'active'), true);
 
     console.log('PASS: in-place harness switch → one-shot context envelope → switch-back native resume, guards and persistence');
   } finally { await rt.close(); }

package/scripts/test-live-mentions.cjs

@@ -0,0 +1,152 @@
+const http = require('node:http');
+const fs = require('node:fs/promises');
+const path = require('node:path');
+
+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] || '57989';
+  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 }));
+  });
+
+  const evaluate = async expr => {
+    const result = await send('Runtime.evaluate', { expression: expr, returnByValue: true, awaitPromise: true });
+    if (result.result?.exceptionDetails) {
+      throw new Error(JSON.stringify(result.result.exceptionDetails));
+    }
+    return result.result?.result?.value;
+  };
+
+  console.log('Waiting for probe to mount...');
+  await evaluate(`(async () => {
+    for (let i = 0; i < 50; i++) {
+      if (window.__codexhostRendererBindingProbeV1 && document.querySelector('.ProseMirror')) break;
+      await new Promise(r => setTimeout(r, 100));
+    }
+  })()`);
+
+  const directClientTest = await evaluate(`(async () => {
+    try {
+      const probe = window.__codexhostRendererBindingProbeV1;
+      return {
+        hasProbe: !!probe,
+        probeKeys: probe ? Object.keys(probe) : []
+      };
+    } catch (e) {
+      return { error: e.message, stack: e.stack };
+    }
+  })()`);
+  console.log('Direct client test:', JSON.stringify(directClientTest, null, 2));
+
+  console.log('Focusing editor and positioning caret at end...');
+  await evaluate(`(() => {
+    const editor = document.querySelector('.ProseMirror');
+    if (!editor) return;
+    editor.focus();
+    const p = editor.querySelector('p') || editor;
+    const sel = window.getSelection();
+    const range = document.createRange();
+    range.selectNodeContents(p);
+    range.collapse(false);
+    sel?.removeAllRanges();
+    sel?.addRange(range);
+  })()`);
+
+  // Send input via CDP
+  console.log('Sending CDP input for #...');
+  await send('Input.insertText', { text: '#' });
+  await new Promise(r => setTimeout(r, 600));
+
+  const menuInfo = await evaluate(`(() => {
+    const menu = document.querySelector('[data-harness-mix-mentions]');
+    const tabs = [...document.querySelectorAll('[data-harness-mix-mentions] [role="tab"]')].map(t => t.textContent.trim());
+    const options = [...document.querySelectorAll('[data-harness-mix-mentions] [role="option"]')].map(opt => {
+      const name = opt.querySelector('span[style*="font-weight:600"]')?.textContent || opt.innerText;
+      const desc = opt.querySelector('span[style*="font-size:11px"]')?.textContent || '';
+      return { name, desc, disabled: opt.hasAttribute('disabled') };
+    });
+    return {
+      lastMentionDebug: window.__lastMentionDebug,
+      menuHidden: menu ? menu.hidden : true,
+      menuDisplay: menu ? menu.style.display : null,
+      menuRect: menu ? { left: menu.style.left, top: menu.style.top, bottom: menu.style.bottom } : null,
+      tabs,
+      optionCount: options.length,
+      sampleOptions: options.slice(0, 8)
+    };
+  })()`);
+  console.log('Menu state after typing #:', JSON.stringify(menuInfo, null, 2));
+
+  // Capture screenshot with popup open
+  const shot1 = await send('Page.captureScreenshot', { format: 'png' });
+  const data1 = shot1.result?.data || shot1.data;
+  if (data1) {
+    await fs.mkdir('output', { recursive: true });
+    await fs.writeFile(path.resolve('output/live-hash-mentions.png'), Buffer.from(data1, 'base64'));
+    console.log('Saved output/live-hash-mentions.png');
+  }
+
+  // 2. Select an agent (e.g. click first option) and verify badge styling
+  const state2 = await evaluate(`(async () => {
+    const firstOption = document.querySelector('[data-harness-mix-mentions] [role="option"]:not([disabled])');
+    if (firstOption) {
+      firstOption.click();
+      await new Promise(r => setTimeout(r, 200));
+    }
+    const badges = [...document.querySelectorAll('[data-harness-mix-selected-mentions] [data-harness-mix-mention-badge]')].map(b => ({
+      text: b.textContent.trim(),
+      title: b.title,
+      color: b.style.color
+    }));
+    const containerHasAttr = document.querySelector('[data-harness-mix-has-mentions="true"]') !== null;
+    return { badges, containerHasAttr };
+  })()`);
+  console.log('State after selecting agent:', JSON.stringify(state2, null, 2));
+
+  // Capture screenshot with badge in input box
+  const shot2 = await send('Page.captureScreenshot', { format: 'png' });
+  const data2 = shot2.result?.data || shot2.data;
+  if (data2) {
+    await fs.writeFile(path.resolve('output/live-hash-selected-badge.png'), Buffer.from(data2, 'base64'));
+    console.log('Saved output/live-hash-selected-badge.png');
+  }
+
+  // 3. Clear badge so we leave the UI clean
+  await evaluate(`(() => {
+    const badge = document.querySelector('[data-harness-mix-selected-mentions] [data-harness-mix-mention-badge]');
+    if (badge) badge.click();
+    const editor = document.querySelector('[contenteditable="true"], .ProseMirror, textarea');
+    if (editor && !editor.value) editor.textContent = '';
+  })()`);
+
+  ws.close();
+  console.log('Done!');
+}
+
+main().catch(err => {
+  console.error(err);
+  process.exit(1);
+});

package/src/main/adapters/acp.js

@@ -53,11 +53,10 @@ function acpAdapter({ id, name, bin, args, executable = false, images = false, f
         }
       },
       async describe() { return { models: null, thinkingLevels: [], permissionModes: [] }; },
-      async open({ thread, emit, diagnostic = () => {}, collaboration }) {
+      async open({ thread, emit, diagnostic = () => {}, collaboration, managedMcp = [] }) {
         const cli = command(args);
         const session = { cwd: thread.cwd, nativeSessionId: null, collaborationEnabled: !!collaboration,
-          mcpServers: collaboration ? [{ name: 'harness-mix', command: collaboration.command, args: collaboration.args,
-            env: Object.entries(collaboration.env).map(([name, value]) => ({ name, value })) }] : [],
+          mcpServers: require('./managed-mcp').acpServers(managedMcp, collaboration),
           state: { configOptions: [], models: null, modes: null, commands: [], usage: undefined, loading: true }, pendingApprovals: new Map(), tools: new Map(), emit };
         session.process = new JsonlProcess(cli.command, cli.args, { cwd: thread.cwd }, {
           onDiagnostic: diagnostic,
@@ -186,6 +185,7 @@ function acpAdapter({ id, name, bin, args, executable = false, images = false, f
     };
     return adapter;
   }
+  manifest.integrations = { mcp: true };
   return { manifest, create };
 }
 module.exports = { acpAdapter, catalog };

package/src/main/adapters/antigravity.js

@@ -639,27 +639,21 @@ class QuestionBridge {
       CODEXHOST_AGY_QUESTION_CLIENT: `"${clientPath.replaceAll('\\', '/')}"`,
     };
 
-    if (options.collaboration) {
+    if (options.collaboration || options.managedMcp?.length) {
       const pluginDir = path.join(dir, '.agents', 'plugins', 'harness-mix');
       const plainPluginDir = path.join(dir, 'plugins', 'harness-mix');
       await fs.promises.mkdir(pluginDir, { recursive: true });
       await fs.promises.mkdir(plainPluginDir, { recursive: true });
       const pluginManifest = JSON.stringify({ name: 'harness-mix-collaboration', description: 'Harness Mix Multi-agent Collaboration' }, null, 2);
       const mcpConfig = JSON.stringify({
-        mcpServers: {
-          'harness-mix': {
-            command: options.collaboration.command,
-            args: options.collaboration.args,
-            env: options.collaboration.env,
-          },
-        },
+        mcpServers: require('./managed-mcp').namedServers(options.managedMcp, options.collaboration),
       }, null, 2);
       await fs.promises.writeFile(path.join(pluginDir, 'plugin.json'), pluginManifest, 'utf8');
       await fs.promises.writeFile(path.join(pluginDir, 'mcp_config.json'), mcpConfig, 'utf8');
       await fs.promises.writeFile(path.join(plainPluginDir, 'plugin.json'), pluginManifest, 'utf8');
       await fs.promises.writeFile(path.join(plainPluginDir, 'mcp_config.json'), mcpConfig, 'utf8');
       await fs.promises.writeFile(path.join(dir, '.agents', 'mcp_config.json'), mcpConfig, 'utf8');
-      Object.assign(bridge.environment, options.collaboration.env || {});
+      Object.assign(bridge.environment, options.collaboration?.env || {});
     }
 
     return bridge;
@@ -823,7 +817,7 @@ function create(emit, options = {}) {
       });
     },
 
-    async open({ thread, emit: emitEvent, diagnostic, collaboration }) {
+    async open({ thread, emit: emitEvent, diagnostic, collaboration, managedMcp = [] }) {
       // Do not start a second agy process while a real turn may be starting.
       // Quota is loaded only by the explicit account/usage refresh path below.
       await restoreLegacyClipboardAttachments(thread);
@@ -837,6 +831,7 @@ function create(emit, options = {}) {
         thinkingLevel,
         permissionMode,
         collaboration: collaboration || null,
+        managedMcp,
         collaborationEnabled: !!collaboration,
         activeTurn: null,
         bridge: null,
@@ -859,13 +854,11 @@ function create(emit, options = {}) {
         approvals,
         emit: emitEvent,
         collaboration: session.collaboration,
+        managedMcp: session.managedMcp,
       });
       session.bridge = bridge;
 
       let effectivePrompt = prompt ?? '';
-      if (session.collaborationEnabled) {
-        effectivePrompt = `[多 Agent 协作系统已就绪。你作为主协调者，可调用已注入的 MCP 工具：delegate_to_agent(agent_type, task) 向其他已注册的 Harness（如 @pi、@claude-code、@codex、@deepseek-harness 等）委派子任务，使用 get_delegation_status(task_ids) 等待结果，使用 update_agent_plan(steps) 设定与更新分步计划。]\n\n${effectivePrompt}`;
-      }
       const { imageEntries, extraDirs } = await prepareImageAttachments(attachments?.images, session.cwd);
       if (imageEntries.length) {
         const imageNotice = [
@@ -1215,15 +1208,18 @@ function create(emit, options = {}) {
     },
 
     async cancel(session) {
-      if (session.activeTurn?.child) {
-        void terminateTree(session.activeTurn.child.pid);
+      if (session.activeTurn) {
+        session.activeTurn.completed = true;
+        if (session.activeTurn.child) {
+          void terminateTree(session.activeTurn.child.pid);
+        }
+        session.activeTurn.resolve?.();
+        session.activeTurn = null;
       }
       if (session.bridge) {
         await session.bridge.dispose().catch(() => {});
         session.bridge = null;
       }
-      session.activeTurn?.resolve?.();
-      session.activeTurn = null;
     },
 
     async respond(session, requestId, response) {
@@ -1349,6 +1345,10 @@ function create(emit, options = {}) {
   };
 }
 
+// https://antigravity.google/docs/skills/#where-skills-live
+// Single assignment: an earlier declaration used to be silently overwritten here,
+// which dropped Antigravity's native skill roots from the manifest.
+manifest.integrations = { mcp: true, skills: { global: ['.gemini/config/skills'], project: ['.agents/skills'] } };
 module.exports = {
   manifest,
   create,