ai_co_discuss 0.2.13 → 0.2.14

package/runner/discussion_adapters.mjs

@@ -537,6 +537,7 @@ export function setup_sidecar(config, root = join(homedir(), '.gemini', 'config'
 
 /** Select only allowlisted adapter types from local configuration. */
 export async function deliver_task(config, binding, task, spawn_process = spawn, user_home = homedir()) {
+  if (config.adapter === 'api') return (await import('./api_participant.mjs')).api_delivery(config, binding, task);
   const adapters = { codex: codex_delivery, claude: claude_delivery, antigravity: antigravity_delivery,
     codex_cli: cli_delivery, antigravity_cli: cli_delivery };
   if (!adapters[config.adapter]) throw new Error('不支持的软件适配器');

package/runner/discussion_api.mjs

@@ -0,0 +1,146 @@
+/** Provider presets and independent wire protocols; model IDs are never rewritten. */
+import { randomUUID } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+export const API_PROVIDERS = {
+  Codex: { label: 'OpenAI', base_url: 'https://api.openai.com/v1', api_protocol: 'responses', models: ['gpt-6.1-sol', 'gpt-6-astra', 'gpt-6-luna'] },
+  Claude: { label: 'Anthropic', base_url: 'https://api.anthropic.com/v1', api_protocol: 'anthropic', models: ['claude-sonnet-5-5', 'claude-opus-5-5', 'claude-haiku-5-5', 'claude-fable-5-1'] },
+  Gemini: { label: 'Google', base_url: 'https://generativelanguage.googleapis.com/v1beta', api_protocol: 'gemini', models: ['gemini-4-argon', 'gemini-3.8-flash'] },
+  DeepSeek: { label: 'DeepSeek', base_url: 'https://api.deepseek.com/v1', api_protocol: 'chat', models: ['deepseek-flash', 'deepseek-v4-pro'] },
+  Qwen: { label: '阿里云百炼', base_url: 'https://dashscope.aliyuncs.com/compatible-mode/v1', api_protocol: 'chat', models: ['qwen3.8-flash', 'qwen3.7-plus', 'qwen3.8-max'] },
+  Grok: { label: 'xAI', base_url: 'https://api.x.ai/v1', api_protocol: 'responses', models: ['grok-4.7'] },
+};
+const PROTOCOLS = ['responses', 'chat', 'anthropic', 'gemini'];
+const REQUEST_TIMEOUT_MS = 180_000;
+const MAX_OUTPUT_TOKENS = 8192;
+
+/** Validate an explicit API root, keeping custom gateway paths intact. */
+export function api_base_url(value) {
+  const url = new URL(value);
+  if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.search || url.hash) throw new Error('Base URL 须为不含凭据、查询或片段的 HTTP(S) 地址');
+  return url.href.replace(/\/+$/, '');
+}
+
+/** Check protocol/model independently of provider identity. */
+export function validate_api_profile(profile) {
+  api_base_url(profile.base_url);
+  if (!PROTOCOLS.includes(profile.api_protocol)) throw new Error('请选择 API 请求协议');
+  if (!profile.model || typeof profile.model !== 'string') throw new Error('请填写 API 模型 ID');
+  if (!/^[a-f0-9-]{36}$/i.test(profile.api_key_ref || '')) throw new Error('请保存此 Base URL 对应的 API Key');
+}
+
+/** Save a key privately; browsers and room configuration receive only an opaque reference. */
+export function save_api_key(home, input) {
+  const base_url = api_base_url(input.base_url);
+  const api_key = typeof input.api_key === 'string' ? input.api_key.trim() : '';
+  if (!api_key || /[\r\n]/.test(api_key)) throw new Error('API Key 不能为空或包含换行');
+  const api_key_ref = randomUUID();
+  const directory = join(home, 'api-keys');
+  mkdirSync(directory, { recursive: true, mode: 0o700 });
+  writeFileSync(join(directory, `${api_key_ref}.json`), JSON.stringify({ base_url, api_key }), { flag: 'wx', mode: 0o600 });
+  return { api_key_ref };
+}
+
+/** Resolve only a validated reference bound to this exact API root. */
+export function read_api_key(home, profile) {
+  validate_api_profile(profile);
+  let saved;
+  try { saved = JSON.parse(readFileSync(join(home, 'api-keys', `${profile.api_key_ref}.json`), 'utf8')); }
+  catch { throw new Error('本机 API Key 不存在，请重新保存'); }
+  if (saved.base_url !== api_base_url(profile.base_url)) throw new Error('Base URL 已变化，请为新地址重新填写 API Key');
+  return saved.api_key;
+}
+
+/** Convert neutral tool definitions to one provider's request body. */
+export function api_request(profile, context) {
+  const { system, history, tools } = context;
+  const model = profile.model;
+  const functions = tools.map(tool => ({ name: tool.name, description: tool.description, parameters: tool.parameters }));
+  if (profile.api_protocol === 'responses') return { path: '/responses', body: { model, instructions: system, input: history,
+    tools: functions.map(tool => ({ type: 'function', ...tool, strict: false })), store: false,
+    include: ['reasoning.encrypted_content'], max_output_tokens: MAX_OUTPUT_TOKENS } };
+  if (profile.api_protocol === 'anthropic') return { path: '/messages', body: { model, system, messages: history,
+    tools: functions.map(({ parameters, ...tool }) => ({ ...tool, input_schema: parameters })), max_tokens: MAX_OUTPUT_TOKENS } };
+  if (profile.api_protocol === 'gemini') return { path: `/models/${encodeURIComponent(model.replace(/^models\//, ''))}:generateContent`, body: {
+    systemInstruction: { parts: [{ text: system }] }, contents: history,
+    tools: [{ functionDeclarations: functions }], generationConfig: { maxOutputTokens: MAX_OUTPUT_TOKENS } } };
+  return { path: '/chat/completions', body: { model, messages: [{ role: 'system', content: system }, ...history],
+    tools: functions.map(tool => ({ type: 'function', function: tool })) } };
+}
+
+/** Build authentication without encoding keys into URLs. */
+function api_headers(protocol, key) {
+  if (protocol === 'anthropic') return { 'x-api-key': key, 'anthropic-version': '2023-06-01' };
+  if (protocol === 'gemini') return { 'x-goog-api-key': key };
+  return { Authorization: `Bearer ${key}` };
+}
+
+/** A bounded request; errors expose only status, never provider bodies or authorization. */
+async function provider_fetch(profile, key, request, signal) {
+  let response;
+  try {
+    response = await fetch(`${api_base_url(profile.base_url)}${request.path}`, {
+      method: request.body === undefined ? 'GET' : 'POST', redirect: 'error',
+      headers: { 'Content-Type': 'application/json', ...api_headers(profile.api_protocol, key) },
+      body: request.body === undefined ? undefined : JSON.stringify(request.body),
+      signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(REQUEST_TIMEOUT_MS)]) : AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    });
+  } catch { throw new Error(signal?.aborted ? 'API 执行已取消' : 'API 请求超时或连接失败，请核对 Base URL'); }
+  if (!response.ok) throw new Error(`模型 API 返回 HTTP ${response.status}，请核对地址、密钥、模型和请求协议`);
+  try { return await response.json(); } catch { throw new Error('模型 API 返回的内容不是有效 JSON'); }
+}
+
+/** Fetch model IDs as returned by the provider; manual entry remains available. */
+export async function api_models(home, profile) {
+  const key = read_api_key(home, profile);
+  const data = await provider_fetch(profile, key, { path: '/models' });
+  const models = (data.data || data.models || []).map(model => ({ id: model.id || model.name?.replace(/^models\//, ''), label: model.displayName || model.id || model.name }))
+    .filter(model => typeof model.id === 'string');
+  return { adapter: 'api', models, error: '', source: 'api' };
+}
+
+/** Start protocol-specific history with a user request. */
+export function api_history(profile, prompt) {
+  return profile.api_protocol === 'gemini' ? [{ role: 'user', parts: [{ text: prompt }] }] : [{ role: 'user', content: prompt }];
+}
+
+/** Preserve raw reasoning/signature blocks for subsequent tool turns, without displaying them. */
+export function api_response(profile, data, history) {
+  if (profile.api_protocol === 'responses') {
+    if (data.status === 'incomplete' || data.error) throw new Error('模型 API 未完成回答');
+    const output = data.output || [];
+    history.push(...output);
+    return output.filter(item => item.type === 'function_call').map(item => ({ id: item.call_id, name: item.name, arguments: item.arguments }));
+  }
+  if (profile.api_protocol === 'anthropic') {
+    if (data.stop_reason === 'max_tokens') throw new Error('模型 API 输出超过单次长度限制');
+    history.push({ role: 'assistant', content: data.content });
+    return (data.content || []).filter(item => item.type === 'tool_use').map(item => ({ id: item.id, name: item.name, arguments: item.input }));
+  }
+  if (profile.api_protocol === 'gemini') {
+    const candidate = data.candidates?.[0];
+    if (!candidate?.content || candidate.finishReason === 'MAX_TOKENS') throw new Error('模型 API 未完成回答');
+    history.push(candidate.content);
+    return (candidate.content.parts || []).filter(item => item.functionCall).map(item => ({ name: item.functionCall.name, arguments: item.functionCall.args }));
+  }
+  const choice = data.choices?.[0];
+  if (!choice?.message || choice.finish_reason === 'length') throw new Error('模型 API 未完成回答');
+  history.push(choice.message);
+  return (choice.message.tool_calls || []).map(item => ({ id: item.id, name: item.function.name, arguments: item.function.arguments }));
+}
+
+/** Append all results together so parallel tool calls retain their protocol's pairing. */
+export function api_tool_results(profile, history, results) {
+  if (profile.api_protocol === 'anthropic') return history.push({ role: 'user', content: results.map(item => ({ type: 'tool_result', tool_use_id: item.id, content: JSON.stringify(item.result) })) });
+  if (profile.api_protocol === 'gemini') return history.push({ role: 'user', parts: results.map(item => ({ functionResponse: { name: item.name, response: { result: item.result } } })) });
+  history.push(...results.map(item => profile.api_protocol === 'responses'
+    ? { type: 'function_call_output', call_id: item.id, output: JSON.stringify(item.result) }
+    : { role: 'tool', tool_call_id: item.id, content: JSON.stringify(item.result) }));
+}
+
+/** Generate one tool-call turn with the selected wire protocol. */
+export async function api_generate(profile, key, context, signal) {
+  const data = await provider_fetch(profile, key, api_request(profile, context), signal);
+  return api_response(profile, data, context.history);
+}

package/runner/discussion_launch.mjs

@@ -9,12 +9,13 @@ import { parseArgs } from 'node:util';
 
 import { atomic_json } from './discussion_adapters.mjs';
 import { software_models } from './discussion_models.mjs';
+import { API_PROVIDERS, api_models, save_api_key, validate_api_profile } from './discussion_api.mjs';
 import { acquire_lock, api, CODEX_ADAPTERS, DiscussionStore, service_drafts, task_files, validate_config } from './discussion_runner.mjs';
 import { assert_shared_home, CONNECTION_FIELDS, configuration_snapshot, read_registry, registered_identity, register_room, service_home, service_pid, start_service } from './discussion_service.mjs';
 
-const CLIENTS = { Codex: ['codex_cli', 'codex'], Claude: ['claude'], Gemini: ['antigravity_cli', 'antigravity'] };
+const CLIENTS = { Codex: ['codex_cli', 'codex', 'api'], Claude: ['claude', 'api'], Gemini: ['antigravity_cli', 'antigravity', 'api'], DeepSeek: ['api'], Qwen: ['api'], Grok: ['api'] };
 // A platform is a type; `Claude-评审` is another Claude instance with its own session, model and effort.
-const INSTANCE_PATTERN = /^(Codex|Claude|Gemini|DeepSeek|Qwen)(?:-[0-9A-Za-z_一-鿿]{1,16})?$/;
+const INSTANCE_PATTERN = /^(Codex|Claude|Gemini|DeepSeek|Qwen|Grok)(?:-[0-9A-Za-z_一-鿿]{1,16})?$/;
 
 /** The platform of an AI instance name, or null. */
 export function platform_of(name) { return typeof name === 'string' ? INSTANCE_PATTERN.exec(name)?.[1] ?? null : null; }
@@ -29,7 +30,7 @@ export function next_instance(platform, taken) {
 function clients_of(name) { return CLIENTS[platform_of(name)]; }
 // Reasoning effort is a separate CLI argument only for Codex and Claude; agy encodes it in the model name.
 const EFFORT_LEVELS = { codex_cli: ['low', 'medium', 'high', 'xhigh', 'max', 'ultra'], claude: ['low', 'medium', 'high', 'xhigh', 'max'] };
-const PROFILE_FIELDS = ['adapter', 'executable', 'model', 'effort', 'source_thread_id', 'ipc_directory', 'allowed_tools', 'cwd', 'project_name', 'project_id'];
+const PROFILE_FIELDS = ['adapter', 'executable', 'model', 'effort', 'source_thread_id', 'ipc_directory', 'allowed_tools', 'cwd', 'project_name', 'project_id', 'base_url', 'api_protocol', 'api_key_ref'];
 const MAX_MINUTES = 1440;
 const CONFIG_APPLY_TIMEOUT_MS = 6000;
 const CONFIG_APPLY_POLL_MS = 100;
@@ -38,6 +39,7 @@ const HELP = `用法：codiscuss launch settings [--file FILE]
       codiscuss launch room-config --file FILE
       codiscuss launch room-models --file FILE
       codiscuss launch models --file FILE
+      codiscuss launch api-key --file FILE
       codiscuss launch room-member --file FILE
       codiscuss launch pick-directory
 
@@ -45,7 +47,8 @@ settings 读取本机软件默认配置；指定文件时保存，不启动 AI
 start 使用启动 JSON 创建或接入房间并启动；--dry-run 只校验和预览。
 room-config 修正已暂停房间的软件路径或切换 Codex App / CLI，不启动讨论；须提供 site、room_id、token。
 room-models 只读指定 site、room_id 的本机登记模型与思考强度，不启动讨论。
-models 按 adapter、executable 读取本机 CLI 的模型目录，不启动讨论或生成回答。
+models 按 adapter、executable 或 API profile 读取模型目录，不启动讨论或生成回答。
+api-key 将 base_url、api_key 保存于本机私有目录，只返回 api_key_ref。
 pick-directory 在本机弹出系统目录选择窗口，返回所选路径；取消时不返回路径。
 room-member 为运行中的自由房间邀请或请回一位成员；须提供 site、room_id、token、action（add/rejoin）、name。
 JSON 指定 site、entry（conversation/web）、room（建房内容，含 submission_id）
@@ -128,7 +131,7 @@ export function room_models(home, raw) {
   if (paths.length > 1) throw new Error('本场存在多份登记配置，无法确定模型设置');
   const profiles = paths.length ? configuration_snapshot(paths[0]).config.participants : {};
   const participants = Object.fromEntries(Object.entries(profiles).map(([name, profile]) => {
-    const cli = ['codex_cli', 'claude', 'antigravity_cli'].includes(profile.adapter);
+    const cli = ['codex_cli', 'claude', 'antigravity_cli', 'api'].includes(profile.adapter);
     return [name, { adapter: profile.adapter, model: cli ? profile.model || '' : '',
       effort: EFFORT_LEVELS[profile.adapter] ? profile.effort || '' : '' }];
   }));
@@ -164,7 +167,8 @@ function validate_profile(name, profile, binding = false) {
     // The model is passed as one CLI argument, so it must not look like a flag or contain spaces.
     if (key === 'model' && value && !/^[A-Za-z0-9][A-Za-z0-9._:/@[\]-]*$/.test(value)) throw new Error(`${name}.model 只能是模型名称，例如 gpt-6-astra、opus 或 gemini-4-argon-high`);
   }
-  if (profile.effort && !EFFORT_LEVELS[profile.adapter]?.includes(profile.effort)) {
+  if (profile.adapter === 'api') validate_api_profile(profile);
+  if (profile.effort && profile.adapter !== 'api' && !EFFORT_LEVELS[profile.adapter]?.includes(profile.effort)) {
     throw new Error(EFFORT_LEVELS[profile.adapter] ? `${name}.effort 只能是 ${EFFORT_LEVELS[profile.adapter].join(' / ')}`
       : `${name} 的思考档位不能单独设置；agy 请选择带档位的模型名，App 在软件内选择`);
   }
@@ -222,7 +226,7 @@ function launch_config(home, input, room, directory, options) {
     participants[name] = participant_profile(name, defaults, input, name === room.host);
   }
   const members = launch_members(input, Object.keys(participants), options);
-  return validate_config({ site: input.site, room: room.id || 'preview', token: options.token, participants, members,
+  return validate_config({ site: input.site, room: room.id || 'preview', token: options.token, participants, members, api_home: home,
     cwd: input.cwd, discussion_project: input.discussion_project, project_access: input.project_access || undefined,
     data_directory: join(directory, 'runtime'), draft_directory: service_drafts(home, join(directory, 'runtime')) }, directory);
 }
@@ -233,7 +237,7 @@ function free_launch_config(home, input, room, directory, options) {
   const names = room.members.map(member => typeof member === 'string' ? member : member.name);
   const participants = Object.fromEntries(names.map(name => [name, participant_profile(name, defaults, input, false)]));
   const members = launch_members(input, names, options);
-  return validate_config({ site: input.site, room: room.id || 'preview', token: options.token, mode: 'free', participants, members,
+  return validate_config({ site: input.site, room: room.id || 'preview', token: options.token, mode: 'free', participants, members, api_home: home,
     cwd: input.cwd, project_access: input.project_access || undefined,
     data_directory: join(directory, 'runtime'), draft_directory: service_drafts(home, join(directory, 'runtime')) }, directory);
 }
@@ -255,6 +259,10 @@ function participant_profile(name, defaults, input, current_host) {
   for (const field of ['cwd', 'model', 'effort', 'project_name', 'project_id', 'project_access']) if (profile[field] === '') delete profile[field];
   validate_profile(name, profile, true);
   if (!clients_of(name)?.includes(profile.adapter)) throw new Error(`请配置 ${name} 的 CLI / App 客户端`);
+  if (profile.adapter === 'api') {
+    if (input.entry === 'conversation' && current_host) throw new Error('API 主持人请从网页启动；当前软件会话主持须选择对应 CLI / App');
+    return profile;
+  }
   if (profile.adapter !== 'antigravity' && (!existsSync(profile.executable || '') || !statSync(profile.executable).isFile()
     || (process.platform === 'win32' && !/\.exe$/i.test(profile.executable)))) throw new Error(`${name}：请指定实际原生可执行文件，Windows 使用 .exe`);
   const cwd = profile.cwd || input.cwd;
@@ -301,6 +309,7 @@ export async function room_member(home, raw, locked = false) {
   const release = locked ? () => {} : acquire_lock(join(dirname(path), 'configuration-edit'));
   try {
     const config = configuration_snapshot(path).config;
+    config.api_home = home;
     const room = await site_request(input.site, `/api/rooms/${input.room_id}`, input.token);
     if (action === 'add' && input.new_instance) {
       // A name once bound keeps its session locally, so a new instance never reuses a removed member's name.
@@ -640,8 +649,10 @@ export async function launch_main(args = process.argv.slice(2), input_text) {
   const home = service_home();
   assert_shared_home(home);
   let result;
-  if (positionals[0] === 'settings') result = input ? save_launch_settings(home, input) : launch_settings(home);
+  if (positionals[0] === 'settings') result = { ...(input ? save_launch_settings(home, input) : launch_settings(home)), api_providers: API_PROVIDERS };
+  else if (positionals[0] === 'api-key' && input) result = save_api_key(home, input);
   else if (positionals[0] === 'room-models' && input) result = room_models(home, input);
+  else if (positionals[0] === 'models' && input?.adapter === 'api') result = await api_models(home, input);
   else if (positionals[0] === 'models' && input) {
     const saved = Object.values(launch_settings(home).participants).find(profile => profile.adapter === input.adapter);
     result = await cached_software_models(home, { adapter: input.adapter, executable: input.executable || saved?.executable }, { refresh: input.refresh === true });

package/runner/discussion_runner.mjs

@@ -1,4 +1,4 @@
-/** Durable website-event delivery to existing AI software; no model API orchestration. */
+/** Durable website-event delivery to AI software and explicitly configured API participants. */
 import { createHash, randomUUID } from 'node:crypto';
 import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
@@ -7,13 +7,14 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 import { parseArgs } from 'node:util';
 import { setTimeout as sleep } from 'node:timers/promises';
 import { atomic_json, deliver_task, remove_agy_projects, setup_sidecar, sidecar_receipt, TASK_SUBCOMMANDS } from './discussion_adapters.mjs';
+import { read_api_key } from './discussion_api.mjs';
 
 const POLL_MS = 2000;
 /** Headless CLIs know their session at start, so the runner enters the execution instead of spending model turns on it. */
 const AUTO_ENTER_ADAPTERS = new Set(['codex_cli', 'claude', 'antigravity_cli']);
 const DELIVERY_RETRY_DELAYS_MS = [2000, 4000];
 const RENEW_MS = 30_000;
-const ADAPTER_NAMES = ['codex', 'claude', 'antigravity', 'codex_cli', 'antigravity_cli'];
+const ADAPTER_NAMES = ['codex', 'claude', 'antigravity', 'codex_cli', 'antigravity_cli', 'api'];
 export const CODEX_ADAPTERS = ['codex', 'codex_cli'];
 const REPO_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 /** Project files in cwd are read-only unless the launch or participant explicitly grants write. */
@@ -40,6 +41,12 @@ export function validate_config(input, base_directory) {
   if (!config.project || !existsSync(join(config.project, 'runner', 'discuss.py'))) throw new Error('cli_project 必须指向 AI CoDiscuss 项目；省略时默认使用本仓库');
   if (!config.participants || !Object.keys(config.participants).length) throw new Error('请配置本机参与软件');
   for (const participant of Object.values(config.participants)) {
+    if (participant.adapter === 'api') {
+      read_api_key(config.api_home, participant);
+      for (const field of ['cwd', 'project_name', 'project_id', 'executable', 'effort']) delete participant[field];
+      participant.project_access = 'read';
+      continue;
+    }
     participant.cwd = participant.cwd ?? config.cwd;
     participant.project_name = participant.project_name ?? config.discussion_project;
     participant.project_access = participant.project_access || config.project_access || 'read';
@@ -181,7 +188,8 @@ export function task_files(config, event, token, binding) {
     role: event.role, turn_id: event.turn_id, skills, cli, subcommands: TASK_SUBCOMMANDS, access_file: access_path,
     instructions: `读取指定技能；网站命令只用 ${cli} 的 subcommands 子命令，命令以 ${cli} 开头，不用 python discuss.py、cd、管道或其他入口；${auto_enter ? '接入程序已进入本次执行，不要再执行 execution enter。' : `使用 ${cli} execution enter 房间 执行编号 --access-file 凭据路径 进入。进入成功后才处理本次安排；`}凭据文件由 CLI 内部读取，不要打印或读取其 token。每次业务写入都带 --access-file。答案草稿只保存到 draft_directory，不修改任务、凭据、日志或调度数据库；${project_rule}只处理本次工作，不建定时任务。主持创建下一安排或收束即结束，专家提交原文后结束。无效或已进入的任务不要重复执行。` });
   const scope = `本次只放行任务内 subcommands 列出的 ${cli} 子命令，命令以 ${cli} 开头，不用 python discuss.py、cd、管道或其他入口。任务内 cwd 是讨论项目目录；${project_rule}项目读写仍受软件实际权限和议题授权约束。不读取凭据内容。读取含中文的技能或文本文件时用 rg --encoding utf-8 . 文件路径，不用 Get-Content（Windows PowerShell 会按系统编码读出乱码，需要反复重试）。`;
-  const intro = `用户已启动此房间的全自动讨论。请以 ${event.participant} 的${event.role === 'host' ? '主持' : '专家'}职责处理本次工作。`;
+  const plan_rule = event.role === 'host' ? '安排专家回应时先写发言计划，用 turn create --plan-file 一次排满本轮或可预知的整个序列，不要每次只排一位。' : '';
+  const intro = `用户已启动此房间的全自动讨论。请以 ${event.participant} 的${event.role === 'host' ? '主持' : '专家'}职责处理本次工作。${plan_rule}`;
   const prompt = auto_enter
     ? `${intro}接入程序已为本次执行完成 execution enter，不要再执行。任务内容如下（同一份保存在 ${task_path}，无需再读）：
 ${readFileSync(task_path, 'utf8')}
@@ -230,6 +238,8 @@ export class DiscussionRunner {
       const task = task_files(this.config, event, row.token, binding);
       invoked = true;
       const result = await this.deliver(adapter, binding, { ...task, room_title: this.room_title,
+        api_context: { site: this.config.site, room: this.config.room, token: row.token, home: this.config.api_home,
+          event_id: row.id, role: event.role, turn_id: event.turn_id },
         on_trace: (stage, detail) => this.trace(row.id, stage, detail),
         on_binding: session => {
           this.store.bind(event.participant, session);
@@ -303,7 +313,13 @@ export class DiscussionRunner {
   }
   /** Preserve the cause on the website and revoke work before asking for intervention. */
   async fail(row, reason) {
-    await api(this.config, `/events/${row.id}`, { action: 'fail', reason });
+    try { await api(this.config, `/events/${row.id}`, { action: 'fail', reason }); }
+    catch (error) {
+      if (!/HTTP 409/.test(error.message)) throw error;
+      const latest = await api(this.config, `/events/${row.id}`, { action: 'view' });
+      if (['completed', 'cancelled', 'failed'].includes(latest.status)) return this.reconcile(row, latest);
+      throw error;
+    }
     this.store.record(row.id, { status: 'failed', error: reason });
     this.stop_children();
   }