kc-beta 0.2.1 → 0.3.1

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

@@ -52,9 +52,43 @@ export function StatusBar({ sessionId, phase, contextTokens, contextLimit }) {
   );
 }
 
+// --- Task dashboard (ralph-loop) ---
+
+export function TaskDashboard({ tasks, progress }) {
+  if (!tasks || tasks.length === 0) return null;
+
+  const { total, completed } = progress || { total: 0, completed: 0 };
+  const barWidth = 20;
+  const filled = total > 0 ? Math.round((completed / total) * barWidth) : 0;
+  const bar = "\u2588".repeat(filled) + "\u2591".repeat(barWidth - filled);
+
+  // Show at most 8 tasks — current + a few before/after
+  const currentIdx = tasks.findIndex((t) => t.status === "in_progress");
+  const startIdx = Math.max(0, Math.min(currentIdx - 2, tasks.length - 8));
+  const visible = tasks.slice(startIdx, startIdx + 8);
+  const hasMore = tasks.length > 8;
+
+  return h(Box, { flexDirection: "column", marginLeft: 2, marginBottom: 1, borderStyle: "single", borderColor: "gray", paddingLeft: 1, paddingRight: 1 },
+    h(Text, { dimColor: true }, `Tasks [${bar}] ${completed}/${total}`),
+    ...visible.map((t) => {
+      const icon = t.status === "completed" ? "\u2713"
+        : t.status === "in_progress" ? "\u25b8"
+        : t.status === "failed" ? "\u2717"
+        : "\u00b7";
+      const color = t.status === "completed" ? "green"
+        : t.status === "in_progress" ? "cyan"
+        : t.status === "failed" ? "red"
+        : "gray";
+      const label = `${t.ruleId || t.id}  ${t.title}`;
+      return h(Text, { key: t.id, color }, `  ${icon} ${label.slice(0, 50)}`);
+    }),
+    hasMore ? h(Text, { dimColor: true }, `  ... ${tasks.length - 8} more`) : null,
+  );
+}
+
 // --- 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 +96,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

@@ -10,6 +10,7 @@ import {
   StatusBar,
   CookingSpinner,
   ToolBlock,
+  TaskDashboard,
   HRule,
   InputPrompt,
 } from "./components.js";
@@ -32,6 +33,8 @@ function App({ engine, config }) {
   const [spinnerStatus, setSpinnerStatus] = useState(null);
   const [contextTokens, setContextTokens] = useState(0);
   const [contextLimit, setContextLimit] = useState(config.kcContextLimit || 200000);
+  const [taskList, setTaskList] = useState([]);
+  const [taskProgress, setTaskProgress] = useState(null);
 
   const engineRef = useRef(engine);
   const streamingRef = useRef(false);
@@ -60,7 +63,7 @@ function App({ engine, config }) {
     let accumulated = "";
 
     try {
-      for await (const event of engineRef.current.runTurn(text)) {
+      for await (const event of engineRef.current.runTaskLoop(text)) {
         switch (event.type) {
           case "text_delta":
             accumulated += event.text ?? "";
@@ -110,6 +113,16 @@ function App({ engine, config }) {
             break;
           }
 
+          case "task_progress": {
+            const tp = event.data;
+            setTaskList(engineRef.current.taskManager.getAllTasks());
+            setTaskProgress(tp.progress);
+            if (tp.status === "in_progress") {
+              setSpinnerStatus(`Task: ${tp.title}`);
+            }
+            break;
+          }
+
           case "error":
             addMessage({ role: "system", content: `Error: ${event.message ?? "Unknown error"}` });
             break;
@@ -144,6 +157,7 @@ function App({ engine, config }) {
             "Commands:\n" +
             "  /help                Show this help\n" +
             "  /status              Show session info, model, phase, workspace\n" +
+            "  /tasks               Show task progress\n" +
             "  /clear               Clear conversation history (keep workspace)\n" +
             "  /compact             Summarize older messages to reduce context\n" +
             "  /sessions            List all sessions\n" +
@@ -163,6 +177,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` +
@@ -171,6 +186,13 @@ function App({ engine, config }) {
         return true;
       }
 
+      case "/tasks":
+        addMessage({
+          role: "system",
+          content: engineRef.current.taskManager.formatForDisplay(),
+        });
+        return true;
+
       case "/clear":
         engineRef.current.history = new ConversationHistory(engineRef.current.workspace.cwd);
         setMessages([]);
@@ -320,7 +342,10 @@ function App({ engine, config }) {
 
   return h(Box, { flexDirection: "column" },
     // Welcome banner
-    showWelcome ? h(WelcomeBanner) : null,
+    showWelcome ? h(WelcomeBanner, { projectDir: config.projectDir }) : null,
+
+    // Task dashboard (ralph-loop)
+    taskList.length > 0 ? h(TaskDashboard, { tasks: taskList, progress: taskProgress }) : null,
 
     // Message history
     ...messages.map((msg, i) => {
@@ -389,6 +414,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 +427,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 };