@yeaft/webchat-agent 0.1.997 → 0.1.999

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "0.1.997",
+  "version": "0.1.999",
   "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
   "main": "index.js",
   "type": "module",

package/yeaft/config.js

@@ -22,7 +22,7 @@
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { DEFAULT_YEAFT_DIR } from './init.js';
-import { resolveModel, parseModelRef, normalizeProviderModels, resolveContextWindow, resolveMaxOutputTokens } from './models.js';
+import { getModelEffortOptions, modelSupportsEffort, resolveModel, parseModelRef, normalizeProviderModels, resolveContextWindow, resolveMaxOutputTokens } from './models.js';
 import { normalizeKnownProviderForRuntime } from './llm/known-providers.js';
 
 /** Default configuration values. */
@@ -394,11 +394,17 @@ export function loadConfig(overrides = {}) {
         if (!config.availableModels.some(am => am.id === m.id)) {
           const entry = {
             id: m.id,
+            ref: p.name ? `${p.name}/${m.id}` : m.id,
             provider: p.name,
             label: m.id,
           };
           if (m.contextWindow !== undefined) entry.contextWindow = m.contextWindow;
           if (m.maxOutput !== undefined) entry.maxOutput = m.maxOutput;
+          const effortOptions = getModelEffortOptions(m.id);
+          if (effortOptions.length > 0) {
+            entry.supportsEffort = modelSupportsEffort(m.id);
+            entry.effortOptions = effortOptions;
+          }
           config.availableModels.push(entry);
         }
       }

package/yeaft/dream/segment-extract.js

@@ -303,6 +303,6 @@ function oneLine(text) {
 
 function extractSystem(language) {
   return String(language || '').toLowerCase().startsWith('zh')
-    ? '你是 Yeaft Dream 记忆抽取器。只输出严格 JSON 数组，不要 Markdown。保留具体事实、决策、偏好、当前状态和证据 message id。'
-    : 'You are the Yeaft Dream memory extractor. Return only a strict JSON array, no Markdown. Preserve concrete facts, decisions, preferences, current status, and evidence message ids.';
+    ? '你是梦境记忆抽取器。只输出严格 JSON 数组，不要 Markdown。保留具体事实、决策、偏好、当前状态和证据 message id。'
+    : 'You are the dream memory extractor. Return only a strict JSON array, no Markdown. Preserve concrete facts, decisions, preferences, current status, and evidence message ids.';
 }

package/yeaft/engine.js

@@ -1372,7 +1372,8 @@ export class Engine {
     // valid prompt prefix.
     const parsed = parseEffortPrefix(prompt);
     const effectivePrompt = parsed.cleanedPrompt;
-    const effectiveUserEffort = normalizeEffort(userEffort) || parsed.effort || null;
+    const configuredEffort = normalizeEffort(this.#config?.modelEffort);
+    const effectiveUserEffort = normalizeEffort(userEffort) || parsed.effort || configuredEffort || null;
     const effectiveCollabToolPolicy = collabToolPolicy === COLLAB_TOOL_POLICY.SINGLE_VP || collabToolPolicy === COLLAB_TOOL_POLICY.MULTI_VP
       ? collabToolPolicy
       : null;
@@ -1957,6 +1958,7 @@ export class Engine {
           tools: toolDefs.length > 0 ? toolDefs : undefined,
           maxTokens: this.#config.maxOutputTokens || 16384,
           effort: resolvedEffort,
+          effortSource: userEffort ? 'user' : 'auto',
           signal,
           onRawExchange: captureRawExchange,
         })) {

package/yeaft/llm/anthropic.js

@@ -156,10 +156,10 @@ export class AnthropicAdapter extends LLMAdapter {
   }
 
   /**
-   * @param {{ model: string, system: string, messages: import('./adapter.js').UnifiedMessage[], tools?: import('./adapter.js').UnifiedToolDef[], maxTokens?: number, effort?: 'low'|'medium'|'high'|'max', signal?: AbortSignal }} params
+   * @param {{ model: string, system: string, messages: import('./adapter.js').UnifiedMessage[], tools?: import('./adapter.js').UnifiedToolDef[], maxTokens?: number, effort?: 'low'|'medium'|'high'|'max', effortSource?: 'user'|'auto', signal?: AbortSignal }} params
    * @returns {AsyncGenerator<import('./adapter.js').StreamEvent>}
    */
-  async *stream({ model, system, messages, tools, maxTokens = 16384, effort, signal, onRawExchange }) {
+  async *stream({ model, system, messages, tools, maxTokens = 16384, effort, effortSource, signal, onRawExchange }) {
     if (signal?.aborted) throw new LLMAbortError();
 
     const body = {
@@ -175,7 +175,7 @@ export class AnthropicAdapter extends LLMAdapter {
     // 'anthropic' thinking protocol. Unknown models or non-thinking models
     // silently drop the parameter — red line: never error on unsupported.
     const normEffort = normalizeEffort(effort);
-    if (thinkingV1Enabled() && normEffort) {
+    if ((thinkingV1Enabled() || effortSource === 'user') && normEffort) {
       const cap = getThinkingCapability(model);
       if (cap.supportsThinking && cap.thinkingProtocol === 'anthropic') {
         const budget = thinkingBudgetForEffort(model, normEffort);
@@ -427,7 +427,7 @@ export class AnthropicAdapter extends LLMAdapter {
    * models silently drop the param. max_tokens auto-widens to budget+1024
    * when needed.
    */
-  async call({ model, system, messages, maxTokens = 4096, effort, signal }) {
+  async call({ model, system, messages, maxTokens = 4096, effort, effortSource, signal }) {
     if (signal?.aborted) throw new LLMAbortError();
 
     const body = {
@@ -439,7 +439,7 @@ export class AnthropicAdapter extends LLMAdapter {
 
     // task-327c: mirror stream()'s thinking injection for side queries.
     const normEffort = normalizeEffort(effort);
-    if (thinkingV1Enabled() && normEffort) {
+    if ((thinkingV1Enabled() || effortSource === 'user') && normEffort) {
       const cap = getThinkingCapability(model);
       if (cap.supportsThinking && cap.thinkingProtocol === 'anthropic') {
         const budget = thinkingBudgetForEffort(model, normEffort);

package/yeaft/llm/openai-responses.js

@@ -230,7 +230,7 @@ export class OpenAIResponsesAdapter extends LLMAdapter {
   // ─── Streaming ──────────────────────────────────────────
 
   /**
-   * @param {{ model: string, system: string, messages: import('./adapter.js').UnifiedMessage[], tools?: import('./adapter.js').UnifiedToolDef[], maxTokens?: number, effort?: 'low'|'medium'|'high'|'max', extraBody?: object, signal?: AbortSignal, onRawExchange?: ({rawRequest, rawResponse}) => void }} params
+   * @param {{ model: string, system: string, messages: import('./adapter.js').UnifiedMessage[], tools?: import('./adapter.js').UnifiedToolDef[], maxTokens?: number, effort?: 'low'|'medium'|'high'|'max', effortSource?: 'user'|'auto', extraBody?: object, signal?: AbortSignal, onRawExchange?: ({rawRequest, rawResponse}) => void }} params
    *
    * NOTE on `extraBody`: any keys you spread here are merged verbatim into
    * the wire body and — because the verbatim debug feature is intentionally
@@ -239,7 +239,7 @@ export class OpenAIResponsesAdapter extends LLMAdapter {
    * `api-key` headers are auto-redacted (see `redactRawRequest` in
    * `adapter.js`); request-body fields are caller-controlled.
    */
-  async *stream({ model, system, messages, tools, maxTokens = 16384, effort, extraBody, signal, onRawExchange }) {
+  async *stream({ model, system, messages, tools, maxTokens = 16384, effort, effortSource, extraBody, signal, onRawExchange }) {
     if (signal?.aborted) throw new LLMAbortError();
 
     const body = {
@@ -257,7 +257,7 @@ export class OpenAIResponsesAdapter extends LLMAdapter {
     // registry entry must declare thinkingProtocol === 'openai-reasoning'.
     // Unknown / unsupported models silently drop the field.
     const normEffort = normalizeEffort(effort);
-    if (thinkingV1Enabled() && normEffort) {
+    if ((thinkingV1Enabled() || effortSource === 'user') && normEffort) {
       const cap = getThinkingCapability(model);
       if (cap.supportsThinking && cap.thinkingProtocol === 'openai-reasoning') {
         const wireEffort = effortForResponses(normEffort);
@@ -478,7 +478,7 @@ export class OpenAIResponsesAdapter extends LLMAdapter {
    * expose them, mirror the stream() instrumentation. Parity with
    * anthropic.js's `call()`.
    */
-  async call({ model, system, messages, maxTokens = 4096, effort, extraBody, signal }) {
+  async call({ model, system, messages, maxTokens = 4096, effort, effortSource, extraBody, signal }) {
     if (signal?.aborted) throw new LLMAbortError();
 
     const body = {
@@ -490,7 +490,7 @@ export class OpenAIResponsesAdapter extends LLMAdapter {
 
     // Mirror stream()'s thinking injection for non-streaming side queries.
     const normEffort = normalizeEffort(effort);
-    if (thinkingV1Enabled() && normEffort) {
+    if ((thinkingV1Enabled() || effortSource === 'user') && normEffort) {
       const cap = getThinkingCapability(model);
       if (cap.supportsThinking && cap.thinkingProtocol === 'openai-reasoning') {
         const wireEffort = effortForResponses(normEffort);

package/yeaft/llm/router.js

@@ -99,20 +99,22 @@ function thinkingV1Enabled() {
 export function filterEffortForModel(params) {
   if (!params || !('effort' in params)) return params;
   if (!thinkingV1Enabled()) {
-    const { effort: _drop, ...rest } = params;
-    return rest;
+    if (params.effortSource !== 'user') {
+      const { effort: _drop, effortSource: _source, ...rest } = params;
+      return rest;
+    }
   }
   const norm = normalizeEffort(params.effort);
   if (!norm) {
-    const { effort: _drop, ...rest } = params;
+    const { effort: _drop, effortSource: _source, ...rest } = params;
     return rest;
   }
   const cap = getThinkingCapability(parseModelRef(params.model).modelId);
   if (!cap.supportsThinking || cap.thinkingProtocol === 'none') {
-    const { effort: _drop, ...rest } = params;
+    const { effort: _drop, effortSource: _source, ...rest } = params;
     return rest;
   }
-  return { ...params, effort: norm };
+  return { ...params, effort: norm, effortSource: params.effortSource };
 }
 
 /**

package/yeaft/models.js

@@ -411,6 +411,27 @@ export function mapEffortToOpenAIReasoning(effort) {
   }
 }
 
+export const MODEL_EFFORT_OPTIONS = ['low', 'medium', 'high'];
+
+function inferThinkingCapability(model) {
+  const id = parseModelRef(model).modelId.toLowerCase();
+  if (!id) return null;
+
+  if (/^(gpt-5|o1|o3|o4|chatgpt-|codex-)/.test(id)) {
+    return { supportsThinking: true, thinkingProtocol: 'openai-reasoning', defaultEffort: null, maxBudgetTokens: null };
+  }
+
+  // Anthropic extended thinking is available on Claude 3.7+ and Claude 4.x.
+  // Be conservative: older Claude 3/3.5/Haiku entries stay unsupported unless
+  // explicitly listed in the registry.
+  if (/^claude-/.test(id) && (/(^|-)3-7($|-|\.)/.test(id) || /(^|-)4($|-|\.)/.test(id))) {
+    const maxBudgetTokens = id.includes('opus') ? 64000 : 32000;
+    return { supportsThinking: true, thinkingProtocol: 'anthropic', defaultEffort: null, maxBudgetTokens };
+  }
+
+  return null;
+}
+
 /**
  * Resolve the Anthropic thinking budget_tokens value for a given (model, effort).
  *
@@ -443,7 +464,9 @@ export function thinkingBudgetForEffort(model, effort) {
  */
 export function getThinkingCapability(model) {
   const info = MODEL_REGISTRY.get(model);
-  if (!info || !info.supportsThinking) {
+  const hasExplicitThinking = info && Object.prototype.hasOwnProperty.call(info, 'supportsThinking');
+  const inferred = hasExplicitThinking ? null : inferThinkingCapability(model);
+  if ((!info || !info.supportsThinking) && !inferred) {
     return {
       supportsThinking: false,
       thinkingProtocol: 'none',
@@ -452,13 +475,23 @@ export function getThinkingCapability(model) {
     };
   }
   return {
-    supportsThinking: true,
-    thinkingProtocol: info.thinkingProtocol || 'none',
-    defaultEffort: info.defaultEffort ?? null,
-    maxBudgetTokens: info.maxBudgetTokens ?? null,
+    supportsThinking: Boolean(info?.supportsThinking ?? inferred?.supportsThinking),
+    thinkingProtocol: info?.thinkingProtocol || inferred?.thinkingProtocol || 'none',
+    defaultEffort: info?.defaultEffort ?? inferred?.defaultEffort ?? null,
+    maxBudgetTokens: info?.maxBudgetTokens ?? inferred?.maxBudgetTokens ?? null,
   };
 }
 
+export function getModelEffortOptions(model) {
+  const cap = getThinkingCapability(model);
+  if (!cap.supportsThinking || cap.thinkingProtocol === 'none') return [];
+  return MODEL_EFFORT_OPTIONS.slice();
+}
+
+export function modelSupportsEffort(model) {
+  return getModelEffortOptions(model).length > 0;
+}
+
 /**
  * Valid-effort guard. Unknown values → null (caller should treat as "no effort").
  *

package/yeaft/prompts.js

@@ -191,7 +191,7 @@ export function getDefaultPlanInstruction(language = 'en') {
 
 const PROMPTS = {
   en: {
-    identity: 'You are Yeaft, a helpful AI assistant.',
+    identity: 'No VP soul is active for this turn. Participate in the current session with grounded, evidence-based answers and preserve the user\'s context.',
     date: (d) => `Date: ${d}`,
     dream: 'You are in dream mode. Reflect on past conversations and consolidate memories.',
     tools: (names) => `Available tools: ${names}`,
@@ -204,11 +204,9 @@ const PROMPTS = {
     projectDocHeader: '[Project Doc]',
     projectDocIntro:
       'The user keeps project-level instructions and context in `CLAUDE.md` or `AGENTS.md` at the session working directory. Treat the content below as authoritative project context — coding conventions, task guidance, workflow rules, etc.',
-    vpPersonaIntro: (name, role) =>
-      `You are ${name}${role ? `, ${role}` : ''}. Think, decide, and respond from ${name}'s perspective. Speak in the first person as ${name}; do not refer to yourself as "Yeaft" or as a generic AI assistant.`,
   },
   zh: {
-    identity: '你是 Yeaft，一个有用的 AI 助手。',
+    identity: '当前回合没有激活 VP soul。你在当前 session 中参与协作，回答要基于证据，并保持用户上下文。',
     date: (d) => `日期：${d}`,
     dream: '你处于梦境模式。回顾过去的对话，整理和巩固记忆。',
     tools: (names) => `可用工具：${names}`,
@@ -219,8 +217,6 @@ const PROMPTS = {
     projectDocHeader: '[项目文档]',
     projectDocIntro:
       '用户把项目级的说明和上下文记录在 session 工作目录下的 `CLAUDE.md` 或 `AGENTS.md` 中。下面的内容是权威的项目上下文 —— 编码规范、任务指导、工作流约定等，请遵循它来工作。',
-    vpPersonaIntro: (name, role) =>
-      `你是 ${name}${role ? `，${role}` : ''}。请以 ${name} 的思考方式理解问题、判断优先级并回答，并以 ${name} 的第一人称发言；不要自称 "Yeaft" 或泛指的 AI 助手。`,
   },
 };
 
@@ -427,7 +423,8 @@ function renderVpPersona(vpPersona, lang, effectiveLang = 'en') {
   // generic assistant identity here: the VP soul body is the source of truth.
   // `role` is intentionally not rendered as a second identity line; stock VPs
   // carry bilingual, role-aware soul text in role.md.
-  const lines = [`# ${name}`, '', '## Soul'];
+  const soulHeading = effectiveLang === 'zh' ? '## 灵魂' : '## Soul';
+  const lines = [`# ${name}`, '', soulHeading];
   if (body) lines.push('', body);
   return lines.join('\n');
 }

package/yeaft/sessions/session-config.js

@@ -6,7 +6,8 @@
  *
  * v1 schema (intentionally tiny — extend via additive keys only):
  *   {
- *     "model": "my-proxy/claude-sonnet-4-20250514"   // optional
+ *     "model": "my-proxy/claude-sonnet-4-20250514",  // optional
+ *     "modelEffort": "high"                          // optional
  *   }
  *
  * Missing file or `{}` → no session-level override. Missing field → fall back to user-level
@@ -26,7 +27,8 @@ import { sessionsRoot, resolveSessionYeaftDir } from './session-crud.js';
 const CONFIG_FILE = 'config.json';
 
 /** Whitelist of persisted session model-override fields. Reject everything else. */
-const ALLOWED_KEYS = new Set(['model']);
+const ALLOWED_KEYS = new Set(['model', 'modelEffort']);
+const ALLOWED_EFFORTS = new Set(['low', 'medium', 'high']);
 
 export class SessionConfigError extends Error {
   constructor(code, message) {
@@ -97,6 +99,11 @@ export function validateSessionConfig(cfg) {
       throw new SessionConfigError('invalid_model', 'model must be a non-empty string');
     }
   }
+  if ('modelEffort' in cfg && cfg.modelEffort !== null && cfg.modelEffort !== undefined && cfg.modelEffort !== '') {
+    if (typeof cfg.modelEffort !== 'string' || !ALLOWED_EFFORTS.has(cfg.modelEffort.trim())) {
+      throw new SessionConfigError('invalid_model_effort', 'modelEffort must be low, medium, or high');
+    }
+  }
 }
 
 /**
@@ -163,5 +170,10 @@ export function resolveSessionConfig(userConfig, sessionConfig) {
     base.model = model;
     base.primaryModel = model;
   }
+  if (overrides.modelEffort && typeof overrides.modelEffort === 'string' && ALLOWED_EFFORTS.has(overrides.modelEffort)) {
+    base.modelEffort = overrides.modelEffort;
+  } else {
+    delete base.modelEffort;
+  }
   return base;
 }

package/yeaft/templates/identity-yeaft.md

@@ -6,6 +6,6 @@ No VP soul is active for this turn. Participate in the current session with grou
 
 <!-- lang:zh -->
 
-# Session fallback identity
+# Session 兜底身份
 
 当前回合没有激活 VP soul。你在当前 session 中参与协作，回答要基于证据，并保持用户上下文。

package/yeaft/templates/mode-unified.md

@@ -10,7 +10,7 @@ This legacy template is no longer injected for normal VP turns. Keep any future
 
 <!-- lang:zh -->
 
-# Session behavior notes
+# Session 行为说明
 
 这个 legacy template 不再注入普通 VP turn。未来如果重新使用，也只能放行为规则：不要在这里定义身份；身份必须来自选中的 VP soul 或无 VP fallback。
 

package/yeaft/web-bridge.js

@@ -2796,6 +2796,7 @@ async function ensureSessionLoaded() {
     type: 'session_ready',
     conversationId: yeaftConversationId,
     model: session.config.model,
+    modelEffort: session.config.modelEffort || null,
     availableModels: session.config.availableModels || [],
     skills: session.status.skills,
     mcpServers: session.status.mcpServers,
@@ -3920,23 +3921,34 @@ export function handleYeaftModeSwitch(_msg) {
 }
 
 
+
+export function modelRefMatchesAvailable(model, requested) {
+  if (!model || !requested) return false;
+  return model.id === requested
+    || model.ref === requested
+    || (model.provider && model.id && `${model.provider}/${model.id}` === requested);
+}
+
 /** Handle model switch from the web UI. */
 export function handleYeaftModelSwitch(msg) {
   if (!session || !msg.model) return;
   refreshLiveSessionConfig();
 
   const available = session.config.availableModels || [];
-  const found = available.some(m => m.id === msg.model);
+  const found = available.some(m => modelRefMatchesAvailable(m, msg.model));
   if (!found) {
     console.warn(`[Yeaft] model switch rejected — "${msg.model}" not in availableModels`);
     return;
   }
 
   session.config.model = msg.model;
+  session.config.primaryModel = msg.model;
+  session.config.modelEffort = msg.modelEffort || null;
 
   sendSessionEvent({
     type: 'model_switched',
     model: msg.model,
+    modelEffort: session.config.modelEffort || null,
   });
 }
 
@@ -3996,6 +4008,7 @@ export async function handleYeaftLoadHistory(msg) {
     type: 'session_ready',
     conversationId: yeaftConversationId,
     model: session.config.model,
+    modelEffort: session.config.modelEffort || null,
     availableModels: session.config.availableModels || [],
     skills: session.status.skills,
     mcpServers: session.status.mcpServers,