@harness-mix/cli 0.1.3

package/src/assets/icons/qoder-color.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Qoder</title><path d="M23.376 14.458v-4.056c0-2.304-1.003-4.154-2.748-5.075L11.612.574l-.046.086-.045.086c1.68.886 2.644 2.673 2.644 4.902v4.056a7.928 7.928 0 01-.014.454l-.005.061c-.005.081-.01.164-.018.245a4.897 4.897 0 01-.011.1l-.01.076c-.008.068-.015.135-.025.203l-.018.113-.01.058a9.99 9.99 0 01-.098.513l-.007.03a7.209 7.209 0 01-.074.294l-.024.086c-.027.099-.056.197-.087.296l-.027.085a9.592 9.592 0 01-.111.323l-.033.085-.018.046c-.032.082-.064.166-.098.248-.019.048-.04.096-.061.145l-.007.017a6 6 0 01-.084.187c-.024.056-.05.11-.077.165-.03.061-.058.122-.089.182a9.423 9.423 0 01-.176.332c-.03.056-.062.111-.094.167-.031.053-.062.108-.095.16-.033.055-.066.11-.101.164-.033.053-.065.104-.1.155-.034.055-.07.107-.111.169l-.099.144a15.193 15.193 0 01-.34.457c-.04.05-.08.102-.121.151l-.107.128-.007.008a6.987 6.987 0 01-.262.298l-.149.16-.116.12a9.562 9.562 0 01-.204.198l-.03.03-.072.069a9.05 9.05 0 01-.263.235l-.025.022-.029.026-.042.035a11.7 11.7 0 01-.22.18l-.07.055-.018.013a8.904 8.904 0 01-.194.146c-.029.02-.057.042-.086.063a7.7 7.7 0 01-.22.152l-.057.04a8.865 8.865 0 01-.293.185l-.062.037a10.424 10.424 0 01-.307.173l-.037.02-.196.103-.108.052-.012.006a6.196 6.196 0 01-.315.143c-.065.028-.13.054-.196.08l-.035.014-.086.034c-.07.026-.143.05-.215.075l-.039.014-.064.023a8.056 8.056 0 01-.323.097l-.63.173a7.285 7.285 0 01-.33.08l-.07.015c-.053.012-.104.023-.157.032l-.065.011-.085.015a2.332 2.332 0 01-.194.027l-.085.01a4.715 4.715 0 01-.16.018l-.034.003a4.861 4.861 0 01-.246.016h-.033a2.714 2.714 0 01-.155.005h-.106a3.384 3.384 0 01-.225-.007H4.86l-.15-.012-.066-.006a5.586 5.586 0 01-.187-.02l-.04-.005a5.14 5.14 0 01-.219-.035l-.054-.01a6.943 6.943 0 01-.347-.082l-.03-.008-.038-.01a5.034 5.034 0 01-.269-.086l-.063-.023a4.216 4.216 0 01-.188-.073l-.071-.031-.016-.007a4.959 4.959 0 01-.16-.074l-.026-.013a.164.164 0 00-.014-.007l-.671-.351.486.486h.016l8.995 4.742.093.048.03.014.02.01c.056.026.111.052.169.076l.016.008.073.032.195.076.022.008a.718.718 0 01.03.012l.014.004a4.693 4.693 0 00.323.1l.027.007c.073.02.147.038.22.055l.018.004.027.006.066.013.088.016c.075.014.15.026.226.038l.042.004c.064.009.128.016.193.022l.126.012.06.003.05.002.098.005c.046.002.094.002.14.003h.12c.05 0 .1-.002.161-.005h.033l.07-.004a6.17 6.17 0 00.184-.014l.033-.003a.753.753 0 00.058-.005l.108-.012.081-.01.08-.01.129-.021.082-.014.071-.012c.054-.01.107-.021.16-.033l.066-.013.059-.013c.096-.022.192-.046.287-.073l.63-.172a7.354 7.354 0 00.397-.122l.04-.015c.075-.025.149-.051.222-.078.032-.011.062-.024.093-.037l.03-.012c.067-.027.135-.054.2-.082l.128-.056.195-.09.021-.01.102-.05c.068-.034.135-.069.202-.105l.037-.02.073-.038c.08-.044.16-.092.24-.139l.026-.015a8.086 8.086 0 00.322-.2l.065-.045 1.98.902a1.748 1.748 0 002.472-1.59v-7.33l.004.004z" fill="#2ADB5C"></path><path d="M11.617.576a3.904 3.904 0 00-.093-.047c-.016-.009-.033-.016-.05-.024a5.854 5.854 0 00-.166-.077l-.09-.04a4.094 4.094 0 00-.194-.074c-.017-.006-.035-.015-.053-.02l-.013-.005a5.18 5.18 0 00-.277-.088l-.07-.019a4.034 4.034 0 00-.219-.053c-.015-.003-.03-.008-.044-.012L10.253.1l-.057-.011a5.177 5.177 0 00-.225-.036L9.928.047a5.972 5.972 0 00-.191-.022L9.669.02a1.33 1.33 0 00-.058-.005L9.515.009a4.058 4.058 0 00-.111-.005C9.354 0 9.304 0 9.254 0h-.109c-.052 0-.106.004-.16.004L8.884.01A5.32 5.32 0 008.7.022l-.083.006h-.008c-.05.005-.1.013-.15.019l-.12.014c-.056.008-.112.018-.169.028-.037.006-.074.011-.11.018a7.054 7.054 0 00-.572.133l-.63.172c-.111.031-.22.064-.33.1-.037.011-.072.025-.108.037a12.91 12.91 0 00-.345.126c-.067.027-.133.054-.2.083l-.128.055a11.916 11.916 0 00-.318.15 7.376 7.376 0 00-.311.163c-.082.045-.16.092-.24.14a9.424 9.424 0 00-.35.218l-.016.01-.06.04a9.242 9.242 0 00-.51.37 12.54 12.54 0 00-.315.254l-.043.034-.01.007-.045.041c-.09.078-.18.158-.268.24l-.106.101c-.07.067-.139.135-.207.204l-.056.054-.063.067-.153.164-.12.133-.148.17c-.024.03-.049.057-.073.086l-.043.053a5.96 5.96 0 00-.123.155l-.118.151c-.04.053-.08.106-.118.16l-.075.101-.038.056-.107.155-.11.164a9.91 9.91 0 00-.168.265c-.012.02-.023.043-.037.063a12.43 12.43 0 00-.192.335l-.09.168c-.019.034-.04.07-.057.105-.011.022-.02.043-.032.065l-.092.188-.08.167a19.15 19.15 0 00-.083.192c-.017.038-.035.076-.05.115-.008.016-.014.034-.021.051-.035.083-.067.167-.1.253l-.051.134c-.04.11-.077.22-.113.33l-.02.057c0 .002 0 .005-.002.007l-.008.026c-.032.1-.06.2-.09.301l-.023.089c-.027.1-.052.2-.075.301l-.007.03a7.63 7.63 0 00-.057.267l-.008.048c-.015.074-.026.148-.038.223L.082 8.4c-.011.078-.02.156-.029.234-.006.051-.013.103-.017.154a6.57 6.57 0 00-.02.26c-.003.044-.007.086-.009.13-.004.128-.007.257-.007.386v4.056c0 1.478.42 2.741 1.138 3.692A4.75 4.75 0 002.73 18.67l9.015 4.753c-1.656-.874-2.728-2.685-2.73-5.051v-4.056c0-.13.004-.26.01-.39.002-.043.006-.085.01-.128.005-.088.01-.174.019-.261l.017-.155c.01-.077.018-.155.029-.234l.026-.164c.013-.074.025-.15.039-.223.02-.105.04-.21.064-.313l.008-.031c.023-.1.048-.201.075-.301l.023-.088c.028-.1.058-.202.09-.302l.008-.025.021-.063c.036-.11.073-.22.113-.33l.052-.134c.031-.085.065-.169.1-.253.022-.056.047-.111.07-.166a13.856 13.856 0 01.164-.358c.03-.063.06-.126.092-.188l.088-.172a9.22 9.22 0 01.187-.338l.096-.164c.034-.057.069-.112.104-.168l.1-.159a10.49 10.49 0 01.567-.786l.123-.155.116-.139c.05-.057.098-.115.148-.171a14.092 14.092 0 01.272-.297 9.706 9.706 0 01.432-.425c.088-.083.177-.163.268-.241l.054-.048a10.08 10.08 0 01.553-.435l.092-.068c.075-.053.15-.105.226-.156.019-.013.038-.028.06-.04a9.18 9.18 0 01.362-.227c.08-.047.16-.094.241-.139l.11-.058a7.643 7.643 0 01.521-.256l.126-.056a7.509 7.509 0 01.546-.208l.107-.037c.11-.036.22-.069.33-.1l.63-.172c.095-.026.191-.05.287-.072l.097-.02c.062-.014.125-.029.187-.04l.114-.018c.055-.01.11-.02.166-.028.04-.006.08-.01.12-.014.053-.007.105-.014.157-.019l.083-.006c.061-.005.123-.01.184-.013.034-.003.067-.003.101-.004l.16-.006h.11a3.187 3.187 0 01.261.008l.153.01.067.007c.064.006.128.013.192.022l.043.005a5.232 5.232 0 01.281.047l.141.03c.073.016.146.035.218.053l.07.019c.094.026.187.055.278.087l.067.025a4.326 4.326 0 01.449.19l.143.072L11.617.576z"></path></svg>

package/src/assets/icons/trae-color.svg

@@ -0,0 +1 @@
+<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>TRAE</title><path d="M24 20.541H3.428v-3.426H0V3.4h24V20.54zM3.428 17.115h17.144V6.827H3.428v10.288zm8.573-5.196l-2.425 2.424-2.424-2.424 2.424-2.424 2.425 2.424zm6.857-.001l-2.424 2.423-2.425-2.423 2.425-2.425 2.424 2.425z" fill="#32F08C"></path></svg>

package/src/assets/icons/workbuddy-color.svg

@@ -0,0 +1 @@
+<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Yuanbao</title><path d="M7.063 1.664C5.198 3.338 4.395 6.67 5.782 8.568c1.47 2.014 4.79 1.745 6.953.113 2.434-1.84 6.033-1.793 7.23.953.91 2.207.067 4.927-2.113 6.483-4.302 3.097-10.577 2.52-13.472-1.444-2.86-3.915-1.35-9.696 2.683-13.011v.002z" fill="#fff"></path><path d="M12.007.647C5.384.647.015 5.734.015 12.007s5.369 11.36 11.992 11.36C18.631 23.366 24 18.28 24 12.006 24 5.732 18.631.647 12.007.647zm5.846 15.472C13.55 19.216 7.275 18.64 4.38 14.675 1.521 10.759 3.03 4.979 7.064 1.664 5.199 3.338 4.396 6.67 5.782 8.568c1.47 2.014 4.791 1.745 6.954.112 2.433-1.838 6.032-1.792 7.23.954.91 2.207.067 4.926-2.113 6.483v.002z" fill="#00CC70"></path><path d="M14.801 14.904a.669.669 0 01-.536-.269l-1.02-1.37a.67.67 0 01.006-.806l1.02-1.328a.668.668 0 011.059.815l-.712.925.72.963a.67.67 0 01-.535 1.066l-.002.004zm-3.931-2.001c0 1.797-.356 2.135-1.16 2.135-.806 0-1.162-.338-1.162-2.135 0-1.796.357-2.134 1.161-2.134.805 0 1.162.338 1.162 2.134h-.001z" fill="#1C1C1C"></path></svg>

package/src/assets/icons/zcode-color.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Z.ai</title><path d="M12.105 2L9.927 4.953H.653L2.83 2h9.276zM23.254 19.048L21.078 22h-9.242l2.174-2.952h9.244zM24 2L9.264 22H0L14.736 2H24z"></path></svg>

package/src/main/adapters/acp-interactions.js

@@ -0,0 +1,132 @@
+const { randomUUID } = require('node:crypto');
+
+// One UI question at a time; keep the native request pending until all answers
+// are validated and (for CodeBuddy) the native interruption has been resolved.
+class AcpInteractions {
+  constructor(session, vendor) { this.session = session; this.vendor = vendor; this.pending = new Map(); this.generation = 0; }
+  ask(view, validate, finish, cancelValue) {
+    const requestId = randomUUID();
+    return new Promise(resolve => {
+      this.pending.set(requestId, { validate, finish, cancelValue, resolve, busy: false });
+      this.session.emit({ kind: 'approval', requestId, ...view });
+    });
+  }
+  async respond(id, response) {
+    const p = this.pending.get(id);
+    if (!p || p.busy) throw new Error('Native interaction is not awaiting a response');
+    p.busy = true;
+    try {
+      const value = response.cancelled ? p.cancelValue : p.validate(response);
+      const result = p.finish ? await p.finish(value) : value;
+      if (!this.pending.has(id)) throw new Error('Native interaction was cancelled');
+      this.pending.delete(id);
+      p.resolve(result);
+    } finally { p.busy = false; }
+  }
+  close() {
+    this.generation++;
+    for (const [requestId, p] of this.pending) {
+      p.resolve(p.cancelValue);
+      this.session.emit({ kind: 'interaction-responded', requestId });
+    }
+    this.pending.clear();
+  }
+  async questions(questions, title, onComplete) {
+    if (!Array.isArray(questions) || !questions.length || questions.length > 20) throw new Error('Invalid native questions');
+    const answers = {};
+    for (const q of questions) {
+      if (!q.id || !q.prompt || Object.hasOwn(answers, q.id)) throw new Error('Invalid native question identity');
+      const values = (q.options || []).map(o => o.id);
+      if (new Set(values).size !== values.length || values.some(v => typeof v !== 'string' || !v)) throw new Error('Invalid native choices');
+      const selected = await this.ask({
+        title, message: q.prompt, method: q.multiple || !values.length ? 'input' : 'select',
+        ...(!q.multiple ? { options: q.options } : {}),
+        placeholder: q.multiple ? `输入 JSON 数组选择多项：${JSON.stringify(values)}` : '请输入回答',
+        ...(q.multiple ? { message: q.prompt + '\n' + q.options.map(o => `${o.id}: ${o.label}`).join('\n') } : {}),
+      }, response => {
+        const raw = response.optionId ?? response.value;
+        const list = q.multiple ? (Array.isArray(raw) ? raw : JSON.parse(raw)) : [raw];
+        if (!Array.isArray(list) || !list.length || list.some(v => typeof v !== 'string' || !v.trim()) || new Set(list).size !== list.length) throw new Error('A native answer is required');
+        if (values.length && !q.other && list.some(v => !values.includes(v))) throw new Error('Select an option offered by the native agent');
+        return list;
+      }, onComplete && q === questions.at(-1) ? async list => {
+        if (list) await onComplete({ ...answers, [q.id]: list });
+        return list;
+      } : null, null);
+      if (!selected || !this.session.active) return null;
+      answers[q.id] = selected;
+    }
+    return answers;
+  }
+  permission(params) {
+    const tool = params.toolCall || {};
+    if (this.vendor === 'codebuddy' && tool._meta?.['codebuddy.ai/toolName'] === 'AskUserQuestion') {
+      return this.codeBuddyQuestion(tool.rawInput, async answers => {
+        const result = await this.session.request('_codebuddy.ai/resolveInterruption', {
+          sessionId: this.session.nativeSessionId, toolCallId: tool.toolCallId,
+          decision: answers ? 'allow' : 'deny', ...(answers ? { answers } : {}),
+        });
+        if (result.resolved !== true) throw new Error('CodeBuddy did not resolve the question');
+        return { outcome: { outcome: 'cancelled' } };
+      });
+    }
+    const nativeOptions = (params.options || []).filter(o => ['allow_once', 'allow_always', 'reject_once', 'reject_always'].includes(o.kind));
+    const options = [];
+    for (const o of nativeOptions) {
+      const consent = this.vendor === 'kiro-cli' ? params._meta?.kiro?.consent : null;
+      if (this.vendor === 'kiro-cli' && o.kind === 'allow_always') {
+        const resource = consent?.triggeringResource ?? consent?.resource;
+        if (!consent?.capability || typeof resource !== 'string' || consent.persistableConsent === false || consent.askType === 'explicit') continue;
+        for (const scope of ['session', ...(consent.workspaceRoot ? ['workspace'] : [])]) options.push({ ...o,
+          optionId: JSON.stringify([o.optionId, scope]), name: `${o.name || '允许'} (${scope === 'session' ? '本会话' : '工作区'}) · ${resource}`,
+          response: { outcome: { outcome: 'selected', optionId: o.optionId }, _meta: { kiro: { consent: {
+            capability: consent.capability, scope, resource, ...(consent.workspaceRoot ? { workspaceRoot: consent.workspaceRoot } : {}),
+          } } } },
+        });
+      } else options.push(o);
+    }
+    if (!options.length) throw new Error('Native agent supplied no usable approval choices');
+    return this.ask({ method: 'select', title: tool.title || 'Native tool approval', message: JSON.stringify(tool.rawInput ?? {}).slice(0, 16000),
+      options: options.map(o => ({ id: o.optionId, label: o.name || o.optionId, kind: o.kind.startsWith('reject') ? 'reject' : undefined })),
+    }, response => {
+      const selected = response.optionId ?? response.value;
+      const option = options.find(o => o.optionId === selected);
+      if (!option) throw new Error('Choose an exact native approval option');
+      return option.response || { outcome: { outcome: 'selected', optionId: option.optionId } };
+    }, null, { outcome: { outcome: 'cancelled' } });
+  }
+  async codeBuddyQuestion(schema, finish) {
+    const generation = this.generation;
+    const questions = (schema?.questions || []).map((q, i) => ({ id: q.id || `q_${i}`, prompt: q.question,
+      options: (q.options || []).map(o => ({ id: o.label, label: o.label })), multiple: q.multiSelect === true, other: true }));
+    let result;
+    const answers = await this.questions(questions, 'CodeBuddy', async answers => { result = await finish(answers); });
+    if (!answers) return this.session.active && generation === this.generation ? finish(null) : { outcome: { outcome: 'cancelled' } };
+    return result;
+  }
+  async request(method, params) {
+    if (!this.session.active) throw new Error('Native interaction outside active turn');
+    if (params.sessionId && params.sessionId !== this.session.nativeSessionId) throw new Error('Native interaction session mismatch');
+    if (method === 'session/request_permission') return this.permission(params);
+    if (this.vendor === 'codebuddy' && method === '_codebuddy.ai/question') return this.codeBuddyQuestion(params.schema, answers => answers ? { outcome: 'submitted', answers } : { outcome: 'cancelled' });
+    if (this.vendor === 'kiro-cli' && method === '_kiro/userInput') {
+      const answers = await this.questions([{ id: 'q', prompt: params.question, options: params.options?.map(o => ({ id: o.title, label: o.title })) }], 'Kiro');
+      return answers ? { action: 'answered', answer: answers.q[0] } : { action: 'dismissed' };
+    }
+    if (this.vendor === 'cursor-cli' && method === 'cursor/ask_question') {
+      const answers = await this.questions((params.questions || []).map(q => ({ id: q.id, prompt: q.prompt, options: q.options, multiple: q.allowMultiple === true })), params.title || 'Cursor');
+      return { outcome: answers ? { outcome: 'answered', answers: Object.entries(answers).map(([questionId, selectedOptionIds]) => ({ questionId, selectedOptionIds })) } : { outcome: 'cancelled' } };
+    }
+    if (this.vendor === 'cursor-cli' && method === 'cursor/create_plan' && typeof params.plan === 'string') {
+      return this.ask({ method: 'select', title: params.name || 'Cursor plan', message: params.plan,
+        options: [{ id: 'accept', label: '接受计划' }, { id: 'reject', label: '拒绝计划', kind: 'reject' }],
+      }, response => {
+        const selected = response.optionId ?? response.value;
+        if (!['accept', 'reject'].includes(selected)) throw new Error('Choose accept or reject');
+        return { outcome: { outcome: selected === 'accept' ? 'accepted' : 'rejected' } };
+      }, null, { outcome: { outcome: 'cancelled' } });
+    }
+    throw new Error(`Unsupported native ACP client request: ${method}`);
+  }
+}
+module.exports = { AcpInteractions };

package/src/main/adapters/acp.js

@@ -0,0 +1,191 @@
+const { execFile } = require('node:child_process');
+const { randomUUID } = require('node:crypto');
+const { JsonlProcess, cliSpawn } = require('../host/jsonl');
+
+const textOf = content => Array.isArray(content) ? content.map(c => c.text ?? c.content?.text ?? '').filter(Boolean).join('\n') : content?.text || '';
+function catalog(session) {
+  const options = session.state.configOptions || [];
+  const modelConfig = options.find(o => o.category === 'model' || o.id === 'model');
+  const effort = options.find(o => o.id === 'effortLevel' || o.category === 'thought_level');
+  const modeConfig = options.find(o => o.category === 'mode');
+  const nativeModels = session.state.models?.availableModels || [];
+  const models = modelConfig ? (modelConfig.options || []).filter(o => o.value).map(o => ({ id: o.value, name: o.name, isDefault: o.value === modelConfig.currentValue }))
+    : nativeModels.map(m => ({ id: m.modelId, name: m.name || m.modelId, isDefault: m.modelId === session.state.models?.currentModelId }));
+  const current = nativeModels.find(m => m.modelId === session.state.models?.currentModelId);
+  return { models,
+    thinkingLevels: effort && modelConfig?.currentValue !== 'auto' ? (effort.options || []).filter(e => e.value).map(e => ({ id: e.value, label: e.name || e.value })) : (current?._meta?.reasoningEfforts || []).map(e => ({ id: e.id, label: e.label || e.id })),
+    permissionModes: modeConfig ? (modeConfig.options || []).map(o => ({ id: o.value, label: o.name, description: o.description, default: o.value === modeConfig.currentValue }))
+      : (session.state.modes?.availableModes || []).map(m => ({ id: m.id, label: m.name, default: m.id === session.state.modes.currentModeId })),
+  };
+}
+
+// 能力声明按 Harness 文档化支持面逐项传入；默认值保持 ACP 家族基线（事件只在原生端真正发出时才投影）。
+function acpAdapter({ id, name, bin, args, executable = false, images = false, fork = false, thinking = false, permissions = false,
+  questions = true, compaction = true, usage = true, contextUsage = true, resolveCommand, inspectCustom, requestTimeoutMs = 0 }) {
+  const manifest = { id, name, icon: `${id}-color.svg`, aliases: [id], capabilities: { collaborationTools: true, streaming: true, thinking: true, tools: true, approvals: true,
+    questions, models: true, thinkingLevels: thinking, permissionModes: permissions, resume: true, fork, forkFromMessage: false,
+    compaction, usage, contextUsage, attachments: images } };
+  function command(argv) {
+    if (typeof resolveCommand === 'function') {
+      const resolved = resolveCommand(argv);
+      if (resolved) return resolved;
+    }
+    if (typeof bin === 'function') return bin(argv);
+    if (executable) {
+      if (process.platform === 'win32' && (bin.toLowerCase().endsWith('.cmd') || bin.toLowerCase().endsWith('.bat'))) {
+        return cliSpawn(bin.replace(/\.(cmd|bat)$/i, ''), argv);
+      }
+      return { command: bin, args: argv };
+    }
+    return cliSpawn(bin, argv);
+  }
+  function create() {
+    const adapter = {
+      async inspect() {
+        if (typeof inspectCustom === 'function') {
+          try { return await inspectCustom(); } catch (e) { return { available: false, detail: `${name} CLI 不可用: ${e.message}` }; }
+        }
+        try {
+          const cli = command(['--version']);
+          return await new Promise(resolve => execFile(cli.command, cli.args, { windowsHide: true, timeout: 10000 }, (error, out) => resolve({ available: !error, detail: error ? `${name} CLI 不可用` : (out || '').trim() })));
+        } catch (error) {
+          return { available: false, detail: `${name} CLI 不可用: ${error.message}` };
+        }
+      },
+      async describe() { return { models: null, thinkingLevels: [], permissionModes: [] }; },
+      async open({ thread, emit, diagnostic = () => {}, collaboration }) {
+        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 })) }] : [],
+          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,
+          onExit: error => { for (const pending of session.pendingApprovals.values()) pending.reject(error); session.pendingApprovals.clear(); },
+          onRequest: request => {
+            if (request.method !== 'session/request_permission') throw new Error(`Unsupported ACP client request: ${request.method}`);
+            const requestId = randomUUID();
+            return new Promise((resolve, reject) => {
+              const options = request.params.options || [];
+              session.pendingApprovals.set(requestId, { resolve, reject, options });
+              emit({ kind: 'approval', requestId, method: 'confirm', title: request.params.toolCall?.title || 'Native tool permission' });
+            });
+          },
+          onEvent: event => {
+            if (event.method !== 'session/update') return;
+            const u = event.params.update;
+            if (u.sessionUpdate === 'config_option_update') session.state.configOptions = u.configOptions;
+            if (u.sessionUpdate === 'available_commands_update') session.state.commands = u.availableCommands || [];
+            if (u.sessionUpdate === 'current_mode_update' && session.state.modes) session.state.modes.currentModeId = u.currentModeId;
+            if (session.state.loading) return;
+            if (u.sessionUpdate === 'agent_message_chunk') emit({ kind: 'text-delta', text: textOf(u.content) });
+            if (u.sessionUpdate === 'agent_thought_chunk') emit({ kind: 'thinking-delta', text: textOf(u.content) });
+            if (u.sessionUpdate === 'tool_call' || u.sessionUpdate === 'tool_call_update') {
+              const tool = { ...session.tools.get(u.toolCallId), ...u };
+              session.tools.set(u.toolCallId, tool);
+              const output = textOf(tool.content);
+              emit({ kind: 'tool', toolCallId: tool.toolCallId, title: tool.title || tool.kind || 'tool', state: tool.status === 'completed' ? 'completed' : tool.status === 'failed' ? 'error' : 'running',
+                input: typeof tool.rawInput === 'string' ? tool.rawInput : JSON.stringify(tool.rawInput),
+                output: output || (typeof tool.rawOutput === 'string' ? tool.rawOutput : JSON.stringify(tool.rawOutput)) });
+              const changes = (tool.content || []).filter(c => c.type === 'diff').map(c => ({ path: c.path, before: c.oldText ?? '', after: c.newText, changeType: c.oldText == null ? 'added' : 'modified', complete: true }));
+              if (tool.status === 'completed' && changes.length) emit({ kind: 'file-change', source: 'native', changes });
+            }
+            if (u.sessionUpdate === 'plan') emit({ kind: 'plan', entries: u.entries });
+            if (u.sessionUpdate === 'usage_update') {
+              session.state.usage = { tokens: u.used, contextWindow: u.size, ...(u.cost?.currency === 'USD' ? { cost: u.cost.amount } : {}) };
+              emit({ kind: 'usage', usage: session.state.usage });
+            }
+          },
+        });
+        if (requestTimeoutMs) {
+          const request = session.process.request.bind(session.process);
+          session.process.request = (method, params) => {
+            if (method === 'session/prompt') return request(method, params);
+            let timer;
+            return Promise.race([request(method, params), new Promise((_, reject) => {
+              timer = setTimeout(() => { reject(new Error(`${name} ${method} timed out`)); session.process.stop(); }, requestTimeoutMs);
+            })]).finally(() => clearTimeout(timer));
+          };
+        }
+        try {
+          const init = await session.process.request('initialize', { protocolVersion: 1, clientCapabilities: { fs: { readTextFile: false, writeTextFile: false }, terminal: false }, clientInfo: { name: 'harness-mix', version: '0.1.0' } });
+          session.state.agentCapabilities = init.agentCapabilities;
+          session.state.commands = init._meta?.availableCommands || [];
+          const result = await session.process.request(thread.restore ? 'session/load' : 'session/new', { cwd: thread.cwd, mcpServers: session.mcpServers, ...(thread.restore ? { sessionId: thread.nativeSessionId } : {}) });
+          session.nativeSessionId = result.sessionId || thread.nativeSessionId;
+          session.state.configOptions = result.configOptions || [];
+          session.state.models = result.models || init._meta?.modelState;
+          session.state.modes = result.modes;
+          session.state.loading = false;
+          const models = catalog(session).models;
+          session.model = models.find(m => m.isDefault) || models[0];
+          if (thread.options?.model) await adapter.setModel(session, thread.options.model);
+          if (thread.options?.thinking) await adapter.setThinkingLevel(session, thread.options.thinking);
+          if (thread.options?.permissionMode) await adapter.setPermissionMode(session, thread.options.permissionMode);
+          emit({ kind: 'session', nativeSessionId: session.nativeSessionId, model: session.model });
+          return session;
+        } catch (error) { session.process.stop(); throw error; }
+      },
+      async describeFor(session) { return catalog(session); },
+      // 契约要求：models 能力 ⇒ 按会话返回模型目录（ACP 目录来自 session/new 的 configOptions/models）
+      async listModelsFor(session) { return catalog(session).models; },
+      async send(session, text, hooks, attachments) {
+        if (attachments?.images?.length && !session.state.agentCapabilities?.promptCapabilities?.image) throw new Error(`${name} 原生 ACP 不支持图片`);
+        const prompt = [...(text ? [{ type: 'text', text }] : []), ...(attachments?.images || []).map(i => ({ type: 'image', data: i.data, mimeType: i.mime }))];
+        const result = await session.process.request('session/prompt', { sessionId: session.nativeSessionId, prompt });
+        hooks.emit({ kind: 'completed', finalAnswer: result.stopReason !== 'cancelled' });
+      },
+      async cancel(session) { session.process.notify('session/cancel', { sessionId: session.nativeSessionId }); },
+      async respond(session, requestId, response) {
+        const pending = session.pendingApprovals.get(requestId);
+        if (!pending) throw new Error('Unknown native approval');
+        const option = pending.options.find(o => o.kind === (response.confirmed ? 'allow_once' : 'reject_once'));
+        if (response.confirmed && !option) throw new Error('Native agent offers no single-use approval');
+        pending.resolve({ outcome: option ? { outcome: 'selected', optionId: option.optionId } : { outcome: 'cancelled' } });
+        session.pendingApprovals.delete(requestId);
+      },
+      async setModel(session, model) {
+        const config = session.state.configOptions.find(c => c.category === 'model' || c.id === 'model');
+        if (config) {
+          const result = await session.process.request('session/set_config_option', { sessionId: session.nativeSessionId, configId: config.id, value: model.id });
+          session.state.configOptions = result.configOptions || session.state.configOptions;
+        } else await session.process.request('session/set_model', { sessionId: session.nativeSessionId, modelId: model.id });
+        if (session.state.models) session.state.models.currentModelId = model.id;
+        session.model = model; return model;
+      },
+      async setThinkingLevel(session, level) {
+        if (!catalog(session).thinkingLevels.some(l => l.id === level)) throw new Error('Native reasoning level unavailable');
+        const config = session.state.configOptions.find(c => c.id === 'effortLevel' || c.category === 'thought_level');
+        if (config) {
+          const result = await session.process.request('session/set_config_option', { sessionId: session.nativeSessionId, configId: config.id, value: level });
+          session.state.configOptions = result.configOptions || session.state.configOptions;
+          return;
+        }
+        await session.process.request('session/set_mode', { sessionId: session.nativeSessionId, modeId: level });
+      },
+      async setPermissionMode(session, mode) {
+        if (!catalog(session).permissionModes.some(m => m.id === mode)) throw new Error('Native permission mode unavailable');
+        const config = session.state.configOptions.find(c => c.category === 'mode');
+        if (config) {
+          const result = await session.process.request('session/set_config_option', { sessionId: session.nativeSessionId, configId: config.id, value: mode });
+          session.state.configOptions = result.configOptions || session.state.configOptions;
+        } else await session.process.request('session/set_mode', { sessionId: session.nativeSessionId, modeId: mode });
+      },
+      async listCommands(session) { return (session?.state.commands || []).map(c => ({ id: c.name, label: '/' + c.name, description: c.description, action: 'insert' })); },
+      async executeCommand(session, id, hooks) { await adapter.send(session, '/' + id, hooks); },
+      async getContextUsage(session) { return session.state.usage; },
+      async fork(source, context) {
+        if (!fork || context.message) throw new Error('Native ACP does not support this fork boundary');
+        const probe = await adapter.open({ thread: { ...source, restore: true }, emit: () => {}, diagnostic: context.diagnostic });
+        try {
+          const result = await probe.process.request('session/fork', { sessionId: source.nativeSessionId, cwd: source.cwd });
+          return { session: await adapter.open({ thread: { ...source, nativeSessionId: result.sessionId, restore: true }, emit: context.emit, diagnostic: context.diagnostic }) };
+        } finally { await adapter.close(probe); }
+      },
+      async close(session) { session.process.stop(); },
+    };
+    return adapter;
+  }
+  return { manifest, create };
+}
+module.exports = { acpAdapter, catalog };