kc-beta 0.2.1 → 0.3.0

package/src/agent/tools/workspace-file.js

@@ -5,9 +5,9 @@ import { BaseTool, ToolResult } from "./base.js";
 const MAX_READ = 50_000;
 
 /**
- * Read, write, or list files in the workspace directory.
- * All paths are resolved relative to the workspace root with
- * traversal protection. VersionManager hooks into writes for automatic versioning.
+ * Read, write, or list files in the workspace or project directory.
+ * All paths are resolved relative to the chosen scope with
+ * traversal protection. VersionManager hooks into workspace writes for automatic versioning.
  */
 export class WorkspaceFileTool extends BaseTool {
   /**
@@ -24,9 +24,10 @@ export class WorkspaceFileTool extends BaseTool {
 
   get description() {
     return (
-      "Read, write, or list files in the workspace directory. " +
-      "Operations: read (returns file content), write (creates/overwrites a file), " +
-      "list (shows directory contents)."
+      "Read, write, or list files. " +
+      "scope='workspace' (default): KC's working directory for rules, skills, workflows, results. " +
+      "scope='project': the user's project folder where KC was launched — source regulations and samples live here. " +
+      "Operations: read (returns file content), write (creates/overwrites a file), list (shows directory contents)."
     );
   }
 
@@ -41,34 +42,58 @@ export class WorkspaceFileTool extends BaseTool {
         },
         path: {
           type: "string",
-          description: "Relative path within the workspace. Defaults to '.' for list.",
+          description: "Relative path within the chosen scope. Defaults to '.' for list.",
         },
         content: {
           type: "string",
           description: "File content to write (required for write operation)",
         },
+        scope: {
+          type: "string",
+          enum: ["workspace", "project"],
+          description: "Which directory to operate in. 'workspace' (default) = KC's workspace. 'project' = user's project directory.",
+        },
       },
       required: ["operation"],
     };
   }
 
+  _resolveForScope(filePath, scope) {
+    if (scope === "project") {
+      return this._workspace.resolveProjectPath(filePath);
+    }
+    return this._workspace.resolvePath(filePath);
+  }
+
+  _baseForScope(scope) {
+    if (scope === "project") {
+      return this._workspace.projectDir;
+    }
+    return this._workspace.cwd;
+  }
+
   async execute(input) {
     const op = input.operation || "";
     const filePath = input.path || ".";
     const content = input.content || "";
+    const scope = input.scope || "workspace";
+
+    if (scope === "project" && !this._workspace.projectDir) {
+      return new ToolResult("No project directory available. KC was launched without a project context.", true);
+    }
 
     try {
-      if (op === "read") return this._read(filePath);
-      if (op === "write") return this._write(filePath, content);
-      if (op === "list") return this._list(filePath);
+      if (op === "read") return this._read(filePath, scope);
+      if (op === "write") return this._write(filePath, content, scope);
+      if (op === "list") return this._list(filePath, scope);
       return new ToolResult(`Unknown operation: ${op}`, true);
     } catch (err) {
       return new ToolResult(`File error: ${err.message}`, true);
     }
   }
 
-  _read(filePath) {
-    const resolved = this._workspace.resolvePath(filePath);
+  _read(filePath, scope) {
+    const resolved = this._resolveForScope(filePath, scope);
     if (!fs.existsSync(resolved) || !fs.statSync(resolved).isFile()) {
       return new ToolResult(`File not found: ${filePath}`, true);
     }
@@ -79,27 +104,28 @@ export class WorkspaceFileTool extends BaseTool {
     return new ToolResult(text);
   }
 
-  _write(filePath, content) {
+  _write(filePath, content, scope) {
     if (!filePath || filePath === ".") {
       return new ToolResult("Path required for write operation", true);
     }
-    const resolved = this._workspace.resolvePath(filePath);
+    const resolved = this._resolveForScope(filePath, scope);
     fs.mkdirSync(path.dirname(resolved), { recursive: true });
     fs.writeFileSync(resolved, content, "utf-8");
 
-    // Version tracking (structural — cannot be bypassed)
+    // Version tracking only for workspace writes
     let traceId = null;
-    if (this._versionManager) {
+    if (scope === "workspace" && this._versionManager) {
       traceId = this._versionManager.onWrite(filePath, content);
     }
 
-    let msg = `Wrote ${content.length} chars to ${filePath}`;
+    const label = scope === "project" ? `[project] ${filePath}` : filePath;
+    let msg = `Wrote ${content.length} chars to ${label}`;
     if (traceId) msg += ` [trace: ${traceId}]`;
     return new ToolResult(msg);
   }
 
-  _list(filePath) {
-    const resolved = this._workspace.resolvePath(filePath);
+  _list(filePath, scope) {
+    const resolved = this._resolveForScope(filePath, scope);
     if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {
       return new ToolResult(`Not a directory: ${filePath}`, true);
     }
@@ -112,8 +138,9 @@ export class WorkspaceFileTool extends BaseTool {
     if (entries.length === 0) {
       return new ToolResult("(empty directory)");
     }
+    const base = this._baseForScope(scope);
     const lines = entries.map((e) => {
-      const rel = path.relative(this._workspace.cwd, path.join(resolved, e.name));
+      const rel = path.relative(base, path.join(resolved, e.name));
       const marker = e.isDirectory() ? "[dir] " : "      ";
       return `${marker}${rel}`;
     });

package/src/agent/workspace.js

@@ -11,11 +11,13 @@ export class Workspace {
   /**
    * @param {string} root - Workspace root directory
    * @param {string} [sessionId] - Session identifier (auto-generated if omitted)
+   * @param {string} [projectDir] - User's project directory (CWD at launch)
    */
-  constructor(root, sessionId) {
+  constructor(root, sessionId, projectDir) {
     this.root = path.resolve(root);
     this.sessionId = sessionId || crypto.randomUUID().replace(/-/g, "").slice(0, 12);
     this.path = path.resolve(this.root, this.sessionId);
+    this.projectDir = projectDir ? path.resolve(projectDir) : null;
     fs.mkdirSync(this.path, { recursive: true });
   }
 
@@ -42,6 +44,27 @@ export class Workspace {
     return resolved;
   }
 
+  /**
+   * Resolve a user-supplied relative path against the project directory.
+   * Same traversal protection as resolvePath() but for the project folder.
+   * @param {string} userPath
+   * @returns {string}
+   */
+  resolveProjectPath(userPath) {
+    if (!this.projectDir) {
+      throw new Error("No project directory available");
+    }
+    if (path.isAbsolute(userPath)) {
+      throw new Error(`Absolute paths not allowed: ${userPath}`);
+    }
+    const resolved = path.resolve(this.projectDir, userPath);
+    const base = path.resolve(this.projectDir);
+    if (resolved !== base && !resolved.startsWith(base + path.sep)) {
+      throw new Error(`Path escapes project directory: ${userPath}`);
+    }
+    return resolved;
+  }
+
   /**
    * Rename the workspace folder. Returns the new sessionId.
    * @param {string} newName

package/src/cli/components.js

@@ -54,7 +54,7 @@ export function StatusBar({ sessionId, phase, contextTokens, contextLimit }) {
 
 // --- Welcome banner ---
 
-export function WelcomeBanner() {
+export function WelcomeBanner({ projectDir } = {}) {
   return h(Box, { flexDirection: "column", marginBottom: 1, borderStyle: "round", borderColor: "gray", paddingLeft: 1, paddingRight: 1 },
     h(Box, null,
       h(Text, { bold: true }, "KC AGENT CLI"),
@@ -62,6 +62,13 @@ export function WelcomeBanner() {
     ),
     h(Text, { dimColor: true }, "Hope you never know what KC was."),
     h(Text, null, ""),
+    projectDir
+      ? h(Box, { flexDirection: "column" },
+          h(Text, { dimColor: true }, `Project: ${projectDir}`),
+          h(Text, { color: "yellow", dimColor: true }, "KC has full read/write access to this directory. We recommend backing up important files."),
+        )
+      : null,
+    h(Text, null, ""),
     h(Text, { dimColor: true }, "Product of Memium / kitchen-engineer42"),
   );
 }

package/src/cli/config.js

@@ -23,7 +23,7 @@ const L = {
     noConfig: "No config found. Run 'kc-beta onboard' first.",
     menu: "Configuration Categories",
     choose: "Choose category (q to quit)",
-    categories: ["LLM Provider & API Key", "Model Tiers", "Quality Thresholds", "Language"],
+    categories: ["LLM Provider & API Key", "Model Tiers", "VLM Tiers (Vision/OCR)", "Worker LLM Provider", "Quality Thresholds", "Language"],
     saved: "Saved.",
     back: "← Back to menu",
     enterKeep: "Press Enter to keep",
@@ -41,7 +41,7 @@ const L = {
     noConfig: "未找到配置。请先运行 'kc-beta onboard'。",
     menu: "配置类别",
     choose: "选择类别（q 退出）",
-    categories: ["大模型服务商 & API 密钥", "模型分层", "质量阈值", "语言"],
+    categories: ["大模型服务商 & API 密钥", "模型分层", "VLM 视觉模型分层", "Worker LLM 服务商", "质量阈值", "语言"],
     saved: "已保存。",
     back: "← 返回菜单",
     enterKeep: "回车保留当前值",
@@ -118,11 +118,26 @@ async function editProvider(rl, config, t) {
   // Base URL
   if (provider.id === "custom") {
     config.base_url = await ask(rl, `  ${CYAN}${t.baseUrl}${RESET}`, config.base_url || "");
+  } else if (provider.supportsCodingPlanKey) {
+    // Providers with coding plan support — ask which key type
+    const keyTypeLabel = config.language === "zh" ? "密钥类型" : "Key Type";
+    const opt1 = config.language === "zh" ? "API Key（按量付费）" : "API Key (pay-per-use)";
+    const opt2 = config.language === "zh" ? "Coding Plan Key（包年包月）" : "Coding Plan Key (subscription)";
+    console.log(`  ${CYAN}${keyTypeLabel}:${RESET}`);
+    const isCodingPlan = config.base_url === provider.codingPlanUrl;
+    console.log(`    1. ${opt1}${!isCodingPlan ? ` ${GREEN}(${t.currentValue})${RESET}` : ""}`);
+    console.log(`    2. ${opt2}${isCodingPlan ? ` ${GREEN}(${t.currentValue})${RESET}` : ""}`);
+    const keyTypeDefault = isCodingPlan ? "2" : "1";
+    const keyTypeChoice = await ask(rl, `  ${GRAY}>${RESET}`, keyTypeDefault);
+    config.base_url = keyTypeChoice === "2" ? provider.codingPlanUrl : provider.baseUrl;
+    console.log(`  ${CYAN}${t.baseUrl}${RESET}: ${DIM}${config.base_url}${RESET}`);
   } else {
+    // Keep existing base_url if it matches this provider, otherwise use default
     const defaultUrl = provider.baseUrl;
     console.log(`  ${CYAN}${t.baseUrl}${RESET}: ${DIM}${defaultUrl}${RESET}`);
     config.base_url = defaultUrl;
   }
+  console.log();
 
   // API Key
   const masked = maskKey(config.api_key);
@@ -161,14 +176,93 @@ async function editTiers(rl, config, t) {
 }
 
 /**
- * Category 3: Quality Thresholds
+ * Category 3: VLM Tiers (Vision/OCR)
  */
-async function editThresholds(rl, config, t) {
+async function editVlmTiers(rl, config, t) {
   console.log();
   console.log(`  ${BOLD}${t.categories[2]}${RESET}`);
   console.log(`  ${GRAY}${"─".repeat(35)}${RESET}`);
   console.log();
 
+  const vlmTiers = config.vlm_tiers || {};
+  const provider = getProviderById(config.provider);
+  const defaults = provider?.defaultVlm || {};
+
+  for (const tier of ["tier1", "tier2", "tier3"]) {
+    const current = vlmTiers[tier] || defaults[tier] || "";
+    vlmTiers[tier] = await ask(rl, `  ${CYAN}${tier.toUpperCase()}${RESET}`, current, t.enterKeep);
+  }
+  config.vlm_tiers = vlmTiers;
+  console.log();
+}
+
+/**
+ * Category 4: Worker LLM Provider
+ */
+async function editWorkerProvider(rl, config, t) {
+  console.log();
+  console.log(`  ${BOLD}${t.categories[3]}${RESET}`);
+  console.log(`  ${GRAY}${"─".repeat(35)}${RESET}`);
+  console.log();
+
+  const currentWorker = config.worker_provider || "";
+  const statusLabel = currentWorker
+    ? `${currentWorker} (${getProviderById(currentWorker)?.name || "unknown"})`
+    : config.language === "zh" ? "（与主服务商相同）" : "(same as conductor)";
+  console.log(`  ${DIM}${t.currentValue}: ${statusLabel}${RESET}`);
+  console.log();
+
+  const sameLabel = config.language === "zh" ? "使用与主服务商相同配置？" : "Use same provider as conductor?";
+  const sameChoice = await ask(rl, `  ${sameLabel}`, "Y", "Y/n");
+
+  if (sameChoice.toLowerCase() === "n" || sameChoice.toLowerCase() === "no") {
+    const providers = getProviders();
+    const labels = getProviderLabels(config.language || "en");
+    console.log();
+    console.log(`  ${CYAN}${t.categories[3]}:${RESET}`);
+    for (let i = 0; i < labels.length; i++) {
+      const marker = providers[i].id === config.worker_provider ? ` ${GREEN}(${t.currentValue})${RESET}` : "";
+      console.log(`    ${i + 1}. ${labels[i].label}${marker}`);
+    }
+    const wIdx = parseInt(await ask(rl, `  ${GRAY}>${RESET}`, "1"), 10) - 1;
+    const wp = providers[Math.max(0, Math.min(wIdx, providers.length - 1))];
+    config.worker_provider = wp.id;
+    config.worker_auth_type = wp.authType;
+    config.worker_api_format = wp.apiFormat;
+
+    if (wp.id === "custom") {
+      config.worker_base_url = await ask(rl, `  ${CYAN}Base URL${RESET}`, config.worker_base_url || "");
+    } else {
+      config.worker_base_url = wp.baseUrl;
+    }
+
+    // Worker API Key
+    const masked = maskKey(config.worker_api_key);
+    const keyPrompt = masked
+      ? `  ${CYAN}API Key (Worker)${RESET} ${DIM}(${masked})${RESET}`
+      : `  ${CYAN}API Key (Worker)${RESET}`;
+    const newKey = await ask(rl, keyPrompt, "", masked ? t.enterKeep : "");
+    if (newKey) config.worker_api_key = newKey;
+  } else {
+    // Clear worker-specific config (use conductor)
+    config.worker_provider = "";
+    config.worker_api_key = "";
+    config.worker_base_url = "";
+    config.worker_auth_type = "";
+    config.worker_api_format = "";
+  }
+  console.log();
+}
+
+/**
+ * Category 5: Quality Thresholds
+ */
+async function editThresholds(rl, config, t) {
+  console.log();
+  console.log(`  ${BOLD}${t.categories[4]}${RESET}`);
+  console.log(`  ${GRAY}${"─".repeat(35)}${RESET}`);
+  console.log();
+
   config.accuracy_threshold = parseFloat(
     await ask(rl, `  ${CYAN}Accuracy threshold${RESET}`, String(config.accuracy_threshold ?? 0.9), t.enterKeep)
   );
@@ -189,7 +283,7 @@ async function editThresholds(rl, config, t) {
  */
 async function editLanguage(rl, config, t) {
   console.log();
-  console.log(`  ${BOLD}${t.categories[3]}${RESET}`);
+  console.log(`  ${BOLD}${t.categories[5]}${RESET}`);
   console.log(`  ${GRAY}${"─".repeat(35)}${RESET}`);
   console.log();
 
@@ -202,7 +296,7 @@ async function editLanguage(rl, config, t) {
   console.log();
 }
 
-const CATEGORY_HANDLERS = [editProvider, editTiers, editThresholds, editLanguage];
+const CATEGORY_HANDLERS = [editProvider, editTiers, editVlmTiers, editWorkerProvider, editThresholds, editLanguage];
 
 /**
  * Main config editor loop.

package/src/cli/index.js

@@ -163,6 +163,7 @@ function App({ engine, config }) {
             `Model:     ${config.kcModel}\n` +
             `Provider:  ${config.provider || "unknown"}\n` +
             `LLM URL:   ${config.llmBaseUrl}\n` +
+            `Project:   ${engineRef.current.workspace.projectDir || "(none)"}\n` +
             `Workspace: ${engineRef.current.workspace.cwd}\n` +
             `Tools:     ${engineRef.current.toolRegistry.size} registered\n` +
             `History:   ${engineRef.current.history.messages.length} messages\n` +
@@ -320,7 +321,7 @@ function App({ engine, config }) {
 
   return h(Box, { flexDirection: "column" },
     // Welcome banner
-    showWelcome ? h(WelcomeBanner) : null,
+    showWelcome ? h(WelcomeBanner, { projectDir: config.projectDir }) : null,
 
     // Message history
     ...messages.map((msg, i) => {
@@ -389,6 +390,9 @@ function App({ engine, config }) {
 export async function main({ languageOverride } = {}) {
   const config = loadSettings();
 
+  // Capture user's project directory (CWD at launch)
+  config.projectDir = process.cwd();
+
   // Session-only language override (does NOT persist to config)
   if (languageOverride) {
     config.language = languageOverride;
@@ -399,6 +403,15 @@ export async function main({ languageOverride } = {}) {
     process.exit(1);
   }
 
+  // Warn if all worker LLM tiers are blank
+  const allTiersBlank = !config.tier1 && !config.tier2 && !config.tier3 && !config.tier4;
+  if (allTiersBlank) {
+    const msg = config.language === "zh"
+      ? "  ⚠ 所有 Worker LLM 分层为空。DISTILL 模式将不可用。运行 'kc-beta config' 或 'kc-beta onboard' 配置模型分层。"
+      : "  ⚠ All worker LLM tiers are blank. DISTILL mode will not work. Run 'kc-beta config' or 'kc-beta onboard' to configure model tiers.";
+    console.log(`\x1b[33m${msg}\x1b[0m\n`);
+  }
+
   const client = new LLMClient({
     apiKey: config.llmApiKey,
     baseUrl: config.llmBaseUrl,

package/src/cli/onboard.js

@@ -37,7 +37,11 @@ const L = {
     keyTypeOptions: ["API Key (pay-per-use)", "Coding Plan Key (subscription)"],
     conductorModel: "Conductor Model",
     workerTiers: "Worker LLM Tiers",
+    vlmTiers: "VLM Tiers (Vision/OCR)",
     tierHint: "Press Enter to accept defaults",
+    workerConfig: "Worker LLM Provider",
+    workerSameProvider: "Use same provider for worker LLMs?",
+    yesNo: "Y/n",
     accuracy: "Accuracy Threshold",
     saved: "Saved to",
     runHint: "Run {cmd} to start the agent.",
@@ -67,7 +71,11 @@ const L = {
     keyTypeOptions: ["API Key（按量付费）", "Coding Plan Key（包年包月）"],
     conductorModel: "主模型",
     workerTiers: "Worker 模型分层",
+    vlmTiers: "VLM 视觉模型分层（OCR）",
     tierHint: "回车接受默认值",
+    workerConfig: "Worker LLM 服务商",
+    workerSameProvider: "Worker LLM 使用同一服务商？",
+    yesNo: "Y/n",
     accuracy: "准确率阈值",
     saved: "已保存至",
     runHint: "运行 {cmd} 启动 Agent。",
@@ -237,7 +245,7 @@ export async function onboard() {
   );
   console.log();
 
-  // --- Worker tiers ---
+  // --- Worker LLM tiers ---
   console.log(`  ${CYAN}${t.workerTiers}${RESET} ${DIM}(${t.tierHint})${RESET}`);
   const tiers = {};
   for (const tier of ["tier1", "tier2", "tier3", "tier4"]) {
@@ -251,6 +259,59 @@ export async function onboard() {
   }
   console.log();
 
+  // --- VLM tiers (vision/OCR) ---
+  console.log(`  ${CYAN}${t.vlmTiers}${RESET} ${DIM}(${t.tierHint})${RESET}`);
+  const vlmTiers = {};
+  for (const tier of ["tier1", "tier2", "tier3"]) {
+    const def = provider.defaultVlm?.[tier] || existing?.vlm_tiers?.[tier] || "";
+    vlmTiers[tier] = await ask(
+      rl,
+      `    ${tier.toUpperCase()}`,
+      def,
+    );
+  }
+  console.log();
+
+  // --- Worker LLM provider (optional) ---
+  console.log(`  ${CYAN}${t.workerConfig}${RESET}`);
+  const sameProvider = await ask(rl, `  ${t.workerSameProvider}`, "Y", t.yesNo);
+  let workerProvider = "";
+  let workerApiKey = "";
+  let workerBaseUrl = "";
+  let workerAuthType = "";
+  let workerApiFormat = "";
+
+  if (sameProvider.toLowerCase() === "n" || sameProvider.toLowerCase() === "no") {
+    // Pick a different provider for workers
+    console.log();
+    console.log(`  ${CYAN}${t.providerPrompt} (Worker):${RESET}`);
+    for (let i = 0; i < labels.length; i++) {
+      console.log(`    ${i + 1}. ${labels[i].label}`);
+    }
+    const wIdx = parseInt(await ask(rl, `  ${GRAY}>${RESET} ${t.choose}`, "1"), 10) - 1;
+    const wp = providers[Math.max(0, Math.min(wIdx, providers.length - 1))];
+    workerProvider = wp.id;
+    workerAuthType = wp.authType;
+    workerApiFormat = wp.apiFormat;
+    workerBaseUrl = wp.baseUrl;
+
+    if (wp.id === "custom") {
+      workerBaseUrl = await ask(rl, `  ${t.baseUrl}`, existing.worker_base_url || "");
+    }
+
+    // Worker API key
+    const wMasked = existing.worker_api_key ? existing.worker_api_key.slice(0, 6) + "..." + existing.worker_api_key.slice(-4) : "";
+    const wKeyHint = wMasked ? t.apiKeyKeep : t.apiKeyRequired;
+    workerApiKey = await ask(
+      rl,
+      `  ${CYAN}${t.apiKey} (Worker)${RESET}`,
+      "",
+      wKeyHint,
+    );
+    workerApiKey = workerApiKey || existing.worker_api_key || "";
+  }
+  console.log();
+
   rl.close();
 
   // Preserve existing thresholds or set defaults (editable via 'kc-beta config')
@@ -268,6 +329,14 @@ export async function onboard() {
     api_format: provider.apiFormat,
     conductor_model: model,
     tiers,
+    vlm_tiers: vlmTiers,
+    // Worker LLM (optional — empty means use conductor config)
+    worker_provider: workerProvider,
+    worker_api_key: workerApiKey,
+    worker_base_url: workerBaseUrl,
+    worker_auth_type: workerAuthType,
+    worker_api_format: workerApiFormat,
+    // Thresholds
     accuracy_threshold: accuracy,
     systemic_threshold: systemicThreshold,
     spot_check_rate: spotCheckRate,

package/src/config.js

@@ -55,7 +55,7 @@ export function loadSettings(workspacePath) {
   const provider = gc.provider || "siliconflow";
   const providerDef = getProviderById(provider);
 
-  return {
+  const settings = {
     // Provider identity
     provider,
     authType: gc.auth_type || providerDef?.authType || "bearer",
@@ -73,8 +73,17 @@ export function loadSettings(workspacePath) {
     tier3: env.TIER3 || gc.tiers?.tier3 || "",
     tier4: env.TIER4 || gc.tiers?.tier4 || "",
 
-    // OCR models
-    ocrModelTier1: env.OCR_MODEL_TIER1 || "zai-org/GLM-4.6V",
+    // VLM tiers (vision/OCR models)
+    vlmTier1: env.VLM_TIER1 || gc.vlm_tiers?.tier1 || "",
+    vlmTier2: env.VLM_TIER2 || gc.vlm_tiers?.tier2 || "",
+    vlmTier3: env.VLM_TIER3 || gc.vlm_tiers?.tier3 || "",
+
+    // Worker LLM — optional, defaults to conductor config
+    workerProvider: gc.worker_provider || "",
+    workerApiKey: env.WORKER_API_KEY || gc.worker_api_key || "",
+    workerBaseUrl: env.WORKER_BASE_URL || gc.worker_base_url || "",
+    workerAuthType: gc.worker_auth_type || "",
+    workerApiFormat: gc.worker_api_format || "",
 
     // Document parsing
     mineruApiUrl: env.MINERU_API_URL || "",
@@ -106,6 +115,37 @@ export function loadSettings(workspacePath) {
     // Language
     language: env.LANGUAGE || gc.language || "en",
   };
+
+  // Effective worker config (falls back to conductor config)
+  settings.effectiveWorkerProvider = () => settings.workerProvider || settings.provider;
+  settings.effectiveWorkerApiKey = () => settings.workerApiKey || settings.llmApiKey;
+  settings.effectiveWorkerBaseUrl = () => {
+    if (settings.workerBaseUrl) return settings.workerBaseUrl;
+    // If worker uses a different provider, use that provider's default base URL
+    if (settings.workerProvider && settings.workerProvider !== settings.provider) {
+      const wp = getProviderById(settings.workerProvider);
+      return wp?.baseUrl || settings.llmBaseUrl;
+    }
+    return settings.llmBaseUrl;
+  };
+  settings.effectiveWorkerAuthType = () => {
+    if (settings.workerAuthType) return settings.workerAuthType;
+    if (settings.workerProvider && settings.workerProvider !== settings.provider) {
+      const wp = getProviderById(settings.workerProvider);
+      return wp?.authType || settings.authType;
+    }
+    return settings.authType;
+  };
+  settings.effectiveWorkerApiFormat = () => {
+    if (settings.workerApiFormat) return settings.workerApiFormat;
+    if (settings.workerProvider && settings.workerProvider !== settings.provider) {
+      const wp = getProviderById(settings.workerProvider);
+      return wp?.apiFormat || settings.apiFormat;
+    }
+    return settings.apiFormat;
+  };
+
+  return settings;
 }
 
 export { GLOBAL_CONFIG_DIR, GLOBAL_CONFIG_PATH };