@yeaft/webchat-agent 0.1.938 → 0.1.940

package/connection/message-router.js

@@ -337,7 +337,25 @@ export async function handleMessage(msg) {
 
     // LLM configuration (read/write ~/.yeaft/config.json)
     case 'get_llm_config': {
-      const config = getLlmConfig(ctx.CONFIG?.yeaftDir);
+      if (msg.globalConfig && typeof msg.globalConfig === 'object') {
+        ctx.globalLlmConfig = msg.globalConfig;
+      }
+      const config = getLlmConfig(ctx.CONFIG?.yeaftDir, ctx.globalLlmConfig);
+      sendToServer({ type: 'llm_config', ...config });
+      break;
+    }
+
+    case 'llm_global_config_updated': {
+      ctx.globalLlmConfig = msg.globalConfig && typeof msg.globalConfig === 'object'
+        ? msg.globalConfig
+        : { providers: [] };
+      // Existing sessions cache AdapterRouter instances. Drop them so the
+      // next Yeaft turn sees the new global providers, without writing them
+      // to the node-local config.json.
+      resetYeaftSession().catch(err => {
+        console.error('[LLM] Failed to reload Yeaft session after global config update:', err.message);
+      });
+      const config = getLlmConfig(ctx.CONFIG?.yeaftDir, ctx.globalLlmConfig);
       sendToServer({ type: 'llm_config', ...config });
       break;
     }
@@ -351,7 +369,10 @@ export async function handleMessage(msg) {
       const incomingLanguage = typeof msg.config?.language === 'string' && msg.config.language
         ? msg.config.language
         : null;
-      const result = updateLlmConfig(msg.config || {}, ctx.CONFIG?.yeaftDir);
+      if (msg.globalConfig && typeof msg.globalConfig === 'object') {
+        ctx.globalLlmConfig = msg.globalConfig;
+      }
+      const result = updateLlmConfig(msg.config || {}, ctx.CONFIG?.yeaftDir, ctx.globalLlmConfig);
       // task-708: live locale propagation. When the user flips the UI
       // language dropdown, push the new value into every cached Engine
       // (per-VP pool + 1:1 chat session.engine) so the very next turn
@@ -362,6 +383,11 @@ export async function handleMessage(msg) {
       }
       if (!result.error) {
         refreshYeaftStatus({ reason: 'llm_config_updated' }).catch(() => {});
+        if (!incomingLanguage) {
+          resetYeaftSession().catch(err => {
+            console.error('[LLM] Failed to reload Yeaft session after local config update:', err.message);
+          });
+        }
       }
       sendToServer({ type: 'llm_config_updated', ...result });
       break;

package/context.js

@@ -18,6 +18,8 @@ export default {
   slashCommandDescriptions: {},
   // MCP servers 列表 (从 ~/.claude.json 读取): [{ name, enabled, source }]
   mcpServers: [],
+  // Server-owned user-global LLM providers. Runtime-only: never persisted to ~/.yeaft/config.json.
+  globalLlmConfig: { providers: [] },
   // 连接相关
   reconnectTimer: null,
   pendingAuthTempId: null,

package/package.json

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

package/yeaft/config-api.js

@@ -13,6 +13,7 @@ import { join } from 'path';
 import { DEFAULT_YEAFT_DIR } from './init.js';
 import { normalizeProviderModels, serializeModelForPersistence } from './models.js';
 import { normaliseYeaftSection } from './config.js';
+import { mergeLlmConfigs } from './llm/provider-merge.js';
 
 /**
  * Read the LLM-relevant portion of config.json.
@@ -20,7 +21,7 @@ import { normaliseYeaftSection } from './config.js';
  * @param {string} [dir] — Yeaft data directory
  * @returns {{ providers, primaryModel, fastModel, language } | { error: string }}
  */
-export function getLlmConfig(dir) {
+function readLocalLlmConfig(dir) {
   const root = dir || process.env.YEAFT_DIR || DEFAULT_YEAFT_DIR;
   const configPath = join(root, 'config.json');
 
@@ -28,22 +29,27 @@ export function getLlmConfig(dir) {
     return { providers: [], primaryModel: null, fastModel: null, language: 'en', needsSetup: true };
   }
 
-  try {
-    const raw = readFileSync(configPath, 'utf8');
-    const json = JSON.parse(raw);
-    const providers = Array.isArray(json.providers) ? json.providers : [];
-
-    // Detect if config still has default/placeholder values (first-time setup needed)
-    const needsSetup = providers.length === 0 || providers.every(p =>
-      p.apiKey === 'proxy' || p.apiKey === '' || !p.apiKey
-    );
+  const raw = readFileSync(configPath, 'utf8');
+  const json = JSON.parse(raw);
+  const providers = Array.isArray(json.providers) ? json.providers : [];
+  return {
+    providers,
+    primaryModel: json.primaryModel || null,
+    fastModel: json.fastModel || null,
+    language: json.language || 'en',
+    needsSetup: providers.length === 0 || providers.every(p => p.apiKey === 'proxy' || p.apiKey === '' || (!p.apiKey && !p.credentialProvider)),
+  };
+}
 
+export function getLlmConfig(dir, globalConfig = {}) {
+  try {
+    const agentConfig = readLocalLlmConfig(dir);
+    const effectiveConfig = mergeLlmConfigs(globalConfig, agentConfig);
     return {
-      providers,
-      primaryModel: json.primaryModel || null,
-      fastModel: json.fastModel || null,
-      language: json.language || 'en',
-      needsSetup,
+      ...effectiveConfig,
+      agentConfig,
+      effectiveConfig,
+      globalConfig: { providers: Array.isArray(globalConfig.providers) ? globalConfig.providers : [] },
     };
   } catch (e) {
     return { error: `Failed to read config.json: ${e.message}` };
@@ -58,7 +64,7 @@ export function getLlmConfig(dir) {
  * @param {string} [dir] — Yeaft data directory
  * @returns {{ providers, primaryModel, fastModel, language } | { error: string }}
  */
-export function updateLlmConfig(update, dir) {
+export function updateLlmConfig(update, dir, globalConfig = {}) {
   const root = dir || process.env.YEAFT_DIR || DEFAULT_YEAFT_DIR;
   const configPath = join(root, 'config.json');
 
@@ -120,12 +126,19 @@ export function updateLlmConfig(update, dir) {
     return { error: `Failed to write config.json: ${e.message}` };
   }
 
-  return {
+  const agentConfig = {
     providers: Array.isArray(existing.providers) ? existing.providers : [],
     primaryModel: existing.primaryModel || null,
     fastModel: existing.fastModel || null,
     language: existing.language || 'en',
   };
+  const effectiveConfig = mergeLlmConfigs(globalConfig, agentConfig);
+  return {
+    ...effectiveConfig,
+    agentConfig,
+    effectiveConfig,
+    globalConfig: { providers: Array.isArray(globalConfig.providers) ? globalConfig.providers : [] },
+  };
 }
 
 // ─── Yeaft runtime settings (task-318) ────────────────────────────

package/yeaft/config.js

@@ -23,6 +23,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 { mergeLlmConfigs } from './llm/provider-merge.js';
 
 /** Default configuration values. */
 const DEFAULTS = {
@@ -294,36 +295,47 @@ export function loadConfig(overrides = {}) {
   }
 
   // ─── Build config from config.json ────────────────────────
-  const providers = Array.isArray(jsonConfig.providers) ? jsonConfig.providers : null;
+  const agentProviders = Array.isArray(jsonConfig.providers) ? jsonConfig.providers : [];
+  const mergedLlmConfig = mergeLlmConfigs(overrides.globalLlmConfig || {}, {
+    providers: agentProviders,
+    primaryModel: jsonConfig.primaryModel || null,
+    fastModel: jsonConfig.fastModel || null,
+    language: jsonConfig.language || DEFAULTS.language,
+  });
+  const providers = mergedLlmConfig.providers;
 
   // Resolve primary model
   let model = 'claude-sonnet-4-20250514';
-  let primaryModel = jsonConfig.primaryModel || null;
+  let modelIdForInfo = model;
+  let primaryModel = mergedLlmConfig.primaryModel || null;
   if (primaryModel) {
     const parsed = parseModelRef(primaryModel);
-    model = parsed.modelId;
+    model = parsed.providerName?.startsWith('global:') ? primaryModel : parsed.modelId;
+    modelIdForInfo = parsed.modelId;
   }
 
   // Resolve fast model
-  let fastModel = jsonConfig.fastModel || primaryModel || null;
+  let fastModel = mergedLlmConfig.fastModel || primaryModel || null;
   let fastModelId = null;
   if (fastModel) {
     const parsed = parseModelRef(fastModel);
-    fastModelId = parsed.modelId;
+    fastModelId = parsed.providerName?.startsWith('global:') ? fastModel : parsed.modelId;
   }
 
   // Resolve model info for adapter/baseUrl/thinking metadata. Token limits
   // (contextWindow / maxOutputTokens) are NOT read from here — they live in
   // models.dev and are resolved via resolveContextWindow / resolveMaxOutputTokens
   // a few lines below so the live models.dev snapshot is the source of truth.
-  const modelInfo = resolveModel(model);
+  // For disambiguated global provider refs (`global:<provider>/<model>`), keep
+  // the runtime model ref intact above but resolve metadata by the raw model id.
+  const modelInfo = resolveModel(modelIdForInfo);
 
   // Pre-resolve token limits once so we can both write them onto config and
   // pass `config` to the resolver chain consistently below.
   const resolvedMaxContext = overrides.maxContextTokens ?? jsonConfig.maxContextTokens
-    ?? resolveContextWindow(model, { modelInfo });
+    ?? resolveContextWindow(modelIdForInfo, { modelInfo });
   const resolvedMaxOutput = overrides.maxOutputTokens ?? jsonConfig.maxOutputTokens
-    ?? resolveMaxOutputTokens(model, { modelInfo });
+    ?? resolveMaxOutputTokens(modelIdForInfo, { modelInfo });
 
   const config = {
     // Model
@@ -335,7 +347,7 @@ export function loadConfig(overrides = {}) {
     modelInfo: modelInfo || null,
 
     // Providers
-    providers: providers,
+    providers: providers.length > 0 ? providers : null,
 
     // General settings
     language: overrides.language || jsonConfig.language || DEFAULTS.language,

package/yeaft/llm/provider-merge.js

@@ -0,0 +1,53 @@
+function cloneProvider(provider, scope) {
+  return {
+    ...provider,
+    scope,
+    source: scope,
+    originalName: provider.name,
+    models: Array.isArray(provider.models)
+      ? provider.models.map(m => (m && typeof m === 'object' ? { ...m } : m))
+      : [],
+  };
+}
+
+function modelId(entry) {
+  if (typeof entry === 'string') return entry;
+  if (entry && typeof entry === 'object' && typeof entry.id === 'string') return entry.id;
+  return '';
+}
+
+export function buildModelRef(provider, entry) {
+  const id = modelId(entry);
+  return provider?.name && id ? `${provider.name}/${id}` : id;
+}
+
+export function mergeLlmConfigs(globalConfig = {}, agentConfig = {}) {
+  const agentProviders = Array.isArray(agentConfig.providers)
+    ? agentConfig.providers.map(p => cloneProvider(p, 'agent'))
+    : [];
+  const localNames = new Set(agentProviders.map(p => p.name).filter(Boolean));
+  const usedNames = new Set(localNames);
+  const globalProviders = [];
+
+  for (const raw of Array.isArray(globalConfig.providers) ? globalConfig.providers : []) {
+    if (!raw?.name) continue;
+    const provider = cloneProvider(raw, 'global');
+    if (usedNames.has(provider.name)) {
+      let candidate = `global:${provider.name}`;
+      let i = 2;
+      while (usedNames.has(candidate)) candidate = `global:${provider.name}:${i++}`;
+      provider.name = candidate;
+    }
+    usedNames.add(provider.name);
+    globalProviders.push(provider);
+  }
+
+  const providers = [...globalProviders, ...agentProviders];
+  return {
+    providers,
+    primaryModel: agentConfig.primaryModel || null,
+    fastModel: agentConfig.fastModel || null,
+    language: agentConfig.language || 'en',
+    needsSetup: providers.length === 0 || providers.every(p => (!p.apiKey || p.apiKey === 'proxy') && !p.credentialProvider && !p.githubToken),
+  };
+}

package/yeaft/llm/router.js

@@ -22,7 +22,7 @@
  */
 
 import { LLMAdapter } from './adapter.js';
-import { getThinkingCapability, normalizeEffort } from '../models.js';
+import { getThinkingCapability, normalizeEffort, parseModelRef } from '../models.js';
 import { pairSanitize } from '../pair-sanitize.js';
 
 /**
@@ -106,7 +106,7 @@ export function filterEffortForModel(params) {
     const { effort: _drop, ...rest } = params;
     return rest;
   }
-  const cap = getThinkingCapability(params.model);
+  const cap = getThinkingCapability(parseModelRef(params.model).modelId);
   if (!cap.supportsThinking || cap.thinkingProtocol === 'none') {
     const { effort: _drop, ...rest } = params;
     return rest;
@@ -220,6 +220,10 @@ export class AdapterRouter extends LLMAdapter {
       for (const raw of provider.models) {
         const entry = normalizeModelEntry(raw);
         if (!entry) continue;
+        const ref = provider.name ? `${provider.name}/${entry.id}` : entry.id;
+        if (!this.#modelToProvider.has(ref)) {
+          this.#modelToProvider.set(ref, { provider, entry });
+        }
         if (!this.#modelToProvider.has(entry.id)) {
           this.#modelToProvider.set(entry.id, { provider, entry });
         }
@@ -276,13 +280,13 @@ export class AdapterRouter extends LLMAdapter {
    * Resolve a model ID to its provider's adapter (lazy-created, cached).
    *
    * @param {string} modelId
-   * @returns {Promise<LLMAdapter>}
+   * @returns {Promise<{adapter: LLMAdapter, modelId: string}>}
    */
-  async #resolveAdapter(modelId) {
-    const hit = this.#modelToProvider.get(modelId);
+  async #resolveAdapter(modelRef) {
+    const hit = this.#modelToProvider.get(modelRef);
     if (!hit) {
       throw new Error(
-        `Model "${modelId}" not found in any provider. ` +
+        `Model "${modelRef}" not found in any provider. ` +
         `Available models: ${[...this.#modelToProvider.keys()].join(', ') || '(none)'}. ` +
         `Check your config.json providers[].models arrays.`
       );
@@ -308,7 +312,7 @@ export class AdapterRouter extends LLMAdapter {
     const apiKeyFp = apiKey ? this.#shortFingerprint(apiKey) : 'none';
     const cacheKey = `${provider.name}::${protocol}::${apiKeyFp}`;
     const cached = this.#adapterCache.get(cacheKey);
-    if (cached) return cached;
+    if (cached) return { adapter: cached, modelId: entry.id };
 
     // Token rotation eviction: when a credential provider hands us a NEW
     // fingerprint for the same (provider, protocol) pair, drop the stale
@@ -345,7 +349,7 @@ export class AdapterRouter extends LLMAdapter {
     }
 
     this.#adapterCache.set(cacheKey, adapter);
-    return adapter;
+    return { adapter, modelId: entry.id };
   }
 
   /**
@@ -362,6 +366,11 @@ export class AdapterRouter extends LLMAdapter {
    */
   async #resolveApiKey(provider) {
     const name = provider && provider.credentialProvider;
+    if (name === 'github-copilot' && provider?.githubToken) {
+      const { exchangeToken } = await import('./credentials/github-copilot.js');
+      const exchanged = await exchangeToken(provider.githubToken);
+      return exchanged.token;
+    }
     if (!name) return provider?.apiKey || '';
     const { getCredentialProvider, CREDENTIAL_PROVIDER_NAMES } = await import('./credentials/index.js');
     const cp = getCredentialProvider(name);
@@ -402,8 +411,8 @@ export class AdapterRouter extends LLMAdapter {
   async *stream(params) {
     const filtered = filterEffortForModel(params);
     const sanitized = sanitizeMessagesForWire(filtered);
-    const adapter = await this.#resolveAdapter(sanitized.model);
-    yield* adapter.stream(sanitized);
+    const { adapter, modelId } = await this.#resolveAdapter(sanitized.model);
+    yield* adapter.stream({ ...sanitized, model: modelId });
   }
 
   /**
@@ -415,8 +424,8 @@ export class AdapterRouter extends LLMAdapter {
   async call(params) {
     const filtered = filterEffortForModel(params);
     const sanitized = sanitizeMessagesForWire(filtered);
-    const adapter = await this.#resolveAdapter(sanitized.model);
-    return adapter.call(sanitized);
+    const { adapter, modelId } = await this.#resolveAdapter(sanitized.model);
+    return adapter.call({ ...sanitized, model: modelId });
   }
 
   /**
@@ -437,8 +446,17 @@ export class AdapterRouter extends LLMAdapter {
    */
   listAvailableModels() {
     const result = [];
-    for (const [modelId, hit] of this.#modelToProvider) {
-      result.push({ modelId, providerName: hit.provider.name });
+    const seen = new Set();
+    for (const provider of this.#providers) {
+      if (!Array.isArray(provider.models)) continue;
+      for (const raw of provider.models) {
+        const entry = normalizeModelEntry(raw);
+        if (!entry) continue;
+        const key = `${provider.name}/${entry.id}`;
+        if (seen.has(key)) continue;
+        seen.add(key);
+        result.push({ modelId: entry.id, providerName: provider.name });
+      }
     }
     return result;
   }

package/yeaft/web-bridge.js

@@ -2725,6 +2725,7 @@ async function ensureSessionLoaded() {
   const yeaftDir = ctx.CONFIG?.yeaftDir;
   session = await loadSession({
     ...(yeaftDir && { dir: yeaftDir }),
+    configOverrides: { globalLlmConfig: ctx.globalLlmConfig || { providers: [] } },
     skipMCP: false,
     skipSkills: false,
     serverMode: true,
@@ -3850,6 +3851,7 @@ export async function handleYeaftLoadHistory(msg) {
     const yeaftDir = ctx.CONFIG?.yeaftDir;
     session = await loadSession({
       ...(yeaftDir && { dir: yeaftDir }),
+      configOverrides: { globalLlmConfig: ctx.globalLlmConfig || { providers: [] } },
       skipMCP: false,
       skipSkills: false,
       serverMode: true,
@@ -4165,6 +4167,7 @@ export async function resetYeaftSession() {
     const yeaftDir = ctx.CONFIG?.yeaftDir;
     session = await loadSession({
       ...(yeaftDir && { dir: yeaftDir }),
+      configOverrides: { globalLlmConfig: ctx.globalLlmConfig || { providers: [] } },
       skipMCP: false,
       skipSkills: false,
       serverMode: true,