w-dispatch-ai 1.0.24 → 1.0.26

package/src/readEnvFile.mjs

@@ -1,60 +1,60 @@
-import fs from 'fs'
-
-
-// readEnvFile.mjs — 讀.env為金鑰來源物件(不污染process.env)
-//
-// 【為何需要】resolveProviders之opt.env本為「不用process.env」而設計——多專案並行時
-//   污染全域環境變數會互相覆蓋金鑰——但「env物件從哪來」套件原無答案, README舊教法
-//   process.loadEnvFile('./.env')反而把金鑰塞進process.env, 與該設計目的自相矛盾。
-//   兩個消費端專案已各寫一份解析器且行為不一致(2026-08-18使用端調研), 收斂於此。
-//
-// 【為何讀不到回空物件而非拋錯】金鑰缺失由resolveProviders之skipped機制回報
-//   (缺金鑰停用該條目、不中斷), 此處拋錯反而讓「部分供應商無金鑰」升級成整體啟動失敗;
-//   要fail-loud的呼叫端自行檢查回傳(如Object.keys(env).length)。
-//
-// 【只解析KEY=value最簡格式】不引入dotenv: 金鑰為單行純文字, 僅剝除成對之首尾引號,
-//   不做跳脫與多行處理——加解析規則只會製造與其他.env工具的行為差異。
-
-
-/**
- * 讀取.env檔為鍵值物件(金鑰來源, 不寫入process.env)
- *
- * 特點：
- * 只解析`KEY=value`形式(KEY限英數底線)，忽略空行、註解與無效行；
- * value修剪空白並剝除成對之首尾引號(單雙引號皆可)；
- * 檔案不存在或不可讀一律回空物件不throw(金鑰缺失交由resolveProviders之skipped回報)
- *
- * @param {String} file 輸入.env檔案路徑字串
- * @returns {Object} 回傳鍵值物件(變數名 → 字串值)，讀取失敗回空物件
- * @example
- *
- * import readEnvFile from './src/readEnvFile.mjs'
- * import resolveProviders from './src/resolveProviders.mjs'
- * import providersAll from './src/providers.mjs'
- *
- * //金鑰放.env(變數值以逗號分隔多把), 讀成物件交resolveProviders, 不污染process.env
- * let env = readEnvFile('./.env')
- * let { providers, skipped } = resolveProviders(providersAll, { env, pick: ['agnes:agnes-2.5-flash'] })
- *
- */
-function readEnvFile(file) {
-    let out = {}
-    let text = ''
-    try {
-        text = fs.readFileSync(file, 'utf8')
-    }
-    catch (e) {
-        return out //檔案不存在或不可讀, 回空由skipped機制回報
-    }
-    for (let line of text.split(/\r?\n/)) {
-        let m = line.match(/^\s*([A-Za-z0-9_]+)\s*=\s*(.*)$/)
-        if (!m) {
-            continue
-        }
-        out[m[1]] = m[2].trim().replace(/^(["'])(.*)\1$/, '$2')
-    }
-    return out
-}
-
-
-export default readEnvFile
+import fs from 'fs'
+
+
+// readEnvFile.mjs — 讀.env為金鑰來源物件(不污染process.env)
+//
+// 【為何需要】resolveProviders之opt.env本為「不用process.env」而設計——多專案並行時
+//   污染全域環境變數會互相覆蓋金鑰——但「env物件從哪來」套件原無答案, README舊教法
+//   process.loadEnvFile('./.env')反而把金鑰塞進process.env, 與該設計目的自相矛盾。
+//   兩個消費端專案已各寫一份解析器且行為不一致(2026-08-18使用端調研), 收斂於此。
+//
+// 【為何讀不到回空物件而非拋錯】金鑰缺失由resolveProviders之skipped機制回報
+//   (缺金鑰停用該條目、不中斷), 此處拋錯反而讓「部分供應商無金鑰」升級成整體啟動失敗;
+//   要fail-loud的呼叫端自行檢查回傳(如Object.keys(env).length)。
+//
+// 【只解析KEY=value最簡格式】不引入dotenv: 金鑰為單行純文字, 僅剝除成對之首尾引號,
+//   不做跳脫與多行處理——加解析規則只會製造與其他.env工具的行為差異。
+
+
+/**
+ * 讀取.env檔為鍵值物件(金鑰來源, 不寫入process.env)
+ *
+ * 特點：
+ * 只解析`KEY=value`形式(KEY限英數底線)，忽略空行、註解與無效行；
+ * value修剪空白並剝除成對之首尾引號(單雙引號皆可)；
+ * 檔案不存在或不可讀一律回空物件不throw(金鑰缺失交由resolveProviders之skipped回報)
+ *
+ * @param {String} file 輸入.env檔案路徑字串
+ * @returns {Object} 回傳鍵值物件(變數名 → 字串值)，讀取失敗回空物件
+ * @example
+ *
+ * import readEnvFile from './src/readEnvFile.mjs'
+ * import resolveProviders from './src/resolveProviders.mjs'
+ * import providersAll from './src/providers.mjs'
+ *
+ * //金鑰放.env(變數值以逗號分隔多把), 讀成物件交resolveProviders, 不污染process.env
+ * let env = readEnvFile('./.env')
+ * let { providers, skipped } = resolveProviders(providersAll, { env, pick: ['agnes:agnes-3.0-flash'] })
+ *
+ */
+function readEnvFile(file) {
+    let out = {}
+    let text = ''
+    try {
+        text = fs.readFileSync(file, 'utf8')
+    }
+    catch (e) {
+        return out //檔案不存在或不可讀, 回空由skipped機制回報
+    }
+    for (let line of text.split(/\r?\n/)) {
+        let m = line.match(/^\s*([A-Za-z0-9_]+)\s*=\s*(.*)$/)
+        if (!m) {
+            continue
+        }
+        out[m[1]] = m[2].trim().replace(/^(["'])(.*)\1$/, '$2')
+    }
+    return out
+}
+
+
+export default readEnvFile

package/src/resolveProviders.mjs

@@ -1,181 +1,181 @@
-import get from 'lodash-es/get.js'
-import omit from 'lodash-es/omit.js'
-import isarr from 'wsemi/src/isarr.mjs'
-import isobj from 'wsemi/src/isobj.mjs'
-import isestr from 'wsemi/src/isestr.mjs'
-import isearr from 'wsemi/src/isearr.mjs'
-import strFindSimilar from 'wsemi/src/strFindSimilar.mjs'
-
-
-// resolveProviders.mjs — 把providers定義檔展開為可直接使用的條目
-//
-// 【為何需要】providers.mjs之條目以envVar間接引用金鑰(機密不落設定檔, 只寫變數名),
-//   而dispatchAiFallback只認keys陣列——本函數負責envVar → keys之展開,
-//   缺對應環境變數者停用該條目並列入skipped回報(不中斷、不throw),
-//   訂閱登入態條目(claude/codex等無envVar)原樣通過。
-//
-// 【自選】opt.pick給id陣列即可只取用部分條目, 且依pick之順序回傳
-//   (順序即dispatchAiFallback之優先序); 查無之id列入missing回報。
-//
-// 【後處理單一入口: opt.exes與opt.patch】消費端常需於展開後對條目做兩類覆寫:
-//   ①逐kind注入CLI執行檔絕對路徑(Windows排程於session 0執行時PATH可能不含npm
-//     全域目錄, 靠指令名會ENOENT); ②逐id覆寫任意欄位(如各家實測耗時相差近10倍,
-//     timeoutMs須逐條指定)。此前只能於呼叫端自行map, 而陣列版(providers)與表格版
-//     (table)若各自後處理, 極易只套用其一——使用端殷鑑(2026-08-14): 逐條timeout
-//     只加在陣列版, 工作流走表格版全部落回全域預設而不自知。後處理收進本函數,
-//     兩種輸出同源產出, 結構性杜絕單邊套用。
-
-
-/**
- * 展開providers定義條目：envVar → keys，並可依id自選子集
- *
- * 特點：
- * 條目之envVar依env來源(預設process.env)展開為keys陣列(變數值以逗號分隔多把)，envVar欄位自輸出移除；
- * 缺對應環境變數(或值為空)之條目停用並列入skipped，不中斷不throw；
- * 無envVar之條目(訂閱登入態CLI)原樣通過；條目已自帶有效keys者以keys為準；
- * opt.pick可依id自選子集並以pick順序回傳(順序即遞補優先序)；
- * opt.exes依kind注入CLI執行檔路徑、opt.patch依id淺合併覆寫欄位——皆於展開後施作，
- * providers與table同源產出故必然一致；
- * 輸入陣列與條目皆不被改動(輸出為淺拷貝)
- *
- * @param {Array} providers 輸入providers條目物件陣列(如providers.mjs之預設匯出)
- * @param {Object} [opt={}] 輸入設定物件，預設{}
- * @param {Object} [opt.env=process.env] 輸入金鑰來源物件(變數名 → 逗號分隔之金鑰字串)，預設process.env。建議以readEnvFile('./.env')讀成物件傳入，不污染process.env
- * @param {Array} [opt.pick=null] 輸入自選id字串陣列，依此順序回傳對應條目，查無之id列入missing，預設null代表全取(依原順序)
- * @param {Object} [opt.exes=null] 輸入kind對執行檔絕對路徑之物件(如{claude:'C:/.../claude.exe'})，命中kind之條目補上exe欄位(條目已自帶exe者不覆寫——條目層設定優先)，預設null代表不注入
- * @param {Object} [opt.patch=null] 輸入id對部分欄位之物件(如{'claude:sonnet':{timeoutMs:360000}})，命中id之條目淺合併覆寫，於exes之後施作故可覆寫exe，預設null代表不覆寫
- * @returns {Object} 回傳物件，內含providers(可直接餵dispatchAiFallback之條目陣列)、table(id對條目之物件，可直接餵dispatchAiWkf)、skipped(缺環境變數而停用之{id,envVar}陣列)、missing(pick查無之id字串陣列)、hints(missing id對最接近可用id之拼寫提示物件，pick查無多半是打錯字，附最接近id供直接定位；僅為相似度最高者非保證正解，無missing時為空物件)
- * @example
- *
- * import resolveProviders from './src/resolveProviders.mjs'
- * import readEnvFile from './src/readEnvFile.mjs'
- * import providersAll from './src/providers.mjs'
- *
- * //金鑰放.env(變數值以逗號分隔多把), 以readEnvFile讀成物件, 不污染process.env
- * let env = readEnvFile('./.env')
- *
- * //全取: envVar展開為keys, 缺環境變數者列入skipped
- * let { providers, table, skipped } = resolveProviders(providersAll, { env })
- * console.log(providers.length, skipped)
- * // => 17 []
- *
- * //pick打錯字時, missing附拼寫提示hints(最接近之可用id)
- * let rm = resolveProviders(providersAll, { env, pick: ['poolside/laguna-s-2.1'] })
- * console.log(rm.missing, rm.hints)
- * // => [ 'poolside/laguna-s-2.1' ] { 'poolside/laguna-s-2.1': 'poolside:laguna-s-2.1' }
- *
- * //自選: 依pick順序回傳(順序即遞補優先序), 可直接餵dispatchAiFallback
- * let r2 = resolveProviders(providersAll, { env, pick: ['agnes:agnes-2.5-flash', 'claude:sonnet'] })
- * console.log(r2.providers.map((p) => p.id))
- * // => [ 'agnes:agnes-2.5-flash', 'claude:sonnet' ]
- *
- * //後處理: exes逐kind注入執行檔、patch逐id覆寫欄位, 陣列與table同步生效
- * let r3 = resolveProviders(providersAll, {
- *     env,
- *     pick: ['agnes:agnes-2.5-flash', 'claude:sonnet'],
- *     exes: { claude: 'C:/Users/x/.local/bin/claude.exe' },
- *     patch: { 'claude:sonnet': { timeoutMs: 360000 } },
- * })
- * console.log(r3.table['claude:sonnet'].exe, r3.table['claude:sonnet'].timeoutMs)
- * // => 'C:/Users/x/.local/bin/claude.exe' 360000
- *
- * //table可直接餵dispatchAiWkf之providers定義表
- * //let wkf = dispatchAiWkf({ providers: r2.table, defaults: { timeoutMs: 1200000 } })
- *
- */
-function resolveProviders(providers, opt = {}) {
-
-    //env, 無效回退process.env(瀏覽器環境無process則空物件)
-    let env = get(opt, 'env', null)
-    if (!isobj(env)) {
-        env = (typeof process !== 'undefined' && process && isobj(process.env)) ? process.env : {}
-    }
-
-    //providersRaw
-    let providersRaw = isarr(providers) ? providers.filter(isobj) : []
-
-    //pick, 依id自選並依pick順序回傳
-    let pick = get(opt, 'pick', null)
-    let missing = []
-    let selected = providersRaw
-    if (isearr(pick)) {
-        selected = []
-        for (let id of pick) {
-            let entry = providersRaw.find((p) => get(p, 'id', null) === id)
-            if (entry) {
-                selected.push(entry)
-            }
-            else {
-                missing.push(String(id))
-            }
-        }
-    }
-
-    //hints, missing之拼寫提示: 自全部條目id中找最接近者——實務上pick查無多半是打錯字
-    //(如'poolside/laguna'誤作分隔符), 附上最接近id可直接定位; 僅為相似度最高者, 非保證正解
-    let hints = {}
-    if (missing.length > 0) {
-        let ids = providersRaw.map((p) => get(p, 'id', null)).filter(isestr)
-        for (let mid of missing) {
-            hints[mid] = (ids.length > 0) ? get(strFindSimilar(mid, ids), 'bestMatch.target', null) : null
-        }
-    }
-
-    //展開envVar → keys
-    let out = []
-    let skipped = []
-    for (let entry of selected) {
-        let envVar = get(entry, 'envVar', null)
-
-        //無envVar(訂閱登入態CLI)或已自帶有效keys, 原樣通過(僅移除envVar欄位)
-        if (!isestr(envVar) || isearr(get(entry, 'keys', null))) {
-            out.push(omit(entry, ['envVar']))
-            continue
-        }
-
-        //envVar → keys, 變數值以逗號分隔多把
-        let keys = String(get(env, envVar, '') || '').split(',').map((k) => k.trim()).filter(Boolean)
-        if (keys.length === 0) {
-
-            //缺環境變數: 停用該條目並回報, 不中斷(設計providers原則§四.4)
-            skipped.push({ id: get(entry, 'id', ''), envVar })
-            continue
-        }
-        out.push({ ...omit(entry, ['envVar']), keys })
-    }
-
-    //後處理: exes(逐kind)與patch(逐id), 於table組建「之前」施作——
-    //providers與table由同一份out產出, 兩種輸出必然一致(檔頭之單邊套用殷鑑)
-    let exes = get(opt, 'exes', null)
-    let patch = get(opt, 'patch', null)
-    if (isobj(exes) || isobj(patch)) {
-        out = out.map((entry) => {
-            let e = entry
-
-            //exes: 條目已自帶exe者不覆寫(條目層設定優先於全域注入)
-            let exe = isobj(exes) ? get(exes, get(e, 'kind', ''), null) : null
-            if (isestr(exe) && !isestr(get(e, 'exe', null))) {
-                e = { ...e, exe }
-            }
-
-            //patch: 依id淺合併, 於exes之後施作故可覆寫exe
-            let pt = isobj(patch) ? get(patch, get(e, 'id', ''), null) : null
-            if (isobj(pt)) {
-                e = { ...e, ...pt }
-            }
-
-            return e
-        })
-    }
-
-    //table, id → 條目, 可直接作dispatchAiWkf之providers定義表
-    let table = {}
-    for (let entry of out) {
-        table[entry.id] = entry
-    }
-
-    return { providers: out, table, skipped, missing, hints }
-}
-
-
-export default resolveProviders
+import get from 'lodash-es/get.js'
+import omit from 'lodash-es/omit.js'
+import isarr from 'wsemi/src/isarr.mjs'
+import isobj from 'wsemi/src/isobj.mjs'
+import isestr from 'wsemi/src/isestr.mjs'
+import isearr from 'wsemi/src/isearr.mjs'
+import strFindSimilar from 'wsemi/src/strFindSimilar.mjs'
+
+
+// resolveProviders.mjs — 把providers定義檔展開為可直接使用的條目
+//
+// 【為何需要】providers.mjs之條目以envVar間接引用金鑰(機密不落設定檔, 只寫變數名),
+//   而dispatchAiFallback只認keys陣列——本函數負責envVar → keys之展開,
+//   缺對應環境變數者停用該條目並列入skipped回報(不中斷、不throw),
+//   訂閱登入態條目(claude/codex等無envVar)原樣通過。
+//
+// 【自選】opt.pick給id陣列即可只取用部分條目, 且依pick之順序回傳
+//   (順序即dispatchAiFallback之優先序); 查無之id列入missing回報。
+//
+// 【後處理單一入口: opt.exes與opt.patch】消費端常需於展開後對條目做兩類覆寫:
+//   ①逐kind注入CLI執行檔絕對路徑(Windows排程於session 0執行時PATH可能不含npm
+//     全域目錄, 靠指令名會ENOENT); ②逐id覆寫任意欄位(如各家實測耗時相差近10倍,
+//     timeoutMs須逐條指定)。此前只能於呼叫端自行map, 而陣列版(providers)與表格版
+//     (table)若各自後處理, 極易只套用其一——使用端殷鑑(2026-08-14): 逐條timeout
+//     只加在陣列版, 工作流走表格版全部落回全域預設而不自知。後處理收進本函數,
+//     兩種輸出同源產出, 結構性杜絕單邊套用。
+
+
+/**
+ * 展開providers定義條目：envVar → keys，並可依id自選子集
+ *
+ * 特點：
+ * 條目之envVar依env來源(預設process.env)展開為keys陣列(變數值以逗號分隔多把)，envVar欄位自輸出移除；
+ * 缺對應環境變數(或值為空)之條目停用並列入skipped，不中斷不throw；
+ * 無envVar之條目(訂閱登入態CLI)原樣通過；條目已自帶有效keys者以keys為準；
+ * opt.pick可依id自選子集並以pick順序回傳(順序即遞補優先序)；
+ * opt.exes依kind注入CLI執行檔路徑、opt.patch依id淺合併覆寫欄位——皆於展開後施作，
+ * providers與table同源產出故必然一致；
+ * 輸入陣列與條目皆不被改動(輸出為淺拷貝)
+ *
+ * @param {Array} providers 輸入providers條目物件陣列(如providers.mjs之預設匯出)
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {Object} [opt.env=process.env] 輸入金鑰來源物件(變數名 → 逗號分隔之金鑰字串)，預設process.env。建議以readEnvFile('./.env')讀成物件傳入，不污染process.env
+ * @param {Array} [opt.pick=null] 輸入自選id字串陣列，依此順序回傳對應條目，查無之id列入missing，預設null代表全取(依原順序)
+ * @param {Object} [opt.exes=null] 輸入kind對執行檔絕對路徑之物件(如{claude:'C:/.../claude.exe'})，命中kind之條目補上exe欄位(條目已自帶exe者不覆寫——條目層設定優先)，預設null代表不注入
+ * @param {Object} [opt.patch=null] 輸入id對部分欄位之物件(如{'claude:sonnet':{timeoutMs:360000}})，命中id之條目淺合併覆寫，於exes之後施作故可覆寫exe，預設null代表不覆寫
+ * @returns {Object} 回傳物件，內含providers(可直接餵dispatchAiFallback之條目陣列)、table(id對條目之物件，可直接餵dispatchAiWkf)、skipped(缺環境變數而停用之{id,envVar}陣列)、missing(pick查無之id字串陣列)、hints(missing id對最接近可用id之拼寫提示物件，pick查無多半是打錯字，附最接近id供直接定位；僅為相似度最高者非保證正解，無missing時為空物件)
+ * @example
+ *
+ * import resolveProviders from './src/resolveProviders.mjs'
+ * import readEnvFile from './src/readEnvFile.mjs'
+ * import providersAll from './src/providers.mjs'
+ *
+ * //金鑰放.env(變數值以逗號分隔多把), 以readEnvFile讀成物件, 不污染process.env
+ * let env = readEnvFile('./.env')
+ *
+ * //全取: envVar展開為keys, 缺環境變數者列入skipped
+ * let { providers, table, skipped } = resolveProviders(providersAll, { env })
+ * console.log(providers.length, skipped)
+ * // => 17 []
+ *
+ * //pick打錯字時, missing附拼寫提示hints(最接近之可用id)
+ * let rm = resolveProviders(providersAll, { env, pick: ['poolside/laguna-s-2.1'] })
+ * console.log(rm.missing, rm.hints)
+ * // => [ 'poolside/laguna-s-2.1' ] { 'poolside/laguna-s-2.1': 'poolside:laguna-s-2.1' }
+ *
+ * //自選: 依pick順序回傳(順序即遞補優先序), 可直接餵dispatchAiFallback
+ * let r2 = resolveProviders(providersAll, { env, pick: ['agnes:agnes-3.0-flash', 'claude:sonnet'] })
+ * console.log(r2.providers.map((p) => p.id))
+ * // => [ 'agnes:agnes-3.0-flash', 'claude:sonnet' ]
+ *
+ * //後處理: exes逐kind注入執行檔、patch逐id覆寫欄位, 陣列與table同步生效
+ * let r3 = resolveProviders(providersAll, {
+ *     env,
+ *     pick: ['agnes:agnes-3.0-flash', 'claude:sonnet'],
+ *     exes: { claude: 'C:/Users/x/.local/bin/claude.exe' },
+ *     patch: { 'claude:sonnet': { timeoutMs: 360000 } },
+ * })
+ * console.log(r3.table['claude:sonnet'].exe, r3.table['claude:sonnet'].timeoutMs)
+ * // => 'C:/Users/x/.local/bin/claude.exe' 360000
+ *
+ * //table可直接餵dispatchAiWkf之providers定義表
+ * //let wkf = dispatchAiWkf({ providers: r2.table, defaults: { timeoutMs: 1200000 } })
+ *
+ */
+function resolveProviders(providers, opt = {}) {
+
+    //env, 無效回退process.env(瀏覽器環境無process則空物件)
+    let env = get(opt, 'env', null)
+    if (!isobj(env)) {
+        env = (typeof process !== 'undefined' && process && isobj(process.env)) ? process.env : {}
+    }
+
+    //providersRaw
+    let providersRaw = isarr(providers) ? providers.filter(isobj) : []
+
+    //pick, 依id自選並依pick順序回傳
+    let pick = get(opt, 'pick', null)
+    let missing = []
+    let selected = providersRaw
+    if (isearr(pick)) {
+        selected = []
+        for (let id of pick) {
+            let entry = providersRaw.find((p) => get(p, 'id', null) === id)
+            if (entry) {
+                selected.push(entry)
+            }
+            else {
+                missing.push(String(id))
+            }
+        }
+    }
+
+    //hints, missing之拼寫提示: 自全部條目id中找最接近者——實務上pick查無多半是打錯字
+    //(如'poolside/laguna'誤作分隔符), 附上最接近id可直接定位; 僅為相似度最高者, 非保證正解
+    let hints = {}
+    if (missing.length > 0) {
+        let ids = providersRaw.map((p) => get(p, 'id', null)).filter(isestr)
+        for (let mid of missing) {
+            hints[mid] = (ids.length > 0) ? get(strFindSimilar(mid, ids), 'bestMatch.target', null) : null
+        }
+    }
+
+    //展開envVar → keys
+    let out = []
+    let skipped = []
+    for (let entry of selected) {
+        let envVar = get(entry, 'envVar', null)
+
+        //無envVar(訂閱登入態CLI)或已自帶有效keys, 原樣通過(僅移除envVar欄位)
+        if (!isestr(envVar) || isearr(get(entry, 'keys', null))) {
+            out.push(omit(entry, ['envVar']))
+            continue
+        }
+
+        //envVar → keys, 變數值以逗號分隔多把
+        let keys = String(get(env, envVar, '') || '').split(',').map((k) => k.trim()).filter(Boolean)
+        if (keys.length === 0) {
+
+            //缺環境變數: 停用該條目並回報, 不中斷(設計providers原則§四.4)
+            skipped.push({ id: get(entry, 'id', ''), envVar })
+            continue
+        }
+        out.push({ ...omit(entry, ['envVar']), keys })
+    }
+
+    //後處理: exes(逐kind)與patch(逐id), 於table組建「之前」施作——
+    //providers與table由同一份out產出, 兩種輸出必然一致(檔頭之單邊套用殷鑑)
+    let exes = get(opt, 'exes', null)
+    let patch = get(opt, 'patch', null)
+    if (isobj(exes) || isobj(patch)) {
+        out = out.map((entry) => {
+            let e = entry
+
+            //exes: 條目已自帶exe者不覆寫(條目層設定優先於全域注入)
+            let exe = isobj(exes) ? get(exes, get(e, 'kind', ''), null) : null
+            if (isestr(exe) && !isestr(get(e, 'exe', null))) {
+                e = { ...e, exe }
+            }
+
+            //patch: 依id淺合併, 於exes之後施作故可覆寫exe
+            let pt = isobj(patch) ? get(patch, get(e, 'id', ''), null) : null
+            if (isobj(pt)) {
+                e = { ...e, ...pt }
+            }
+
+            return e
+        })
+    }
+
+    //table, id → 條目, 可直接作dispatchAiWkf之providers定義表
+    let table = {}
+    for (let entry of out) {
+        table[entry.id] = entry
+    }
+
+    return { providers: out, table, skipped, missing, hints }
+}
+
+
+export default resolveProviders

package/test/tools/fakeServerForApiTest.mjs

@@ -32,7 +32,15 @@ import http from 'http'
 //   no-output      — 200但缺output陣列
 //   not-json/slow/err-500/flaky-429 — 同chat/completions之對應行為
 //   其他           — 401(同Zen實測: 未知model回401非404)
-// 【金鑰規則】Authorization含'sk-bad'一律401(優先於model路由), 模擬無效金鑰。
+// 【systemone之行為路由(POST /v1/systemone, 依body.model; 形狀取自2026-09-17 TypeSafe實測)】
+//   echo / jev-latest — 200, 每題回{type:'noul', noul:0.5, echoAuth, echoBody}, 供斷言請求組成
+//   missing-answer    — 200但answers缺最後一題
+//   no-answers        — 200但無answers
+//   bad-question      — 422 {detail:[{type:'union_tag_invalid',...}]}
+//   not-json/slow/err-500/flaky-429 — 同chat/completions之對應行為
+//   其他              — 400 {detail:{error_type:'api_usage_error', message:'Unknown model: X'}}
+// 【金鑰規則】Authorization含'sk-bad'一律401(優先於model路由), 模擬無效金鑰;
+//   systemone路由之401本體採TypeSafe形狀{detail:{error_type:'authentication_error'}}。
 
 
 /**
@@ -50,9 +58,10 @@ async function fakeServerForApiTest() {
 
     let server = http.createServer((req, res) => {
 
-        //僅受理POST /v1/chat/completions與POST /v1/responses
+        //僅受理POST /v1/chat/completions、POST /v1/responses與POST /v1/systemone
         let isResponses = req.url.endsWith('/responses')
-        if (req.method !== 'POST' || (!req.url.endsWith('/chat/completions') && !isResponses)) {
+        let isSystemOne = req.url.endsWith('/systemone')
+        if (req.method !== 'POST' || (!req.url.endsWith('/chat/completions') && !isResponses && !isSystemOne)) {
             res.writeHead(404, { 'Content-Type': 'application/json' })
             res.end(JSON.stringify({ error: { message: 'not found' } }))
             return
@@ -75,15 +84,76 @@ async function fakeServerForApiTest() {
                 return
             }
 
-            //無效金鑰, 模擬Zen之401形態
+            //無效金鑰, 模擬Zen之401形態(systemone則模擬TypeSafe之形態)
             if (auth.includes('sk-bad')) {
                 res.writeHead(401, { 'Content-Type': 'application/json' })
-                res.end(JSON.stringify({ type: 'error', error: { type: 'AuthError', message: 'Invalid API key.' } }))
+                if (isSystemOne) {
+                    res.end(JSON.stringify({ detail: { error_type: 'authentication_error', message: 'Cannot authenticate with the server. Please check your API key and try again.' } }))
+                }
+                else {
+                    res.end(JSON.stringify({ type: 'error', error: { type: 'AuthError', message: 'Invalid API key.' } }))
+                }
                 return
             }
 
             let model = body.model || ''
 
+            //System One路由(/systemone): 回answers而非文字, 見dispatchApiTypesafeSystemone檔頭
+            if (isSystemOne) {
+                let send = (code, obj) => {
+                    res.writeHead(code, { 'Content-Type': 'application/json' })
+                    res.end(JSON.stringify(obj))
+                }
+                let ids = Object.keys(body.questions || {})
+                let usage = { input_tokens: 7, output_tokens: 3 }
+                let okResp = (extra = {}) => {
+                    let answers = {}
+                    for (let id of ids) {
+                        answers[id] = { type: 'noul', noul: 0.5, ...extra }
+                    }
+                    send(200, { model: 'jev-1.13.0', answers, usage })
+                }
+                if (model === 'echo' || model === 'jev-latest') {
+                    okResp({ echoAuth: auth, echoBody: body })
+                }
+                else if (model === 'missing-answer') {
+                    let answers = {}
+                    for (let id of ids.slice(0, -1)) {
+                        answers[id] = { type: 'noul', noul: 0.5 }
+                    }
+                    send(200, { model: 'jev-1.13.0', answers, usage })
+                }
+                else if (model === 'no-answers') {
+                    send(200, { model: 'jev-1.13.0', usage })
+                }
+                else if (model === 'bad-question') {
+                    send(422, { detail: [{ type: 'union_tag_invalid', loc: ['body', 'questions', ids[0]], msg: 'Input tag does not match any of the expected tags' }] })
+                }
+                else if (model === 'not-json') {
+                    res.writeHead(200, { 'Content-Type': 'text/plain' })
+                    res.end('plain text body')
+                }
+                else if (model === 'slow') {
+                    setTimeout(() => okResp(), 10000)
+                }
+                else if (model === 'err-500') {
+                    send(500, { detail: { error_type: 'server_error', message: 'internal error' } })
+                }
+                else if (model === 'flaky-429') {
+                    flakyCount[auth] = (flakyCount[auth] || 0) + 1
+                    if (flakyCount[auth] === 1) {
+                        send(429, { detail: { error_type: 'rate_limit_error', message: 'rate limited' } })
+                    }
+                    else {
+                        okResp({ attempt: flakyCount[auth] })
+                    }
+                }
+                else {
+                    send(400, { detail: { error_type: 'api_usage_error', message: `Unknown model: ${model}` } })
+                }
+                return
+            }
+
             //Responses API路由(/responses): 形狀與chat/completions完全不同, 見dispatchApiOpenaiResponses檔頭
             if (isResponses) {
                 let send = (code, obj) => {