minimal-agent 0.18.13 → 0.18.14

package/src/config/configFile.js

@@ -6,7 +6,12 @@ import { normalizePromptCacheMode } from '../llm/promptCache.js';
 import { execSiblingDir } from '../utils/greenRoot.js';
 import { DEFAULT_ADVISOR_CONFIG, DEFAULT_BROWSER_CONFIG, DEFAULT_COMPUTER_USE_CONFIG, DEFAULT_NETWORK_PROXY_CONFIG, DEFAULT_SUBAGENTS_CONFIG, } from './configDefaults.js';
 import { CONFIG_LIMITS, normalizeLimited } from './numericLimits.js';
+import { normalizeReasoningEffort } from './reasoningEffort.js';
 export { DEFAULT_ADVISOR_CONFIG, DEFAULT_BROWSER_CONFIG, DEFAULT_COMPUTER_USE_CONFIG, DEFAULT_NETWORK_PROXY_CONFIG, DEFAULT_SUBAGENTS_CONFIG, } from './configDefaults.js';
+export { REASONING_EFFORTS, normalizeReasoningEffort } from './reasoningEffort.js';
+export function normalizeApiFormat(value) {
+    return value === 'anthropic' || value === 'openai-responses' ? value : 'openai';
+}
 export const DEFAULT_CONTEXT_WINDOW = 128_000;
 const LOCK_STALE_MS = 120_000;
 const LOCK_WAIT_MS = 15_000;
@@ -64,7 +69,7 @@ function parseModel(value) {
     const now = Date.now();
     return {
         id,
-        apiFormat: raw.apiFormat === 'anthropic' ? 'anthropic' : 'openai',
+        apiFormat: normalizeApiFormat(raw.apiFormat),
         ...(displayName ? { displayName } : {}),
         baseURL,
         apiKey,
@@ -76,6 +81,9 @@ function parseModel(value) {
             ? { supportsJsonSchema: raw.supportsJsonSchema }
             : {}),
         ...(typeof raw.reasoning === 'boolean' ? { reasoning: raw.reasoning } : {}),
+        ...(normalizeReasoningEffort(raw.reasoningEffort)
+            ? { reasoningEffort: normalizeReasoningEffort(raw.reasoningEffort) }
+            : {}),
         promptCache: {
             mode: normalizePromptCacheMode(raw.promptCache?.mode
                 ?? defaultPromptCacheMode(baseURL)),
@@ -150,9 +158,9 @@ function parseAdvisor(value) {
         // 默认关闭；旧配置显式 enabled:true 仍保持用户选择。
         enabled: raw.enabled === true,
         mode: raw.mode === 'manual' ? 'manual' : 'auto',
+        enforcement: raw.enforcement === 'followup' ? 'followup' : 'remind',
         modelId: nonEmpty(raw.modelId) ?? null,
         contextPolicy: 'full-relevant',
-        shareSensitive: raw.shareSensitive === true,
         inputTokenBudget: normalizeLimited(raw.inputTokenBudget, CONFIG_LIMITS.advisorInputTokenBudget, DEFAULT_ADVISOR_CONFIG.inputTokenBudget),
         timeoutMs: normalizeLimited(raw.timeoutMs, CONFIG_LIMITS.advisorTimeoutMs, DEFAULT_ADVISOR_CONFIG.timeoutMs),
     };
@@ -262,7 +270,6 @@ function parseLegacyAdvisorConfig(value) {
         mode: raw.mode === 'manual' ? 'manual' : 'auto',
         provider,
         supportsVision: raw.supportsVision === true,
-        shareSensitive: raw.shareSensitive === true,
         inputTokenBudget: normalizeLimited(raw.inputTokenBudget, CONFIG_LIMITS.advisorInputTokenBudget, DEFAULT_ADVISOR_CONFIG.inputTokenBudget),
         timeoutMs: normalizeLimited(raw.timeoutMs, CONFIG_LIMITS.advisorTimeoutMs, DEFAULT_ADVISOR_CONFIG.timeoutMs),
     };
@@ -319,9 +326,9 @@ function buildV4FromLegacy(legacyProvider, legacyAdvisor, subagents, tools, save
         advisor = {
             enabled: legacyAdvisor.enabled,
             mode: legacyAdvisor.mode,
+            enforcement: 'remind',
             modelId: advisorModelId,
             contextPolicy: 'full-relevant',
-            shareSensitive: legacyAdvisor.shareSensitive,
             inputTokenBudget: legacyAdvisor.inputTokenBudget,
             timeoutMs: legacyAdvisor.timeoutMs,
         };

package/src/config/configFile.ts

@@ -14,6 +14,7 @@ import {
   DEFAULT_SUBAGENTS_CONFIG,
 } from './configDefaults.js';
 import { CONFIG_LIMITS, normalizeLimited } from './numericLimits.js';
+import { type ReasoningEffort, normalizeReasoningEffort } from './reasoningEffort.js';
 
 export {
   DEFAULT_ADVISOR_CONFIG,
@@ -24,7 +25,19 @@ export {
 } from './configDefaults.js';
 
 export type ImageProtocol = 'auto' | 'chat' | 'images';
-export type ApiFormat = 'openai' | 'anthropic';
+/**
+ * openai            Chat Completions（DeepSeek/月之暗面/智谱/火山/MiniMax/OpenRouter 都按它兼容）
+ * openai-responses  OpenAI Responses API（/v1/responses，OpenAI 当前主推接口）
+ * anthropic         Anthropic Messages API
+ */
+export type ApiFormat = 'openai' | 'openai-responses' | 'anthropic';
+
+export { REASONING_EFFORTS, normalizeReasoningEffort, type ReasoningEffort } from './reasoningEffort.js';
+
+export function normalizeApiFormat(value: unknown): ApiFormat {
+  return value === 'anthropic' || value === 'openai-responses' ? value : 'openai';
+}
+
 
 /** 一个模型条目——「模型列表」的元素，基座模型和顾问模型都从这里引用。 */
 export interface ModelConfig {
@@ -42,6 +55,8 @@ export interface ModelConfig {
   supportsJsonSchema?: boolean;
   /** Request provider reasoning when supported (serialized as reasoning.enabled). */
   reasoning?: boolean;
+  /** 推理强度；缺省 = 不发送，沿用服务端对该模型的默认强度。 */
+  reasoningEffort?: ReasoningEffort;
   promptCache?: PromptCacheConfig;
   enabled: boolean;
   createdAt: number;
@@ -54,10 +69,14 @@ export type WorkflowModelRoles = Record<string, string>;
 export interface AdvisorConfig {
   enabled: boolean;
   mode: 'auto' | 'manual';
+  /**
+   * remind = 只提醒（默认）；followup = 实质回答发布后仍未复核时，再发一次请求让模型自己补问顾问。
+   * 给不会主动咨询的弱基座模型用；回答不撤回，Advisor 仍由模型自己调用。
+   */
+  enforcement: 'remind' | 'followup';
   /** 引用 models[].id；null = 未选。顾问不再自带一整套独立 provider 字段。 */
   modelId: string | null;
   contextPolicy: 'full-relevant';
-  shareSensitive: boolean;
   /** 顾问单次输入预算。独立于模型声明的上下文窗口，避免百万窗口吞入整段历史。 */
   inputTokenBudget: number;
   timeoutMs: number;
@@ -206,7 +225,7 @@ function parseModel(value: unknown): ModelConfig | null {
   const now = Date.now();
   return {
     id,
-    apiFormat: raw.apiFormat === 'anthropic' ? 'anthropic' : 'openai',
+    apiFormat: normalizeApiFormat(raw.apiFormat),
     ...(displayName ? { displayName } : {}),
     baseURL,
     apiKey,
@@ -218,6 +237,9 @@ function parseModel(value: unknown): ModelConfig | null {
       ? { supportsJsonSchema: raw.supportsJsonSchema }
       : {}),
     ...(typeof raw.reasoning === 'boolean' ? { reasoning: raw.reasoning } : {}),
+    ...(normalizeReasoningEffort(raw.reasoningEffort)
+      ? { reasoningEffort: normalizeReasoningEffort(raw.reasoningEffort) }
+      : {}),
     promptCache: {
       mode: normalizePromptCacheMode(
         (raw.promptCache as Record<string, unknown> | undefined)?.mode
@@ -291,9 +313,9 @@ function parseAdvisor(value: unknown): AdvisorConfig | undefined {
     // 默认关闭；旧配置显式 enabled:true 仍保持用户选择。
     enabled: raw.enabled === true,
     mode: raw.mode === 'manual' ? 'manual' : 'auto',
+    enforcement: raw.enforcement === 'followup' ? 'followup' : 'remind',
     modelId: nonEmpty(raw.modelId) ?? null,
     contextPolicy: 'full-relevant',
-    shareSensitive: raw.shareSensitive === true,
     inputTokenBudget: normalizeLimited(raw.inputTokenBudget, CONFIG_LIMITS.advisorInputTokenBudget, DEFAULT_ADVISOR_CONFIG.inputTokenBudget),
     timeoutMs: normalizeLimited(raw.timeoutMs, CONFIG_LIMITS.advisorTimeoutMs, DEFAULT_ADVISOR_CONFIG.timeoutMs),
   };
@@ -394,7 +416,6 @@ interface LegacyAdvisorConfig {
   mode: 'auto' | 'manual';
   provider: LegacyProviderConfig;
   supportsVision: boolean;
-  shareSensitive: boolean;
   inputTokenBudget: number;
   timeoutMs: number;
 }
@@ -428,7 +449,6 @@ function parseLegacyAdvisorConfig(value: unknown): LegacyAdvisorConfig | undefin
     mode: raw.mode === 'manual' ? 'manual' : 'auto',
     provider,
     supportsVision: raw.supportsVision === true,
-    shareSensitive: raw.shareSensitive === true,
     inputTokenBudget: normalizeLimited(raw.inputTokenBudget, CONFIG_LIMITS.advisorInputTokenBudget, DEFAULT_ADVISOR_CONFIG.inputTokenBudget),
     timeoutMs: normalizeLimited(raw.timeoutMs, CONFIG_LIMITS.advisorTimeoutMs, DEFAULT_ADVISOR_CONFIG.timeoutMs),
   };
@@ -490,9 +510,9 @@ function buildV4FromLegacy(
     advisor = {
       enabled: legacyAdvisor.enabled,
       mode: legacyAdvisor.mode,
+      enforcement: 'remind',
       modelId: advisorModelId,
       contextPolicy: 'full-relevant',
-      shareSensitive: legacyAdvisor.shareSensitive,
       inputTokenBudget: legacyAdvisor.inputTokenBudget,
       timeoutMs: legacyAdvisor.timeoutMs,
     };

package/src/config/configManagement.js

@@ -33,6 +33,7 @@ export function buildConfigManagementView(snapshot) {
         contextWindow: model.contextWindow,
         ...(model.maxTokens ? { maxTokens: model.maxTokens } : {}),
         ...(model.supportsVision ? { supportsVision: true } : {}),
+        ...(model.reasoningEffort ? { reasoningEffort: model.reasoningEffort } : {}),
         promptCache: model.promptCache ?? { mode: 'auto' },
         enabled: model.enabled,
         updatedAt: model.updatedAt,

package/src/config/configManagement.ts

@@ -23,6 +23,7 @@ export interface ManagedModelView {
   contextWindow: number;
   maxTokens?: number;
   supportsVision?: boolean;
+  reasoningEffort?: ModelConfig['reasoningEffort'];
   promptCache: NonNullable<ModelConfig['promptCache']>;
   enabled: boolean;
   updatedAt: number;
@@ -63,6 +64,7 @@ export function buildConfigManagementView(snapshot: ConfigSnapshot) {
     contextWindow: model.contextWindow,
     ...(model.maxTokens ? { maxTokens: model.maxTokens } : {}),
     ...(model.supportsVision ? { supportsVision: true } : {}),
+    ...(model.reasoningEffort ? { reasoningEffort: model.reasoningEffort } : {}),
     promptCache: model.promptCache ?? { mode: 'auto' },
     enabled: model.enabled,
     updatedAt: model.updatedAt,

package/src/config/configService.js

@@ -1,7 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import { modelRefFromLegacy, } from '../modelRef.js';
 import { fetchOnlineModels, loadTeamCredentials, resolveOnlineModel, } from '../team/auth.js';
-import { DEFAULT_ADVISOR_CONFIG, DEFAULT_BROWSER_CONFIG, DEFAULT_COMPUTER_USE_CONFIG, DEFAULT_NETWORK_PROXY_CONFIG, DEFAULT_SUBAGENTS_CONFIG, defaultMaxTokens, readMinimalAgentConfig, updateMinimalAgentConfig, } from './configFile.js';
+import { normalizeApiFormat, normalizeReasoningEffort, DEFAULT_ADVISOR_CONFIG, DEFAULT_BROWSER_CONFIG, DEFAULT_COMPUTER_USE_CONFIG, DEFAULT_NETWORK_PROXY_CONFIG, DEFAULT_SUBAGENTS_CONFIG, defaultMaxTokens, readMinimalAgentConfig, updateMinimalAgentConfig, } from './configFile.js';
 import { CONFIG_LIMITS, normalizeLimited } from './numericLimits.js';
 import { applyNetworkProxy } from '../network/proxy.js';
 const DEFAULT_CONTEXT_WINDOW = 128_000;
@@ -169,6 +169,7 @@ function resolveProvider(entry, compactRatio) {
             ? { supportsJsonSchema: entry.supportsJsonSchema }
             : {}),
         ...(entry.reasoning === true ? { reasoning: true } : {}),
+        ...(entry.reasoningEffort ? { reasoningEffort: entry.reasoningEffort } : {}),
         promptCache: entry.promptCache ?? { mode: 'auto' },
         ...(compactRatio !== undefined ? { compactRatio } : {}),
         // cache_edits 式回收：仅 Anthropic 格式 + 显式 env 开启时生效（非公开协议，
@@ -208,7 +209,7 @@ function applyModelsPatch(models, ops) {
     for (const item of ops) {
         if (item.op === 'add') {
             const m = item.model;
-            const apiFormat = m.apiFormat === 'anthropic' ? 'anthropic' : 'openai';
+            const apiFormat = normalizeApiFormat(m.apiFormat);
             const baseURL = m.baseURL?.trim();
             const modelId = m.model?.trim();
             const apiKey = m.apiKey?.trim();
@@ -230,6 +231,9 @@ function applyModelsPatch(models, ops) {
                     ? { supportsJsonSchema: m.supportsJsonSchema }
                     : {}),
                 ...(m.reasoning !== undefined ? { reasoning: m.reasoning === true } : {}),
+                ...(normalizeReasoningEffort(m.reasoningEffort)
+                    ? { reasoningEffort: normalizeReasoningEffort(m.reasoningEffort) }
+                    : {}),
                 promptCache: m.promptCache ?? { mode: 'auto' },
                 enabled: m.enabled ?? true,
                 createdAt: now,
@@ -244,11 +248,7 @@ function applyModelsPatch(models, ops) {
             const patch = item.patch;
             const next = {
                 ...existing,
-                ...(patch.apiFormat
-                    ? {
-                        apiFormat: patch.apiFormat === 'anthropic' ? 'anthropic' : 'openai',
-                    }
-                    : {}),
+                ...(patch.apiFormat ? { apiFormat: normalizeApiFormat(patch.apiFormat) } : {}),
                 ...(patch.displayName !== undefined
                     ? { displayName: patch.displayName.trim() || undefined }
                     : {}),
@@ -267,6 +267,10 @@ function applyModelsPatch(models, ops) {
                 ...(patch.reasoning !== undefined
                     ? { reasoning: patch.reasoning === true }
                     : {}),
+                // null = 清除（回到服务端默认强度）；未提供 = 不动。
+                ...(patch.reasoningEffort !== undefined
+                    ? { reasoningEffort: normalizeReasoningEffort(patch.reasoningEffort) }
+                    : {}),
                 ...(patch.promptCache ? { promptCache: patch.promptCache } : {}),
                 ...(patch.enabled !== undefined ? { enabled: patch.enabled } : {}),
                 updatedAt: now,
@@ -332,11 +336,11 @@ function applyConfigPatch(base, patch) {
             advisor = {
                 enabled: patch.advisor.enabled ?? advisor?.enabled ?? DEFAULT_ADVISOR_CONFIG.enabled,
                 mode: patch.advisor.mode ?? advisor?.mode ?? 'auto',
+                enforcement: patch.advisor.enforcement ?? advisor?.enforcement ?? 'remind',
                 modelId: patch.advisor.modelId !== undefined
                     ? patch.advisor.modelId
                     : (advisor?.modelId ?? null),
                 contextPolicy: 'full-relevant',
-                shareSensitive: patch.advisor.shareSensitive ?? advisor?.shareSensitive ?? false,
                 inputTokenBudget: normalizeLimited(patch.advisor.inputTokenBudget ?? advisor?.inputTokenBudget, CONFIG_LIMITS.advisorInputTokenBudget, DEFAULT_ADVISOR_CONFIG.inputTokenBudget),
                 timeoutMs: normalizeLimited(patch.advisor.timeoutMs ?? advisor?.timeoutMs, CONFIG_LIMITS.advisorTimeoutMs, DEFAULT_ADVISOR_CONFIG.timeoutMs),
             };

package/src/config/configService.ts

@@ -16,6 +16,8 @@ import type { GatewayProvider, LocalProvider, Provider } from '../types.js';
 import {
   type AdvisorConfig,
   type ApiFormat,
+  normalizeApiFormat,
+  normalizeReasoningEffort,
   type BrowserConfig,
   type ComputerUseConfig,
   DEFAULT_ADVISOR_CONFIG,
@@ -66,8 +68,10 @@ export type ModelOp =
   | {
       op: 'update';
       id: string;
-      patch: Partial<Omit<ModelConfig, 'id' | 'createdAt' | 'updatedAt'>> & {
+      patch: Partial<Omit<ModelConfig, 'id' | 'createdAt' | 'updatedAt' | 'reasoningEffort'>> & {
         clearApiKey?: boolean;
+        /** null = 清除，回到服务端对该模型的默认强度。 */
+        reasoningEffort?: ModelConfig['reasoningEffort'] | null;
       };
     }
   | { op: 'remove'; id: string };
@@ -311,6 +315,7 @@ function resolveProvider(
       ? { supportsJsonSchema: entry.supportsJsonSchema }
       : {}),
     ...(entry.reasoning === true ? { reasoning: true } : {}),
+    ...(entry.reasoningEffort ? { reasoningEffort: entry.reasoningEffort } : {}),
     promptCache: entry.promptCache ?? { mode: 'auto' },
     ...(compactRatio !== undefined ? { compactRatio } : {}),
     // cache_edits 式回收：仅 Anthropic 格式 + 显式 env 开启时生效（非公开协议，
@@ -364,8 +369,7 @@ function applyModelsPatch(
   for (const item of ops) {
     if (item.op === 'add') {
       const m = item.model;
-      const apiFormat: ApiFormat =
-        m.apiFormat === 'anthropic' ? 'anthropic' : 'openai';
+      const apiFormat: ApiFormat = normalizeApiFormat(m.apiFormat);
       const baseURL = m.baseURL?.trim();
       const modelId = m.model?.trim();
       const apiKey = m.apiKey?.trim();
@@ -388,6 +392,9 @@ function applyModelsPatch(
           ? { supportsJsonSchema: m.supportsJsonSchema }
           : {}),
         ...(m.reasoning !== undefined ? { reasoning: m.reasoning === true } : {}),
+        ...(normalizeReasoningEffort(m.reasoningEffort)
+          ? { reasoningEffort: normalizeReasoningEffort(m.reasoningEffort) }
+          : {}),
         promptCache: m.promptCache ?? { mode: 'auto' },
         enabled: m.enabled ?? true,
         createdAt: now,
@@ -400,12 +407,7 @@ function applyModelsPatch(
       const patch = item.patch;
       const next: ModelConfig = {
         ...existing,
-        ...(patch.apiFormat
-          ? {
-              apiFormat:
-                patch.apiFormat === 'anthropic' ? 'anthropic' : 'openai',
-            }
-          : {}),
+        ...(patch.apiFormat ? { apiFormat: normalizeApiFormat(patch.apiFormat) } : {}),
         ...(patch.displayName !== undefined
           ? { displayName: patch.displayName.trim() || undefined }
           : {}),
@@ -424,6 +426,10 @@ function applyModelsPatch(
         ...(patch.reasoning !== undefined
           ? { reasoning: patch.reasoning === true }
           : {}),
+        // null = 清除（回到服务端默认强度）；未提供 = 不动。
+        ...(patch.reasoningEffort !== undefined
+          ? { reasoningEffort: normalizeReasoningEffort(patch.reasoningEffort) }
+          : {}),
         ...(patch.promptCache ? { promptCache: patch.promptCache } : {}),
         ...(patch.enabled !== undefined ? { enabled: patch.enabled } : {}),
         updatedAt: now,
@@ -498,13 +504,12 @@ function applyConfigPatch(
       advisor = {
         enabled: patch.advisor.enabled ?? advisor?.enabled ?? DEFAULT_ADVISOR_CONFIG.enabled,
         mode: patch.advisor.mode ?? advisor?.mode ?? 'auto',
+        enforcement: patch.advisor.enforcement ?? advisor?.enforcement ?? 'remind',
         modelId:
           patch.advisor.modelId !== undefined
             ? patch.advisor.modelId
             : (advisor?.modelId ?? null),
         contextPolicy: 'full-relevant',
-        shareSensitive:
-          patch.advisor.shareSensitive ?? advisor?.shareSensitive ?? false,
         inputTokenBudget: normalizeLimited(
           patch.advisor.inputTokenBudget ?? advisor?.inputTokenBudget,
           CONFIG_LIMITS.advisorInputTokenBudget,

package/src/config/numericLimits.js

@@ -62,10 +62,6 @@ export const CONFIG_LIMITS = {
     modelContextWindow: { min: 1_000, max: 20_000_000, step: 1_000, kind: 'integer' },
     /** 模型条目的单次输出上限（可留空 = 用公式推荐值，故 UI 允许空串，这里只约束填了值的情况）。 */
     modelMaxTokens: { min: 256, max: 1_000_000, step: 256, kind: 'integer' },
-    /** SSH 主机端口。TCP 端口的合法范围。 */
-    sshPort: { min: 1, max: 65_535, step: 1, kind: 'integer' },
-    /** SSH 单次操作（连接+执行/传输）超时（毫秒），上界给到 10 分钟容纳慢速链路上的大文件传输。 */
-    sshTimeoutMs: { min: 1_000, max: 600_000, step: 1_000, kind: 'integer' },
 };
 /** 比例类字段保留的小数位（4 位比例 = 2 位百分比）。 */
 const RATIO_DECIMALS = 4;

package/src/config/numericLimits.ts

@@ -79,10 +79,6 @@ export const CONFIG_LIMITS = {
   /** 模型条目的单次输出上限（可留空 = 用公式推荐值，故 UI 允许空串，这里只约束填了值的情况）。 */
   modelMaxTokens: { min: 256, max: 1_000_000, step: 256, kind: 'integer' },
 
-  /** SSH 主机端口。TCP 端口的合法范围。 */
-  sshPort: { min: 1, max: 65_535, step: 1, kind: 'integer' },
-  /** SSH 单次操作（连接+执行/传输）超时（毫秒），上界给到 10 分钟容纳慢速链路上的大文件传输。 */
-  sshTimeoutMs: { min: 1_000, max: 600_000, step: 1_000, kind: 'integer' },
 } as const satisfies Record<string, NumericLimit>;
 
 export type ConfigLimitKey = keyof typeof CONFIG_LIMITS;

package/src/config/reasoningEffort.js

@@ -0,0 +1,16 @@
+/**
+ * 推理强度（纯逻辑、零依赖）。
+ *
+ * 独立成文件是因为 Desktop 的浏览器端经 `minimal-agent/provider-presets` 引用它：
+ * 放在 configFile.ts 里会把 node:fs 等整串依赖拖进前端包。
+ *
+ * 不同模型认的档位不同（有的没有 none/minimal，有的才有 xhigh），所以这里只收「OpenAI
+ * 系文档出现过的全部取值」，具体某个模型接不接受由服务端裁决：被拒绝时 client.ts 会去掉
+ * 该参数重发一次并告警，而不是让整个对话 400。
+ */
+export const REASONING_EFFORTS = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh'];
+export function normalizeReasoningEffort(value) {
+    return typeof value === 'string' && REASONING_EFFORTS.includes(value)
+        ? value
+        : undefined;
+}

package/src/config/reasoningEffort.ts

@@ -0,0 +1,18 @@
+/**
+ * 推理强度（纯逻辑、零依赖）。
+ *
+ * 独立成文件是因为 Desktop 的浏览器端经 `minimal-agent/provider-presets` 引用它：
+ * 放在 configFile.ts 里会把 node:fs 等整串依赖拖进前端包。
+ *
+ * 不同模型认的档位不同（有的没有 none/minimal，有的才有 xhigh），所以这里只收「OpenAI
+ * 系文档出现过的全部取值」，具体某个模型接不接受由服务端裁决：被拒绝时 client.ts 会去掉
+ * 该参数重发一次并告警，而不是让整个对话 400。
+ */
+export const REASONING_EFFORTS = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh'] as const;
+export type ReasoningEffort = (typeof REASONING_EFFORTS)[number];
+
+export function normalizeReasoningEffort(value: unknown): ReasoningEffort | undefined {
+  return typeof value === 'string' && (REASONING_EFFORTS as readonly string[]).includes(value)
+    ? (value as ReasoningEffort)
+    : undefined;
+}

package/src/context/budgetPlan.js

@@ -20,7 +20,7 @@ export function buildContextBudgetPlan(input) {
         overBudget: totalInputTokens > inputLimit,
     };
 }
-const AUXILIARY_REMOVAL_ORDER = ['AdvisorDecision', 'Advisor', 'Agent'];
+const AUXILIARY_REMOVAL_ORDER = ['Advisor', 'Agent'];
 /**
  * Last-resort schema reduction. Normal requests keep the full catalog; this is
  * used only after history compaction still cannot fit the provider window.

package/src/context/budgetPlan.ts

@@ -47,7 +47,7 @@ export interface EmergencyToolFit {
   plan: ContextBudgetPlan;
 }
 
-const AUXILIARY_REMOVAL_ORDER = ['AdvisorDecision', 'Advisor', 'Agent'];
+const AUXILIARY_REMOVAL_ORDER = ['Advisor', 'Agent'];
 
 /**
  * Last-resort schema reduction. Normal requests keep the full catalog; this is

package/src/context/optimizeConversation.js

@@ -41,7 +41,7 @@ export function createConversationOptimizer(options) {
                 degraded: false, before: compact.before, after: compact.after,
                 messagesRemoved: compact.messagesRemoved, tokensFreed: compact.tokensFreed,
             });
-            return { ok: true, content: `已优化对话：已完成历史的估算 token 从 ${compact.before} 降至 ${compact.after}，释放 ${compact.tokensFreed}。近期消息和当前工具调用保留；历史证据与顾问状态保留在本机会话中，原 tool_call_id 仍可用于 AdvisorDecision。顾问按预算选取记录，不代表已审阅全部历史。本结果不是一手证据。继续未完成任务，无需复述摘要。` };
+            return { ok: true, content: `已优化对话：已完成历史的估算 token 从 ${compact.before} 降至 ${compact.after}，释放 ${compact.tokensFreed}。近期消息和当前工具调用保留；历史证据保留在本机会话中；顾问评审时会一并展开这些原始记录。本结果不是一手证据。继续未完成任务，无需复述摘要。` };
         }
         catch {
             return { ok: false, error: signal?.aborted ? 'aborted'

package/src/context/optimizeConversation.ts

@@ -48,7 +48,7 @@ export function createConversationOptimizer(options: {
         degraded: false, before: compact.before, after: compact.after,
         messagesRemoved: compact.messagesRemoved, tokensFreed: compact.tokensFreed,
       });
-      return { ok: true, content: `已优化对话：已完成历史的估算 token 从 ${compact.before} 降至 ${compact.after}，释放 ${compact.tokensFreed}。近期消息和当前工具调用保留；历史证据与顾问状态保留在本机会话中，原 tool_call_id 仍可用于 AdvisorDecision。顾问按预算选取记录，不代表已审阅全部历史。本结果不是一手证据。继续未完成任务，无需复述摘要。` };
+      return { ok: true, content: `已优化对话：已完成历史的估算 token 从 ${compact.before} 降至 ${compact.after}，释放 ${compact.tokensFreed}。近期消息和当前工具调用保留；历史证据保留在本机会话中；顾问评审时会一并展开这些原始记录。本结果不是一手证据。继续未完成任务，无需复述摘要。` };
     } catch {
       return { ok: false, error: signal?.aborted ? 'aborted'
         : '优化未成功生成有效摘要，原历史保持不变。继续任务，不要重复调用。' };

package/src/harness/stallGuard.js

@@ -12,18 +12,13 @@ export class StallGuard {
     #sequence = 0;
     #observed = new Set();
     #problems = new Map();
-    /** Complete one consultation per two failed attempts, not on every retry. */
-    completeReview(signature) {
-        for (const [key, problem] of this.#problems) {
-            if (problem.signature !== signature)
-                continue;
-            this.#problems.delete(key);
-            if (problem.calls.has(this.#lastFailureCall)) {
-                this.#failureCount = 0;
-                this.#lastFailureCall = '';
-                this.#lastFailure = '';
-            }
-        }
+    /** After a successful consultation the failing path may be tried again: the
+     * repeated-call rejection and the open problems start from zero. */
+    noteConsultation() {
+        this.#problems.clear();
+        this.#failureCount = 0;
+        this.#lastFailureCall = '';
+        this.#lastFailure = '';
     }
     /** Called immediately after execution, so a serial batch cannot run attempt 3
      * before its second failure has reached the advisor coordinator. */
@@ -31,7 +26,7 @@ export class StallGuard {
         if (this.#observed.has(call.id))
             return { stalled: false };
         this.#observed.add(call.id);
-        if (call.function.name === 'Advisor' || call.function.name === 'AdvisorDecision'
+        if (call.function.name === 'Advisor'
             || (!result.ok && (result.disposition === 'deferred' || result.error === 'aborted')))
             return { stalled: false };
         const callSignature = hash(`${call.function.name}\0${call.function.arguments}`);

package/src/harness/stallGuard.ts

@@ -23,17 +23,13 @@ export class StallGuard {
   readonly #observed = new Set<string>();
   readonly #problems = new Map<string, { signature: string; calls: Set<string>; attempts: string[]; notified: boolean }>();
 
-  /** Complete one consultation per two failed attempts, not on every retry. */
-  completeReview(signature: string): void {
-    for (const [key, problem] of this.#problems) {
-      if (problem.signature !== signature) continue;
-      this.#problems.delete(key);
-      if (problem.calls.has(this.#lastFailureCall)) {
-        this.#failureCount = 0;
-        this.#lastFailureCall = '';
-        this.#lastFailure = '';
-      }
-    }
+  /** After a successful consultation the failing path may be tried again: the
+   * repeated-call rejection and the open problems start from zero. */
+  noteConsultation(): void {
+    this.#problems.clear();
+    this.#failureCount = 0;
+    this.#lastFailureCall = '';
+    this.#lastFailure = '';
   }
 
   /** Called immediately after execution, so a serial batch cannot run attempt 3
@@ -41,7 +37,7 @@ export class StallGuard {
   observeAttempt(call: ToolCall, result: ToolResult): StallObservation {
     if (this.#observed.has(call.id)) return { stalled: false };
     this.#observed.add(call.id);
-    if (call.function.name === 'Advisor' || call.function.name === 'AdvisorDecision'
+    if (call.function.name === 'Advisor'
       || (!result.ok && (result.disposition === 'deferred' || result.error === 'aborted'))) return { stalled: false };
     const callSignature = hash(`${call.function.name}\0${call.function.arguments}`);
     const failed = result.problem?.outcome === 'failed' || !result.ok