thincoder 0.12.68 → 0.12.69

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.12.69] — 2026-10-03
+
+> 0.12.68 → 0.12.69（连续号——发布时定号）
+
+### Changed
+
+- **核依赖升级**：`@thincoder/core` `^0.10.1` → `^0.10.2`（统一 provider 解析随核生效）。
+- **无效 provider 态分流（#841）**：TUI——`fallback`（可运行但未设默认模型）⇒ 不弹选择器 + 一行明示（`模型` 缺 ⇒ 词形仅渠道名）；真无效（无 provider ∕ 无 key）⇒ 选择器 + 引导提示行。headless——真无效 ⇒ 可读错误 + 明确退出码；`fallback` ⇒ stderr 一行 + **继续运行**（不退出）。
+
 ## [0.12.68] — 2026-10-03
 
 > 0.12.67 → 0.12.68（连续号——发布时定号）

package/README.md

@@ -231,6 +231,10 @@ Code conventions: pure `.mjs`, no semicolons, no third-party npm dependencies al
 
 ## Changelog
 
+### 0.12.69 (2026-10)
+- **Provider-state unify (#841)** — one core resolution for the three ends (slot → `defaultModel` → first keyed channel) with three states: `ok`; `fallback` (runnable but no default model — one clear notice line, never blocked); `invalid` (no provider/key — guided picker; headless exits with a readable message and a clear code, while `fallback` prints one stderr line and keeps running). No more false "API key not configured" on a working channel.
+- **Core `^0.10.2`** — unified provider resolution (`resolveProviderPlan` / `resolveChannelModel`), `providerState` / `providerStateReason` keys, slot key gate.
+
 ### 0.12.68 (2026-10)
 - **Idle wake** — suspended sessions wake to timers: they resume on schedule (visibility surface + abort accommodation).
 - **Ledger health signals** — an unhealthy ledger database now shows a warning line in the TUI (empty values render as `—`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thincoder",
-  "version": "0.12.68",
+  "version": "0.12.69",
   "description": "Thin coding agent - zero third-party dependencies, no build step, Node.js native. Sharp code, zero bloat.",
   "keywords": [
     "ai",
@@ -20,7 +20,7 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@thincoder/core": "^0.10.1"
+    "@thincoder/core": "^0.10.2"
   },
   "files": [
     "bin/",

package/src/command-interactive.mjs

@@ -30,14 +30,23 @@ export async function chatCommand(args, ctx) {
   if (crashNotice) console.error(crashNotice)
 
   const agent = await assembleAgent()
-  // SESSION.md §6.8 D-S4（F4）+ MODEL-MERGE-SESSION：headless 无 TUI —— 可读错误 + 退出码 1，
-  // 不弹 UI、不崩溃；文案改引 defaultModel（F-6 引导 A headless 面——/config → 默认模型）
-  if (agent._providerInvalid) {
-    const dm = agent.config?.defaultModel
-    console.error(`[error] 未配置有效模型（defaultModel "${dm ?? "(not set)"}"：${agent._providerInvalidReason}）。请运行 thincoder 进入 TUI 设置（/config → 默认模型；或 /model 选择后以会话槽生效），或编辑 ${configPath}`)
+  // SESSION.md §6.8 D-S4（#841 收正）：headless 无 TUI——按**核统一态分流**（判据单源 = PROVIDER.md §6.22，
+  // 与 TUI 面同式）：**invalid 类**（`state === "invalid"` ∨ `providerInvalidReason` 非空——无渠/key
+  // ⇒ 不可运行）⇒ 可读错误 + 退出码 1（不弹 UI、不崩溃）；**fallback**（无有效 defaultModel 但可运行）
+  // ⇒ stderr 一行明示 + 继续运行（不退出——D-S2 同态同解）。条目结构不全不在本门（负向锁 =
+  // PROVIDER.md:437）——归运行期失败径（stderr + 非 0 退出）。
+  const headlessCfg = agent.config ?? {}
+  const invalidClass = headlessCfg.providerState === "invalid"
+    || (typeof headlessCfg.providerInvalidReason === "string" && headlessCfg.providerInvalidReason !== "")
+  if (invalidClass) {
+    console.error(`[error] 未配置有效渠道（${agent._providerInvalidReason ?? headlessCfg.providerStateReason ?? "provider unavailable"}）。请运行 thincoder 进入 TUI 设置（/config 设置渠道与密钥；或 /model 选择后以会话槽生效），或编辑 ${configPath}`)
     exitSoon(1)
     return
   }
+  if (headlessCfg.providerState === "fallback" && agent.provider?.name) {
+    const m = typeof agent.provider.model === "string" && agent.provider.model ? `:${agent.provider.model}` : ""
+    console.error(`尚未设置默认模型：本次使用 \`${agent.provider.name}${m}\`——/config → 默认模型 设置一次；/model 仅改本会话`)
+  }
   if (!agent.provider.apiKey) {
     if (!process.stdin.isTTY) {
       console.error(noKeyMessage())
@@ -121,9 +130,10 @@ export async function tuiCommand(ctx) {
   // F-MI7：resumeSlot = async（探测束不阻塞事件循环）——此处必须 await
   const { slot, data } = await resumeSlot(process.cwd())
   const agent = await assembleAgent({ slotData: data })
-  // SESSION.md §6.8 D-S1：TUI 路径在 startTUI 前清空无效 provider——空 provider 不流入 runAgent
-  // （崩溃源：chat() 缺 model → 网关 400 或 fetch("undefined/...") TypeError）
-  if (agent._providerInvalid) agent.provider = null
+  // SESSION.md §6.8 D-S1（#841 收正）：TUI 路径**仅在 `state === "invalid"`**（无渠/key）于 startTUI
+  // 前置 `agent.provider = null`——空 provider 不流入 runAgent（崩溃源：chat() 缺 model → 网关 400
+  // 或 fetch("undefined/...") TypeError）；`fallback` 态 provider 有效——不清（可运行 + 明示）。
+  if (agent.config?.providerState === "invalid") agent.provider = null
   const config = loadConfig()
   if (data) {
     // applySession 内部已按槽复合重算 compactThreshold（auto 时）——不再需要 switched 分支

package/src/tui/index.mjs

@@ -47,24 +47,40 @@ import { createTimerWatch, fireTimerWake } from "./timer-watch.mjs"
 export { upgradeFailureText, pendingNoticeReady } from "./update-notice.mjs"
 
 /**
- * SESSION.md §6.8 D-S2 — TUI 启动首帧前的 provider 重选流程：
- * provider 无效（`_providerInvalid` 标记或 provider 为 null）→ 先弹模型选择 picker
- * （复用 openModelPicker，展示当前可用 providers）；用户选定后继续正常启动。
- * 选择取消（Esc）→ 仍进入 TUI，推送提示行（"未配置有效 provider，可用 /model 配置
- * 渠道与模型"）——绝不因无 provider 拒绝进入。返回 true 表示弹过选择流程。
+ * SESSION.md §6.8 D-S2 — TUI 启动首帧前的 provider 分流（判据单源 = PROVIDER.md §6.22）：
+ * · **invalid 类**（`state === "invalid"` ∨ `providerInvalidReason` 非空——核「provider 不完整面」
+ *   快照的合成式）→ 先弹模型选择 picker（复用 openModelPicker，展示当前可用 providers）；
+ *   用户选定后继续正常启动。选择取消（Esc）→ 仍进入 TUI，推送提示行（措辞指渠道 ∕ 密钥——
+ *   绝不因无 provider 拒绝进入）。
+ * · **`fallback`**（无有效 defaultModel 但可运行）→ **不弹 picker**（不打断）+ 提示行明示
+ *   （「尚未设置默认模型：本次使用 `<渠道>[:<模型>]`——…」；`model` 缺省 ⇒ 仅渠道名）。
+ * 返回 true 表示弹过选择流程。
  */
 export async function promptProviderIfInvalid(agent, openModelPicker, pushLine) {
-  if (!(agent._providerInvalid || !agent.provider)) return false
-  await openModelPicker()
-  if (!agent.provider) {
-    // MODEL-MERGE-SESSION 引导 A（F-6）：空槽 + defaultModel 未设 → 提示 /config 默认模型入口
-    // （index.mjs 本行为 D-S2 取消提示扩展——设计文件清单外——随批上报）
-    const hasProviders = (agent.providers?.length ?? 0) > 0
-    pushLine(hasProviders && !agent.config?.defaultModel
-      ? "尚未设置默认模型（config.defaultModel——新会话起点）：/config → 默认模型 设置一次；/model 仅改本会话"
-      : "未配置有效 provider，可用 /model 配置渠道与模型", C.warn)
+  const cfg = agent.config ?? {}
+  // invalid 类（合成式——单源 = PROVIDER.md §6.22）：`state === "invalid"` ∨ `providerInvalidReason`
+  // 非空（核 provider 不完整面快照）；`!agent.provider`（`{}` 已被上游清成 null）同判。
+  // 结构不全（缺 baseURL 等）不在本门——归发送失败面（#840 `provider` 类词）；负向锁 = PROVIDER.md:437。
+  const invalidClass = cfg.providerState === "invalid"
+    || (typeof cfg.providerInvalidReason === "string" && cfg.providerInvalidReason !== "")
+    || !agent.provider
+  if (invalidClass) {
+    await openModelPicker()
+    if (!agent.provider) {
+      // D-S2 取消提示（#841 措辞收正 = 渠道 ∕ 密钥——配置入口 /config）
+      pushLine("未配置有效渠道（渠道 ∥ 密钥缺位）：/config 设置渠道与密钥；/model 仅改本会话", C.warn)
+    }
+    return true
   }
-  return true
+  if (cfg.providerState === "fallback") {
+    const name = agent.provider?.name
+    if (name) {
+      const model = typeof agent.provider.model === "string" && agent.provider.model ? agent.provider.model : null
+      pushLine(`尚未设置默认模型：本次使用 \`${name}${model ? `:${model}` : ""}\`——/config → 默认模型 设置一次；/model 仅改本会话`, C.warn)
+    }
+    return false
+  }
+  return false
 }
 
 /**
@@ -220,8 +236,9 @@ export async function startTUI(agent, opts = {}) {
 
   // ---------------------------------------------------------- Startup screen + background indexing
 
-  // SESSION.md §6.8 D-S2：startTUI 首帧前 —— provider 无效（_providerInvalid / provider 为 null）
-  // → 先弹模型选择 picker（keyStream 已挂 keypress，Esc/Enter 可用）；Esc → 提示行，仍进 TUI
+  // SESSION.md §6.8 D-S2：startTUI 首帧前——按核统一态分流（单源 = PROVIDER.md §6.22）：
+  // invalid 类 → 先弹模型选择 picker（keyStream 已挂 keypress，Esc/Enter 可用）；Esc → 提示行，仍进 TUI；
+  // fallback → 不弹 picker + 提示行明示（本次使用 `<渠道>[:<模型>]`）
   await promptProviderIfInvalid(agent, () => openModelPicker(), pushLine)
 
   showStartup({ agent, state, opts, pushLine, pushLabel, render, startWizard })