w-dispatch-ai 1.0.25 → 1.0.26

package/docs/global.html

@@ -29,7 +29,7 @@
 <nav >
     
     
-    <h2><a href="index.html">Home</a></h2><h3>Global</h3><ul><li><a href="global.html#NO_SIDE_EFFECT">NO_SIDE_EFFECT</a></li><li><a href="global.html#WDispatchAi">WDispatchAi</a></li><li><a href="global.html#adapters">adapters</a></li><li><a href="global.html#agyPrint">agyPrint</a></li><li><a href="global.html#attachErrorType">attachErrorType</a></li><li><a href="global.html#budgetFor">budgetFor</a></li><li><a href="global.html#buildChain">buildChain</a></li><li><a href="global.html#buildValidator">buildValidator</a></li><li><a href="global.html#callAiWithFallback">callAiWithFallback</a></li><li><a href="global.html#callOnce">callOnce</a></li><li><a href="global.html#castPintOr">castPintOr</a></li><li><a href="global.html#collectAdditional">collectAdditional</a></li><li><a href="global.html#createFileStore">createFileStore</a></li><li><a href="global.html#createUsageCounter">createUsageCounter</a></li><li><a href="global.html#decodeJwtPayload">decodeJwtPayload</a></li><li><a href="global.html#defaultIntegratePrompt">defaultIntegratePrompt</a></li><li><a href="global.html#dfQuotaTimeoutMs">dfQuotaTimeoutMs</a></li><li><a href="global.html#dfTimeoutMs">dfTimeoutMs</a></li><li><a href="global.html#directWindow">directWindow</a></li><li><a href="global.html#dispatchAi">dispatchAi</a></li><li><a href="global.html#dispatchAiFallback">dispatchAiFallback</a></li><li><a href="global.html#dispatchAiWkf">dispatchAiWkf</a></li><li><a href="global.html#dispatchAntigravity">dispatchAntigravity</a></li><li><a href="global.html#dispatchApiOpenaiCompat">dispatchApiOpenaiCompat</a></li><li><a href="global.html#dispatchApiOpenaiResponses">dispatchApiOpenaiResponses</a></li><li><a href="global.html#dispatchClaude">dispatchClaude</a></li><li><a href="global.html#dispatchCodex">dispatchCodex</a></li><li><a href="global.html#dispatchOpencode">dispatchOpencode</a></li><li><a href="global.html#extractJsonLoose">extractJsonLoose</a></li><li><a href="global.html#extractOutputText">extractOutputText</a></li><li><a href="global.html#fetchQuotaJson">fetchQuotaJson</a></li><li><a href="global.html#firstStr">firstStr</a></li><li><a href="global.html#fromBucket">fromBucket</a></li><li><a href="global.html#fromCodexUsageHttp">fromCodexUsageHttp</a></li><li><a href="global.html#fromLimitItem">fromLimitItem</a></li><li><a href="global.html#fromRpcWindow">fromRpcWindow</a></li><li><a href="global.html#fromTopField">fromTopField</a></li><li><a href="global.html#fromWindow">fromWindow</a></li><li><a href="global.html#getCliArgs">getCliArgs</a></li><li><a href="global.html#getErrorResult">getErrorResult</a></li><li><a href="global.html#getErrorType">getErrorType</a></li><li><a href="global.html#getQuotaAntigravity">getQuotaAntigravity</a></li><li><a href="global.html#getQuotaClaude">getQuotaClaude</a></li><li><a href="global.html#getQuotaCodex">getQuotaCodex</a></li><li><a href="global.html#initState">initState</a></li><li><a href="global.html#isKeyIndependentFail">isKeyIndependentFail</a></li><li><a href="global.html#pickWindow">pickWindow</a></li><li><a href="global.html#readBodyCapped">readBodyCapped</a></li><li><a href="global.html#readEnvFile">readEnvFile</a></li><li><a href="global.html#readJsonOrNull">readJsonOrNull</a></li><li><a href="global.html#redactText">redactText</a></li><li><a href="global.html#reorderByCooling">reorderByCooling</a></li><li><a href="global.html#resolveProviders">resolveProviders</a></li><li><a href="global.html#runFanout">runFanout</a></li><li><a href="global.html#runFanoutPipeline">runFanoutPipeline</a></li><li><a href="global.html#runRolePipeline">runRolePipeline</a></li><li><a href="global.html#salvageTruncatedArray">salvageTruncatedArray</a></li><li><a href="global.html#toQuotaLabel">toQuotaLabel</a></li><li><a href="global.html#toQuotaResult">toQuotaResult</a></li><li><a href="global.html#toQuotaScopedLabel">toQuotaScopedLabel</a></li><li><a href="global.html#toQuotaWindow">toQuotaWindow</a></li><li><a href="global.html#viaAppServer">viaAppServer</a></li><li><a href="global.html#viaHttp">viaHttp</a></li><li><a href="global.html#windowToSeconds">windowToSeconds</a></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Global</h3><ul><li><a href="global.html#NO_SIDE_EFFECT">NO_SIDE_EFFECT</a></li><li><a href="global.html#WDispatchAi">WDispatchAi</a></li><li><a href="global.html#adapters">adapters</a></li><li><a href="global.html#agyPrint">agyPrint</a></li><li><a href="global.html#attachErrorType">attachErrorType</a></li><li><a href="global.html#budgetFor">budgetFor</a></li><li><a href="global.html#buildChain">buildChain</a></li><li><a href="global.html#buildValidator">buildValidator</a></li><li><a href="global.html#callAiWithFallback">callAiWithFallback</a></li><li><a href="global.html#callOnce">callOnce</a></li><li><a href="global.html#castPintOr">castPintOr</a></li><li><a href="global.html#collectAdditional">collectAdditional</a></li><li><a href="global.html#createFileStore">createFileStore</a></li><li><a href="global.html#createUsageCounter">createUsageCounter</a></li><li><a href="global.html#decodeJwtPayload">decodeJwtPayload</a></li><li><a href="global.html#defaultIntegratePrompt">defaultIntegratePrompt</a></li><li><a href="global.html#dfQuotaTimeoutMs">dfQuotaTimeoutMs</a></li><li><a href="global.html#dfTimeoutMs">dfTimeoutMs</a></li><li><a href="global.html#directWindow">directWindow</a></li><li><a href="global.html#dispatchAi">dispatchAi</a></li><li><a href="global.html#dispatchAiFallback">dispatchAiFallback</a></li><li><a href="global.html#dispatchAiWkf">dispatchAiWkf</a></li><li><a href="global.html#dispatchAntigravity">dispatchAntigravity</a></li><li><a href="global.html#dispatchApiOpenaiCompat">dispatchApiOpenaiCompat</a></li><li><a href="global.html#dispatchApiOpenaiResponses">dispatchApiOpenaiResponses</a></li><li><a href="global.html#dispatchApiTypesafeSystemone">dispatchApiTypesafeSystemone</a></li><li><a href="global.html#dispatchClaude">dispatchClaude</a></li><li><a href="global.html#dispatchCodex">dispatchCodex</a></li><li><a href="global.html#dispatchOpencode">dispatchOpencode</a></li><li><a href="global.html#extractJsonLoose">extractJsonLoose</a></li><li><a href="global.html#extractOutputText">extractOutputText</a></li><li><a href="global.html#fetchQuotaJson">fetchQuotaJson</a></li><li><a href="global.html#firstStr">firstStr</a></li><li><a href="global.html#fromBucket">fromBucket</a></li><li><a href="global.html#fromCodexUsageHttp">fromCodexUsageHttp</a></li><li><a href="global.html#fromLimitItem">fromLimitItem</a></li><li><a href="global.html#fromRpcWindow">fromRpcWindow</a></li><li><a href="global.html#fromTopField">fromTopField</a></li><li><a href="global.html#fromWindow">fromWindow</a></li><li><a href="global.html#getCliArgs">getCliArgs</a></li><li><a href="global.html#getErrorResult">getErrorResult</a></li><li><a href="global.html#getErrorType">getErrorType</a></li><li><a href="global.html#getQuotaAntigravity">getQuotaAntigravity</a></li><li><a href="global.html#getQuotaClaude">getQuotaClaude</a></li><li><a href="global.html#getQuotaCodex">getQuotaCodex</a></li><li><a href="global.html#initState">initState</a></li><li><a href="global.html#isKeyIndependentFail">isKeyIndependentFail</a></li><li><a href="global.html#pickWindow">pickWindow</a></li><li><a href="global.html#readBodyCapped">readBodyCapped</a></li><li><a href="global.html#readEnvFile">readEnvFile</a></li><li><a href="global.html#readJsonOrNull">readJsonOrNull</a></li><li><a href="global.html#redactText">redactText</a></li><li><a href="global.html#reorderByCooling">reorderByCooling</a></li><li><a href="global.html#resolveProviders">resolveProviders</a></li><li><a href="global.html#runFanout">runFanout</a></li><li><a href="global.html#runFanoutPipeline">runFanoutPipeline</a></li><li><a href="global.html#runRolePipeline">runRolePipeline</a></li><li><a href="global.html#salvageTruncatedArray">salvageTruncatedArray</a></li><li><a href="global.html#toQuotaLabel">toQuotaLabel</a></li><li><a href="global.html#toQuotaResult">toQuotaResult</a></li><li><a href="global.html#toQuotaScopedLabel">toQuotaScopedLabel</a></li><li><a href="global.html#toQuotaWindow">toQuotaWindow</a></li><li><a href="global.html#viaAppServer">viaAppServer</a></li><li><a href="global.html#viaHttp">viaHttp</a></li><li><a href="global.html#windowToSeconds">windowToSeconds</a></li></ul>
     
 </nav>
 
@@ -220,7 +220,7 @@ callAiWithFallback預設自動掛上(傳promptPrefix:''關閉)，
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WDispatchAi.mjs.html">WDispatchAi.mjs</a>, <a href="WDispatchAi.mjs.html#line46">line 46</a>
+        <a href="WDispatchAi.mjs.html">WDispatchAi.mjs</a>, <a href="WDispatchAi.mjs.html#line47">line 47</a>
     </li></ul></dd>
     
 
@@ -271,7 +271,7 @@ callAiWithFallback預設自動掛上(傳promptPrefix:''關閉)，
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>詳見dispatchAi、dispatchAiFallback、dispatchAiWkf、dispatchOpencode、dispatchClaude、dispatchCodex、dispatchAntigravity、dispatchApiOpenaiCompat、dispatchApiOpenaiResponses、resolveProviders、getQuotaClaude、getQuotaCodex、getQuotaAntigravity範例</code></pre>
+    <pre class="prettyprint"><code>詳見dispatchAi、dispatchAiFallback、dispatchAiWkf、dispatchOpencode、dispatchClaude、dispatchCodex、dispatchAntigravity、dispatchApiOpenaiCompat、dispatchApiOpenaiResponses、dispatchApiTypesafeSystemone、resolveProviders、getQuotaClaude、getQuotaCodex、getQuotaAntigravity範例</code></pre>
 
 
 
@@ -294,7 +294,7 @@ callAiWithFallback預設自動掛上(傳promptPrefix:''關閉)，
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="adapters.mjs.html">adapters.mjs</a>, <a href="adapters.mjs.html#line58">line 58</a>
+        <a href="adapters.mjs.html">adapters.mjs</a>, <a href="adapters.mjs.html#line64">line 64</a>
     </li></ul></dd>
     
 
@@ -350,7 +350,7 @@ callAiWithFallback預設自動掛上(傳promptPrefix:''關閉)，
     <pre class="prettyprint"><code>import adapters from './src/adapters.mjs'
 
 console.log(Object.keys(adapters))
-// => ['opencode', 'claude', 'codex', 'antigravity', 'api-openai-compat', 'api-openai-responses']</code></pre>
+// => ['opencode', 'claude', 'codex', 'antigravity', 'api-openai-compat', 'api-openai-responses', 'api-typesafe-systemone']</code></pre>
 
 
 
@@ -737,7 +737,7 @@ console.log(dfTimeoutMs)
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="getErrorType.mjs.html">getErrorType.mjs</a>, <a href="getErrorType.mjs.html#line89">line 89</a>
+        <a href="getErrorType.mjs.html">getErrorType.mjs</a>, <a href="getErrorType.mjs.html#line90">line 90</a>
     </li></ul></dd>
     
 
@@ -2776,7 +2776,7 @@ await test()
 
     
 
-    <h4 class="name" id="castPintOr"><span class="type-signature"></span>castPintOr<span class="signature">(v, df)</span><span class="type-signature"> &rarr; {Number|*}</span></h4>
+    <h4 class="name" id="callOnce"><span class="type-signature type-signature-async">(async) </span>callOnce<span class="signature">(url, headers, body, ids, timeoutMs, validator)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
 
     
 
@@ -2786,16 +2786,13 @@ await test()
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>正整數正規化：有效正整數即轉整數回傳，否則回傳預設值</p>
-<p>本套件各層之數值設定(timeoutMs、budgetMs、minAttemptMs、cooldownMs、retryDelayMs等)
-皆採同一寬容策略「無效即靜默回退預設」，統一收斂於此，
-避免同一7行判斷區塊散落各轉接器(曾重複6處)</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>單次HTTP呼叫(內部使用, 不含重試邏輯)</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="castPintOr.mjs.html">castPintOr.mjs</a>, <a href="castPintOr.mjs.html#line29">line 29</a>
+        <a href="dispatchApiTypesafeSystemone.mjs.html">dispatchApiTypesafeSystemone.mjs</a>, <a href="dispatchApiTypesafeSystemone.mjs.html#line78">line 78</a>
     </li></ul></dd>
     
 
@@ -2840,20 +2837,6 @@ await test()
 
 
 
-    <h5 class="h5-examples">Example</h5>
-    
-    <pre class="prettyprint"><code>import castPintOr from './src/castPintOr.mjs'
-
-console.log(castPintOr(5000, 300000))
-// => 5000
-
-console.log(castPintOr('abc', 300000))
-// => 300000
-
-console.log(castPintOr(undefined, null))
-// => null</code></pre>
-
-
 
 
     <h5 class="h5-parameters">Parameters:</h5>
@@ -2881,13 +2864,13 @@ console.log(castPintOr(undefined, null))
 
         <tr>
             
-                <td class="name"><code>v</code></td>
+                <td class="name"><code>url</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">*</span>
+<span class="param-type">String</span>
 
 
 
@@ -2898,20 +2881,20 @@ console.log(castPintOr(undefined, null))
 
             
 
-            <td class="description last"><p>輸入待正規化之值</p></td>
+            <td class="description last"><p>輸入完整端點網址字串</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>df</code></td>
+                <td class="name"><code>headers</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">*</span>
+<span class="param-type">Object</span>
 
 
 
@@ -2922,7 +2905,106 @@ console.log(castPintOr(undefined, null))
 
             
 
-            <td class="description last"><p>輸入無效時之預設值(可為null代表不限)</p></td>
+            <td class="description last"><p>輸入請求標頭物件</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>body</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入請求本體物件</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>ids</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Array</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入請求之題目id陣列，用於檢核回應是否每題皆有答案</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>timeoutMs</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Number</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入逾時毫秒</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>validator</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">function</span>
+|
+
+<span class="param-type">null</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入驗證函式</p></td>
         </tr>
 
     
@@ -2948,7 +3030,7 @@ console.log(castPintOr(undefined, null))
 
         
 <div class="param-desc">
-    <p>回傳正規化後之正整數，v非有效正整數時回傳df</p>
+    <p>回傳Promise，resolve回傳結果物件</p>
 </div>
 
 
@@ -2959,10 +3041,7 @@ console.log(castPintOr(undefined, null))
     </dt>
     <dd>
         
-<span class="param-type">Number</span>
-|
-
-<span class="param-type">*</span>
+<span class="param-type">Promise</span>
 
 
 
@@ -2978,7 +3057,7 @@ console.log(castPintOr(undefined, null))
 
     
 
-    <h4 class="name" id="collectAdditional"><span class="type-signature"></span>collectAdditional<span class="signature">(data)</span><span class="type-signature"> &rarr; {Array}</span></h4>
+    <h4 class="name" id="castPintOr"><span class="type-signature"></span>castPintOr<span class="signature">(v, df)</span><span class="type-signature"> &rarr; {Number|*}</span></h4>
 
     
 
@@ -2988,13 +3067,16 @@ console.log(castPintOr(undefined, null))
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>取出additional_rate_limits之集合並統一為陣列</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>正整數正規化：有效正整數即轉整數回傳，否則回傳預設值</p>
+<p>本套件各層之數值設定(timeoutMs、budgetMs、minAttemptMs、cooldownMs、retryDelayMs等)
+皆採同一寬容策略「無效即靜默回退預設」，統一收斂於此，
+避免同一7行判斷區塊散落各轉接器(曾重複6處)</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="quota_fromCodexUsageHttp.mjs.html">quota/fromCodexUsageHttp.mjs</a>, <a href="quota_fromCodexUsageHttp.mjs.html#line79">line 79</a>
+        <a href="castPintOr.mjs.html">castPintOr.mjs</a>, <a href="castPintOr.mjs.html#line29">line 29</a>
     </li></ul></dd>
     
 
@@ -3039,6 +3121,20 @@ console.log(castPintOr(undefined, null))
 
 
 
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>import castPintOr from './src/castPintOr.mjs'
+
+console.log(castPintOr(5000, 300000))
+// => 5000
+
+console.log(castPintOr('abc', 300000))
+// => 300000
+
+console.log(castPintOr(undefined, null))
+// => null</code></pre>
+
+
 
 
     <h5 class="h5-parameters">Parameters:</h5>
@@ -3066,13 +3162,13 @@ console.log(castPintOr(undefined, null))
 
         <tr>
             
-                <td class="name"><code>data</code></td>
+                <td class="name"><code>v</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type">*</span>
 
 
 
@@ -3083,7 +3179,31 @@ console.log(castPintOr(undefined, null))
 
             
 
-            <td class="description last"><p>輸入回應物件</p></td>
+            <td class="description last"><p>輸入待正規化之值</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>df</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">*</span>
+
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入無效時之預設值(可為null代表不限)</p></td>
         </tr>
 
     
@@ -3109,7 +3229,7 @@ console.log(castPintOr(undefined, null))
 
         
 <div class="param-desc">
-    <p>回傳單筆物件陣列, 無則[]</p>
+    <p>回傳正規化後之正整數，v非有效正整數時回傳df</p>
 </div>
 
 
@@ -3120,7 +3240,10 @@ console.log(castPintOr(undefined, null))
     </dt>
     <dd>
         
-<span class="param-type">Array</span>
+<span class="param-type">Number</span>
+|
+
+<span class="param-type">*</span>
 
 
 
@@ -3136,7 +3259,7 @@ console.log(castPintOr(undefined, null))
 
     
 
-    <h4 class="name" id="createFileStore"><span class="type-signature"></span>createFileStore<span class="signature">(opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Object}</span></h4>
+    <h4 class="name" id="collectAdditional"><span class="type-signature"></span>collectAdditional<span class="signature">(data)</span><span class="type-signature"> &rarr; {Array}</span></h4>
 
     
 
@@ -3146,18 +3269,13 @@ console.log(castPintOr(undefined, null))
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>建立dispatchAiFallback之store的檔案持久化(游標與冷卻跨行程有效)</p>
-<p>特點：
-採排除式passthrough——state原封存還，僅剔除本層自用欄位(預設只有at：人讀的最後更新時間戳)，
-日後套件擴充state欄位(如cooling)即自動相容，不需改本函數；
-檔案不存在或非法JSON時get回空物件(套件視為全新狀態)；
-stamp可注入時間戳函數(排程環境建議注入時區錨定者)，寫入時補進at欄位供人工debug</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>取出additional_rate_limits之集合並統一為陣列</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="wkf_createFileStore.mjs.html">wkf/createFileStore.mjs</a>, <a href="wkf_createFileStore.mjs.html#line56">line 56</a>
+        <a href="quota_fromCodexUsageHttp.mjs.html">quota/fromCodexUsageHttp.mjs</a>, <a href="quota_fromCodexUsageHttp.mjs.html#line79">line 79</a>
     </li></ul></dd>
     
 
@@ -3202,15 +3320,6 @@ stamp可注入時間戳函數(排程環境建議注入時區錨定者)，寫入
 
 
 
-    <h5 class="h5-examples">Example</h5>
-    
-    <pre class="prettyprint"><code>import createFileStore from './src/wkf/createFileStore.mjs'
-import dispatchAiFallback from './src/dispatchAiFallback.mjs'
-
-let store = createFileStore({ dir: './state' })
-//let r = await dispatchAiFallback(prompt, { providers, store, cooldownMs: 3600000 })</code></pre>
-
-
 
 
     <h5 class="h5-parameters">Parameters:</h5>
@@ -3226,12 +3335,8 @@ let store = createFileStore({ dir: './state' })
         <th>Type</th>
 
         
-        <th>Attributes</th>
-        
 
         
-        <th>Default</th>
-        
 
         <th class="last">Description</th>
     </tr>
@@ -3242,7 +3347,7 @@ let store = createFileStore({ dir: './state' })
 
         <tr>
             
-                <td class="name"><code>opt</code></td>
+                <td class="name"><code>data</code></td>
             
 
             <td class="type">
@@ -3256,41 +3361,217 @@ let store = createFileStore({ dir: './state' })
             </td>
 
             
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
 
-                
-                </td>
             
 
-            
-                <td class="default">
-                
-                    <code>{}</code>
-                
-                </td>
-            
+            <td class="description last"><p>輸入回應物件</p></td>
+        </tr>
 
-            <td class="description last"><p>輸入設定物件，預設{}</p>
-                <h6>Properties</h6>
-                
+    
+    </tbody>
+</table>
 
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Name</th>
-        
 
-        <th>Type</th>
 
-        
-        <th>Attributes</th>
-        
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳單筆物件陣列, 無則[]</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Array</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="createFileStore"><span class="type-signature"></span>createFileStore<span class="signature">(opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Object}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>建立dispatchAiFallback之store的檔案持久化(游標與冷卻跨行程有效)</p>
+<p>特點：
+採排除式passthrough——state原封存還，僅剔除本層自用欄位(預設只有at：人讀的最後更新時間戳)，
+日後套件擴充state欄位(如cooling)即自動相容，不需改本函數；
+檔案不存在或非法JSON時get回空物件(套件視為全新狀態)；
+stamp可注入時間戳函數(排程環境建議注入時區錨定者)，寫入時補進at欄位供人工debug</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="wkf_createFileStore.mjs.html">wkf/createFileStore.mjs</a>, <a href="wkf_createFileStore.mjs.html#line56">line 56</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>import createFileStore from './src/wkf/createFileStore.mjs'
+import dispatchAiFallback from './src/dispatchAiFallback.mjs'
+
+let store = createFileStore({ dir: './state' })
+//let r = await dispatchAiFallback(prompt, { providers, store, cooldownMs: 3600000 })</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>opt</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入設定物件，預設{}</p>
+                <h6>Properties</h6>
+                
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
 
         
         <th>Default</th>
@@ -6095,7 +6376,728 @@ agy自身之--print-timeout未給時由timeoutMs推導並預留30秒緩衝，令
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="dispatchAntigravity.mjs.html">dispatchAntigravity.mjs</a>, <a href="dispatchAntigravity.mjs.html#line106">line 106</a>
+        <a href="dispatchAntigravity.mjs.html">dispatchAntigravity.mjs</a>, <a href="dispatchAntigravity.mjs.html#line106">line 106</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>//need agy cli in system PATH, and OAuth login completed
+
+import dispatchAntigravity from './src/dispatchAntigravity.mjs'
+
+let test = async () => {
+
+    let r = await dispatchAntigravity('請只回覆兩個字：完成', { model: 'gemini-3.6-flash-low' })
+    console.log(r.ok, r.stdout.trim())
+    // => true 完成
+
+    //基礎slug搭配effort(不可用帶檔位之slug併用effort)
+    let r2 = await dispatchAntigravity('請只回覆兩個字：完成', { model: 'gemini-3.1-pro', effort: 'low' })
+    console.log(r2.ok)
+    // => true
+
+    let re = await dispatchAntigravity('')
+    console.log(re.ok, re.error)
+    // => false 'prompt must be a non-empty string'
+
+}
+await test()
+    .catch((err) => {
+        console.log(err)
+    })</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>prompt</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入提示詞字串，作為<code>--print</code>旗標之值傳遞，長度上限30000字元</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>opt</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入設定物件，預設{}</p>
+                <h6>Properties</h6>
+                
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>exe</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>'agy'</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入agy執行檔名稱或絕對路徑字串，命令名為agy非antigravity，給予名稱時由execCli自系統PATH解析，預設'agy'</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>model</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>''</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入模型slug字串，須為<code>agy models</code>第一欄之slug，例如'gemini-3.6-flash-low'、'gemini-3.1-pro-high'，預設''代表不帶<code>--model</code>旗標由agy自行決定</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>effort</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>''</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入推理深度字串，可選'low'、'medium'、'high'，需agy&gt;=1.1.11，建議搭配不帶檔位之基礎slug；與帶檔位slug併用且檔位不一致時agy回conflicts錯誤，預設''代表不帶</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>skipPermissions</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Boolean</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>true</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入是否帶<code>--dangerously-skip-permissions</code>旗標布林值，false代表保留CLI權限閘門，預設true</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>printTimeout</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>''</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入agy自身等待上限字串(如'10m'、'570s')，預設''代表由timeoutMs推導(扣30秒緩衝，下限30秒)</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>addDirs</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Array</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>自動納入cwd</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入加入workspace之目錄字串陣列，逐項展開為<code>--add-dir</code>。agy以自身scratch目錄為工作區而不採子進程cwd，故未給本參數時自動納入有效cwd令檔案可視範圍與其他CLI轉接器一致；明示給陣列(含空陣列[]代表不揭露任何目錄)則完全尊重呼叫端</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>extraArgs</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Array</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>[]</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入額外命令列旗標字串陣列(如--output-format、--json-schema、--mode)，將接於固定旗標之後、<code>--print</code>之前，預設[]</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>timeoutMs</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Number</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>300000</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入逾時毫秒正整數，逾時將強制關閉子進程及其子孫程序，全套件統一預設300000(恰對齊agy自身print-timeout預設5m0s)</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>cwd</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>process.cwd()</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入子進程工作目錄字串，預設process.cwd()。注意本參數不影響agy之檔案可視範圍(agy以自身scratch目錄為工作區)，可視範圍由addDirs決定(未給addDirs時自動納入本目錄)</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>validate</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+|
+
+<span class="param-type">function</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入stdout驗證規則字串或自訂驗證函數，規則字串支援'nonempty'、'json'、'min:100'，多規則可用逗號串接，預設undefined代表不驗證</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>maxRetries</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Number</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>0</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入失敗後最大重試次數非負整數，預設0</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+            </td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(標準輸出字串)、stderr(標準錯誤字串)、code(離開碼)、error(錯誤訊息字串，成功時為空字串)、durationMs(耗時毫秒)、attempts(實際嘗試次數)，本函數不會reject</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Promise</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="dispatchApiOpenaiCompat"><span class="type-signature type-signature-async">(async) </span>dispatchApiOpenaiCompat<span class="signature">(prompt, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>以fetch直呼OpenAI相容API(chat/completions)呼叫AI模型</p>
+<p>特點：
+免安裝CLI、免預先登入，給baseURL＋key＋model即可呼叫(如OpenCode Zen、Agnes等OpenAI相容閘道)；
+僅供純文字生成(摘要、分析、改寫、產出JSON等素材已在prompt內之任務)——
+需要讀本機檔案、grep、執行指令、抓網頁等工具能力時，請改用CLI類kind(opencode/claude/codex/antigravity)；
+prompt走HTTP body，無命令列長度限制；
+錯誤依HTTP狀態碼分流：4xx(429除外)為客戶端錯誤不重試，429/5xx/網路錯誤/逾時依maxRetries線性退避重試；
+結果結構與逾時/驗證失敗之error字樣對齊execCli，可直接作為dispatchAi與dispatchAiFallback之kind('api-openai-compat')使用；
+本函數不會reject，一律以結果物件之ok與error欄位回報成敗</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="dispatchApiOpenaiCompat.mjs.html">dispatchApiOpenaiCompat.mjs</a>, <a href="dispatchApiOpenaiCompat.mjs.html#line261">line 261</a>
     </li></ul></dd>
     
 
@@ -6142,24 +7144,33 @@ agy自身之--print-timeout未給時由timeoutMs推導並預留30秒緩衝，令
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>//need agy cli in system PATH, and OAuth login completed
+    <pre class="prettyprint"><code>//need network, no cli required
 
-import dispatchAntigravity from './src/dispatchAntigravity.mjs'
+import dispatchApiOpenaiCompat from './src/dispatchApiOpenaiCompat.mjs'
 
 let test = async () => {
 
-    let r = await dispatchAntigravity('請只回覆兩個字：完成', { model: 'gemini-3.6-flash-low' })
-    console.log(r.ok, r.stdout.trim())
+    //OpenCode Zen(即opencode CLI之自家閘道), 模型名不帶opencode/前綴
+    let r1 = await dispatchApiOpenaiCompat('請只回覆兩個字：完成', {
+        baseURL: 'https://opencode.ai/zen/v1',
+        key: 'sk-xxxxxx',
+        model: 'deepseek-v4-flash-free',
+    })
+    console.log(r1.ok, r1.stdout.trim())
     // => true 完成
 
-    //基礎slug搭配effort(不可用帶檔位之slug併用effort)
-    let r2 = await dispatchAntigravity('請只回覆兩個字：完成', { model: 'gemini-3.1-pro', effort: 'low' })
-    console.log(r2.ok)
-    // => true
+    //Agnes
+    let r2 = await dispatchApiOpenaiCompat('請只回覆兩個字：完成', {
+        baseURL: 'https://apihub.agnes-ai.com/v1',
+        key: 'sk-xxxxxx',
+        model: 'agnes-2.0-flash',
+    })
+    console.log(r2.ok, r2.stdout.trim())
+    // => true 完成
 
-    let re = await dispatchAntigravity('')
-    console.log(re.ok, re.error)
-    // => false 'prompt must be a non-empty string'
+    let re = await dispatchApiOpenaiCompat('abc', { baseURL: 'https://opencode.ai/zen/v1', key: 'sk-bad', model: 'deepseek-v4-flash-free' })
+    console.log(re.ok, re.code, re.error)
+    // => false 401 HTTP 401
 
 }
 await test()
@@ -6228,7 +7239,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入提示詞字串，作為<code>--print</code>旗標之值傳遞，長度上限30000字元</p></td>
+            <td class="description last"><p>輸入提示詞字串，作為user訊息置於HTTP body</p></td>
         </tr>
 
     
@@ -6298,7 +7309,7 @@ await test()
 
         <tr>
             
-                <td class="name"><code>exe</code></td>
+                <td class="name"><code>baseURL</code></td>
             
 
             <td class="type">
@@ -6314,8 +7325,6 @@ await test()
             
                 <td class="attributes">
                 
-                    &lt;optional><br>
-                
 
                 
 
@@ -6326,12 +7335,10 @@ await test()
             
                 <td class="default">
                 
-                    <code>'agy'</code>
-                
                 </td>
             
 
-            <td class="description last"><p>輸入agy執行檔名稱或絕對路徑字串，命令名為agy非antigravity，給予名稱時由execCli自系統PATH解析，預設'agy'</p></td>
+            <td class="description last"><p>輸入API基底網址字串，例如'https://opencode.ai/zen/v1'、'https://apihub.agnes-ai.com/v1'，將於尾端接上/chat/completions</p></td>
         </tr>
 
     
@@ -6354,8 +7361,6 @@ await test()
             
                 <td class="attributes">
                 
-                    &lt;optional><br>
-                
 
                 
 
@@ -6366,19 +7371,17 @@ await test()
             
                 <td class="default">
                 
-                    <code>''</code>
-                
                 </td>
             
 
-            <td class="description last"><p>輸入模型slug字串，須為<code>agy models</code>第一欄之slug，例如'gemini-3.6-flash-low'、'gemini-3.1-pro-high'，預設''代表不帶<code>--model</code>旗標由agy自行決定</p></td>
+            <td class="description last"><p>輸入模型ID字串，例如'deepseek-v4-flash-free'(Zen之模型名不帶opencode/前綴)、'agnes-2.0-flash'</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>effort</code></td>
+                <td class="name"><code>key</code></td>
             
 
             <td class="type">
@@ -6411,54 +7414,14 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入推理深度字串，可選'low'、'medium'、'high'，需agy&gt;=1.1.11，建議搭配不帶檔位之基礎slug；與帶檔位slug併用且檔位不一致時agy回conflicts錯誤，預設''代表不帶</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>skipPermissions</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">Boolean</span>
-
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                    <code>true</code>
-                
-                </td>
-            
-
-            <td class="description last"><p>輸入是否帶<code>--dangerously-skip-permissions</code>旗標布林值，false代表保留CLI權限閘門，預設true</p></td>
+            <td class="description last"><p>輸入API key字串，以Bearer置於Authorization標頭，預設''代表不帶認證標頭</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>printTimeout</code></td>
+                <td class="name"><code>system</code></td>
             
 
             <td class="type">
@@ -6491,20 +7454,20 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入agy自身等待上限字串(如'10m'、'570s')，預設''代表由timeoutMs推導(扣30秒緩衝，下限30秒)</p></td>
+            <td class="description last"><p>輸入system提示詞字串，將以system角色置於messages首位，預設''代表不帶</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>addDirs</code></td>
+                <td class="name"><code>body</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Array</span>
+<span class="param-type">Object</span>
 
 
 
@@ -6526,25 +7489,25 @@ await test()
             
                 <td class="default">
                 
-                    <code>自動納入cwd</code>
+                    <code>{}</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入加入workspace之目錄字串陣列，逐項展開為<code>--add-dir</code>。agy以自身scratch目錄為工作區而不採子進程cwd，故未給本參數時自動納入有效cwd令檔案可視範圍與其他CLI轉接器一致；明示給陣列(含空陣列[]代表不揭露任何目錄)則完全尊重呼叫端</p></td>
+            <td class="description last"><p>輸入額外請求本體物件(如temperature、max_tokens、response_format)，將併入預設body(同名鍵以此為準)，預設{}。注意本轉接器不支援工具，帶入tools而模型回tool_calls時一律以TOOL_CALLS_UNSUPPORTED回報失敗，需要工具請改用CLI類kind</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>extraArgs</code></td>
+                <td class="name"><code>headers</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Array</span>
+<span class="param-type">Object</span>
 
 
 
@@ -6566,12 +7529,12 @@ await test()
             
                 <td class="default">
                 
-                    <code>[]</code>
+                    <code>{}</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入額外命令列旗標字串陣列(如--output-format、--json-schema、--mode)，將接於固定旗標之後、<code>--print</code>之前，預設[]</p></td>
+            <td class="description last"><p>輸入額外請求標頭物件，預設{}</p></td>
         </tr>
 
     
@@ -6611,20 +7574,23 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入逾時毫秒正整數，逾時將強制關閉子進程及其子孫程序，全套件統一預設300000(恰對齊agy自身print-timeout預設5m0s)</p></td>
+            <td class="description last"><p>輸入逾時毫秒正整數，逾時將中止請求(含回應串流讀取)，全套件統一預設300000</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>cwd</code></td>
+                <td class="name"><code>validate</code></td>
             
 
             <td class="type">
             
                 
 <span class="param-type">String</span>
+|
+
+<span class="param-type">function</span>
 
 
 
@@ -6646,28 +7612,23 @@ await test()
             
                 <td class="default">
                 
-                    <code>process.cwd()</code>
-                
                 </td>
             
 
-            <td class="description last"><p>輸入子進程工作目錄字串，預設process.cwd()。注意本參數不影響agy之檔案可視範圍(agy以自身scratch目錄為工作區)，可視範圍由addDirs決定(未給addDirs時自動納入本目錄)</p></td>
+            <td class="description last"><p>輸入回覆內容驗證規則字串或自訂驗證函數，規則字串支援'nonempty'、'json'、'min:100'，多規則可用逗號串接，預設undefined代表不驗證</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>validate</code></td>
+                <td class="name"><code>maxRetries</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
-|
-
-<span class="param-type">function</span>
+<span class="param-type">Number</span>
 
 
 
@@ -6689,17 +7650,19 @@ await test()
             
                 <td class="default">
                 
+                    <code>0</code>
+                
                 </td>
             
 
-            <td class="description last"><p>輸入stdout驗證規則字串或自訂驗證函數，規則字串支援'nonempty'、'json'、'min:100'，多規則可用逗號串接，預設undefined代表不驗證</p></td>
+            <td class="description last"><p>輸入失敗後最大重試次數非負整數，4xx(429除外)不重試，預設0</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>maxRetries</code></td>
+                <td class="name"><code>retryDelayMs</code></td>
             
 
             <td class="type">
@@ -6727,12 +7690,12 @@ await test()
             
                 <td class="default">
                 
-                    <code>0</code>
+                    <code>5000</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入失敗後最大重試次數非負整數，預設0</p></td>
+            <td class="description last"><p>輸入重試間隔毫秒正整數，實際間隔為retryDelayMs乘以重試次數且上限15000ms，預設5000</p></td>
         </tr>
 
     
@@ -6765,7 +7728,7 @@ await test()
 
         
 <div class="param-desc">
-    <p>回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(標準輸出字串)、stderr(標準錯誤字串)、code(離開碼)、error(錯誤訊息字串，成功時為空字串)、durationMs(耗時毫秒)、attempts(實際嘗試次數)，本函數不會reject</p>
+    <p>回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(回覆內容字串)、stderr(失敗時之原始回應本體)、code(HTTP狀態碼，網路錯誤與逾時為null)、error(錯誤訊息字串，成功時為空字串)、errorType(僅失敗時，機器可讀錯誤類別字串，一覽見getErrorType.mjs檔頭)、durationMs(耗時毫秒)、attempts(實際嘗試次數)、usage(原始回應之token用量物件原樣透傳，無則null)，本函數不會reject</p>
 </div>
 
 
@@ -6792,7 +7755,7 @@ await test()
 
     
 
-    <h4 class="name" id="dispatchApiOpenaiCompat"><span class="type-signature type-signature-async">(async) </span>dispatchApiOpenaiCompat<span class="signature">(prompt, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+    <h4 class="name" id="dispatchApiOpenaiResponses"><span class="type-signature type-signature-async">(async) </span>dispatchApiOpenaiResponses<span class="signature">(prompt, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
 
     
 
@@ -6802,21 +7765,21 @@ await test()
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>以fetch直呼OpenAI相容API(chat/completions)呼叫AI模型</p>
+    <dd class="tag-description"><ul class="dummy"><li><p>以fetch直呼OpenAI Responses API(/responses)呼叫AI模型</p>
 <p>特點：
-免安裝CLI、免預先登入，給baseURL＋key＋model即可呼叫(如OpenCode Zen、Agnes等OpenAI相容閘道)；
-僅供純文字生成(摘要、分析、改寫、產出JSON等素材已在prompt內之任務)——
-需要讀本機檔案、grep、執行指令、抓網頁等工具能力時，請改用CLI類kind(opencode/claude/codex/antigravity)；
-prompt走HTTP body，無命令列長度限制；
-錯誤依HTTP狀態碼分流：4xx(429除外)為客戶端錯誤不重試，429/5xx/網路錯誤/逾時依maxRetries線性退避重試；
-結果結構與逾時/驗證失敗之error字樣對齊execCli，可直接作為dispatchAi與dispatchAiFallback之kind('api-openai-compat')使用；
+免安裝CLI、免預先登入，給baseURL＋key＋model即可呼叫(如OpenCode Zen之muse-spark系與GPT系)；
+端點型別與dispatchApiOpenaiCompat不同——Zen之端點依模型家族而異，收錄前須查官方文件端點欄
+(https://opencode.ai/docs/zh-tw/zen/)，打錯端點會得到HTTP 500而非404，詳見providers.mjs檔頭；
+僅供純文字生成，需要工具能力請改用CLI類kind(opencode/claude/codex/antigravity)；
+status非completed(如max_output_tokens耗盡)一律以INCOMPLETE_RESPONSE回報，不回半截內容；
+結果結構與dispatchApiOpenaiCompat完全一致，可直接作為dispatchAi與dispatchAiFallback之kind('api-openai-responses')使用；
 本函數不會reject，一律以結果物件之ok與error欄位回報成敗</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="dispatchApiOpenaiCompat.mjs.html">dispatchApiOpenaiCompat.mjs</a>, <a href="dispatchApiOpenaiCompat.mjs.html#line261">line 261</a>
+        <a href="dispatchApiOpenaiResponses.mjs.html">dispatchApiOpenaiResponses.mjs</a>, <a href="dispatchApiOpenaiResponses.mjs.html#line322">line 322</a>
     </li></ul></dd>
     
 
@@ -6865,31 +7828,22 @@ prompt走HTTP body，無命令列長度限制；
     
     <pre class="prettyprint"><code>//need network, no cli required
 
-import dispatchApiOpenaiCompat from './src/dispatchApiOpenaiCompat.mjs'
+import dispatchApiOpenaiResponses from './src/dispatchApiOpenaiResponses.mjs'
 
 let test = async () => {
 
-    //OpenCode Zen(即opencode CLI之自家閘道), 模型名不帶opencode/前綴
-    let r1 = await dispatchApiOpenaiCompat('請只回覆兩個字：完成', {
+    //OpenCode Zen之muse-spark系走/responses(非chat/completions), 詳見providers.mjs檔頭
+    let r = await dispatchApiOpenaiResponses('請只回覆兩個字：完成', {
         baseURL: 'https://opencode.ai/zen/v1',
         key: 'sk-xxxxxx',
-        model: 'deepseek-v4-flash-free',
-    })
-    console.log(r1.ok, r1.stdout.trim())
-    // => true 完成
-
-    //Agnes
-    let r2 = await dispatchApiOpenaiCompat('請只回覆兩個字：完成', {
-        baseURL: 'https://apihub.agnes-ai.com/v1',
-        key: 'sk-xxxxxx',
-        model: 'agnes-2.0-flash',
+        model: 'muse-spark-1.3-contributor-free',
     })
-    console.log(r2.ok, r2.stdout.trim())
+    console.log(r.ok, r.stdout.trim())
     // => true 完成
 
-    let re = await dispatchApiOpenaiCompat('abc', { baseURL: 'https://opencode.ai/zen/v1', key: 'sk-bad', model: 'deepseek-v4-flash-free' })
-    console.log(re.ok, re.code, re.error)
-    // => false 401 HTTP 401
+    let re = await dispatchApiOpenaiResponses('abc', { baseURL: 'https://opencode.ai/zen/v1', key: 'sk-bad', model: 'muse-spark-1.3-contributor-free' })
+    console.log(re.ok, re.code, re.errorType)
+    // => false 401 http
 
 }
 await test()
@@ -6958,7 +7912,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入提示詞字串，作為user訊息置於HTTP body</p></td>
+            <td class="description last"><p>輸入提示詞字串，作為input置於HTTP body</p></td>
         </tr>
 
     
@@ -7057,7 +8011,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入API基底網址字串，例如'https://opencode.ai/zen/v1'、'https://apihub.agnes-ai.com/v1'，將於尾端接上/chat/completions</p></td>
+            <td class="description last"><p>輸入API基底網址字串，例如'https://opencode.ai/zen/v1'，將於尾端接上/responses</p></td>
         </tr>
 
     
@@ -7093,7 +8047,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入模型ID字串，例如'deepseek-v4-flash-free'(Zen之模型名不帶opencode/前綴)、'agnes-2.0-flash'</p></td>
+            <td class="description last"><p>輸入模型ID字串，例如'muse-spark-1.3-contributor-free'</p></td>
         </tr>
 
     
@@ -7173,7 +8127,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入system提示詞字串，將以system角色置於messages首位，預設''代表不帶</p></td>
+            <td class="description last"><p>輸入system提示詞字串，將置於instructions欄位(Responses API之system管道)，預設''代表不帶</p></td>
         </tr>
 
     
@@ -7213,7 +8167,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入額外請求本體物件(如temperature、max_tokens、response_format)，將併入預設body(同名鍵以此為準)，預設{}。注意本轉接器不支援工具，帶入tools而模型回tool_calls時一律以TOOL_CALLS_UNSUPPORTED回報失敗，需要工具請改用CLI類kind</p></td>
+            <td class="description last"><p>輸入額外請求本體物件(如temperature、max_output_tokens、reasoning)，將併入預設body(同名鍵以此為準)，預設{}。注意輸出上限欄位名為max_output_tokens而非max_tokens；本轉接器不支援工具，帶入tools而模型回function_call時一律以TOOL_CALLS_UNSUPPORTED回報失敗</p></td>
         </tr>
 
     
@@ -7447,7 +8401,7 @@ await test()
 
         
 <div class="param-desc">
-    <p>回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(回覆內容字串)、stderr(失敗時之原始回應本體)、code(HTTP狀態碼，網路錯誤與逾時為null)、error(錯誤訊息字串，成功時為空字串)、errorType(僅失敗時，機器可讀錯誤類別字串，一覽見getErrorType.mjs檔頭)、durationMs(耗時毫秒)、attempts(實際嘗試次數)、usage(原始回應之token用量物件原樣透傳，無則null)，本函數不會reject</p>
+    <p>回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(回覆內容字串)、stderr(失敗時之原始回應本體)、code(HTTP狀態碼，網路錯誤與逾時為null)、error(錯誤訊息字串，成功時為空字串)、errorType(僅失敗時，機器可讀錯誤類別字串，一覽見getErrorType.mjs檔頭)、durationMs(耗時毫秒)、attempts(實際嘗試次數)、usage(原始回應之token用量物件原樣透傳，欄位名為input_tokens/output_tokens/total_tokens，無則null)，本函數不會reject</p>
 </div>
 
 
@@ -7474,7 +8428,7 @@ await test()
 
     
 
-    <h4 class="name" id="dispatchApiOpenaiResponses"><span class="type-signature type-signature-async">(async) </span>dispatchApiOpenaiResponses<span class="signature">(prompt, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+    <h4 class="name" id="dispatchApiTypesafeSystemone"><span class="type-signature type-signature-async">(async) </span>dispatchApiTypesafeSystemone<span class="signature">(prompt, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
 
     
 
@@ -7484,21 +8438,21 @@ await test()
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>以fetch直呼OpenAI Responses API(/responses)呼叫AI模型</p>
+    <dd class="tag-description"><ul class="dummy"><li><p>以fetch直呼TypeSafe AI之System One API(POST /v1/systemone)，對prompt(即state)回答型別化問題</p>
 <p>特點：
-免安裝CLI、免預先登入，給baseURL＋key＋model即可呼叫(如OpenCode Zen之muse-spark系與GPT系)；
-端點型別與dispatchApiOpenaiCompat不同——Zen之端點依模型家族而異，收錄前須查官方文件端點欄
-(https://opencode.ai/docs/zh-tw/zen/)，打錯端點會得到HTTP 500而非404，詳見providers.mjs檔頭；
-僅供純文字生成，需要工具能力請改用CLI類kind(opencode/claude/codex/antigravity)；
-status非completed(如max_output_tokens耗盡)一律以INCOMPLETE_RESPONSE回報，不回半截內容；
-結果結構與dispatchApiOpenaiCompat完全一致，可直接作為dispatchAi與dispatchAiFallback之kind('api-openai-responses')使用；
+非文字生成——jev等System One模型對state回答呼叫端定義之questions(noul是非題、choice單選題、score量表)，
+每題回傳受限於選項之答案與機率；官方無CLI，僅此API路徑；
+prompt即state，結構化內容以JSON.stringify(物件)傳入(實測答案與物件state一致)；
+stdout為answers之JSON字串，另於結果追加answers(已解析物件)與modelResolved(實際模型版本)；
+請求之題目id於回應缺任一即以INVALID_RESPONSE回報；
+不可與文字生成條目混在同一條遞補鏈，經工作流callAi呼叫時須傳promptPrefix:''(理由見檔頭)；
 本函數不會reject，一律以結果物件之ok與error欄位回報成敗</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="dispatchApiOpenaiResponses.mjs.html">dispatchApiOpenaiResponses.mjs</a>, <a href="dispatchApiOpenaiResponses.mjs.html#line322">line 322</a>
+        <a href="dispatchApiTypesafeSystemone.mjs.html">dispatchApiTypesafeSystemone.mjs</a>, <a href="dispatchApiTypesafeSystemone.mjs.html#line270">line 270</a>
     </li></ul></dd>
     
 
@@ -7545,22 +8499,31 @@ status非completed(如max_output_tokens耗盡)一律以INCOMPLETE_RESPONSE回報
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>//need network, no cli required
+    <pre class="prettyprint"><code>//need network and a TypeSafe api key, no cli required
 
-import dispatchApiOpenaiResponses from './src/dispatchApiOpenaiResponses.mjs'
+import dispatchApiTypesafeSystemone from './src/dispatchApiTypesafeSystemone.mjs'
 
 let test = async () => {
 
-    //OpenCode Zen之muse-spark系走/responses(非chat/completions), 詳見providers.mjs檔頭
-    let r = await dispatchApiOpenaiResponses('請只回覆兩個字：完成', {
-        baseURL: 'https://opencode.ai/zen/v1',
-        key: 'sk-xxxxxx',
-        model: 'muse-spark-1.3-contributor-free',
+    let r = await dispatchApiTypesafeSystemone('房間浴室水龍頭一直滴水，吵到睡不著', {
+        key: 'apikey_xxxxxx',
+        questions: {
+            category: {
+                type: 'choice',
+                instructions: '這則客房訊息屬於哪一類?',
+                criteria: {
+                    '設備故障報修': '客人回報房間硬體設備損壞、水電問題或故障',
+                    '索取備品': '客人需要毛巾、牙刷、礦泉水等客房備品',
+                    '其他': null,
+                },
+            },
+            urgent: { type: 'noul', instructions: '客人是否表達急迫性?' },
+        },
     })
-    console.log(r.ok, r.stdout.trim())
-    // => true 完成
+    console.log(r.ok, r.answers.category.choice, r.answers.urgent.noul)
+    // => true 設備故障報修 0.86 (2026-09-17實測; noul為機率, 每次可能差0.01)
 
-    let re = await dispatchApiOpenaiResponses('abc', { baseURL: 'https://opencode.ai/zen/v1', key: 'sk-bad', model: 'muse-spark-1.3-contributor-free' })
+    let re = await dispatchApiTypesafeSystemone('abc', { key: 'apikey_bad', questions: { a: { type: 'noul', instructions: 'x?' } } })
     console.log(re.ok, re.code, re.errorType)
     // => false 401 http
 
@@ -7631,7 +8594,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入提示詞字串，作為input置於HTTP body</p></td>
+            <td class="description last"><p>輸入被評估之內容字串，作為state置於HTTP body，結構化內容請先JSON.stringify</p></td>
         </tr>
 
     
@@ -7701,13 +8664,13 @@ await test()
 
         <tr>
             
-                <td class="name"><code>baseURL</code></td>
+                <td class="name"><code>questions</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
 
@@ -7730,14 +8693,14 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入API基底網址字串，例如'https://opencode.ai/zen/v1'，將於尾端接上/responses</p></td>
+            <td class="description last"><p>輸入題目物件(必填且非空)，鍵為自訂題目id，值為{type:'noul'|'choice'|'score', instructions, criteria}，格式見檔頭與https://docs.typesafe.ai/api</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>model</code></td>
+                <td class="name"><code>baseURL</code></td>
             
 
             <td class="type">
@@ -7753,6 +8716,8 @@ await test()
             
                 <td class="attributes">
                 
+                    &lt;optional><br>
+                
 
                 
 
@@ -7763,17 +8728,19 @@ await test()
             
                 <td class="default">
                 
+                    <code>'https://api.typesafe.ai/v1'</code>
+                
                 </td>
             
 
-            <td class="description last"><p>輸入模型ID字串，例如'muse-spark-1.3-contributor-free'</p></td>
+            <td class="description last"><p>輸入API基底網址字串，將於尾端接上/systemone，預設官方端點</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>key</code></td>
+                <td class="name"><code>model</code></td>
             
 
             <td class="type">
@@ -7801,19 +8768,19 @@ await test()
             
                 <td class="default">
                 
-                    <code>''</code>
+                    <code>'jev-latest'</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入API key字串，以Bearer置於Authorization標頭，預設''代表不帶認證標頭</p></td>
+            <td class="description last"><p>輸入模型名稱字串，預設'jev-latest'(另有'jev-preview')</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>system</code></td>
+                <td class="name"><code>key</code></td>
             
 
             <td class="type">
@@ -7846,7 +8813,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入system提示詞字串，將置於instructions欄位(Responses API之system管道)，預設''代表不帶</p></td>
+            <td class="description last"><p>輸入API key字串，以Bearer置於Authorization標頭，預設''代表不帶認證標頭</p></td>
         </tr>
 
     
@@ -7886,7 +8853,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入額外請求本體物件(如temperature、max_output_tokens、reasoning)，將併入預設body(同名鍵以此為準)，預設{}。注意輸出上限欄位名為max_output_tokens而非max_tokens；本轉接器不支援工具，帶入tools而模型回function_call時一律以TOOL_CALLS_UNSUPPORTED回報失敗</p></td>
+            <td class="description last"><p>輸入額外請求本體物件，將併入預設body(同名鍵以此為準)，預設{}</p></td>
         </tr>
 
     
@@ -7966,7 +8933,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入逾時毫秒正整數，逾時將中止請求(含回應串流讀取)，全套件統一預設300000</p></td>
+            <td class="description last"><p>輸入逾時毫秒正整數，逾時將中止請求，全套件統一預設300000</p></td>
         </tr>
 
     
@@ -8007,7 +8974,7 @@ await test()
                 </td>
             
 
-            <td class="description last"><p>輸入回覆內容驗證規則字串或自訂驗證函數，規則字串支援'nonempty'、'json'、'min:100'，多規則可用逗號串接，預設undefined代表不驗證</p></td>
+            <td class="description last"><p>輸入stdout(answers之JSON字串)驗證規則字串或自訂驗證函數，規則字串支援'nonempty'、'json'、'min:100'，多規則可用逗號串接，預設undefined代表不驗證</p></td>
         </tr>
 
     
@@ -8120,7 +9087,7 @@ await test()
 
         
 <div class="param-desc">
-    <p>回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(回覆內容字串)、stderr(失敗時之原始回應本體)、code(HTTP狀態碼，網路錯誤與逾時為null)、error(錯誤訊息字串，成功時為空字串)、errorType(僅失敗時，機器可讀錯誤類別字串，一覽見getErrorType.mjs檔頭)、durationMs(耗時毫秒)、attempts(實際嘗試次數)、usage(原始回應之token用量物件原樣透傳，欄位名為input_tokens/output_tokens/total_tokens，無則null)，本函數不會reject</p>
+    <p>回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(answers之JSON字串)、stderr(失敗時之原始回應本體)、code(HTTP狀態碼，網路錯誤與逾時為null)、error(錯誤訊息字串，成功時為空字串)、errorType(僅失敗時，機器可讀錯誤類別字串，一覽見getErrorType.mjs檔頭)、durationMs(耗時毫秒)、attempts(實際嘗試次數)、usage(原始回應之token用量物件原樣透傳，欄位名為input_tokens/output_tokens，無則null)、answers(成功時為已解析之答案物件，否則null)、modelResolved(回應所載之實際模型版本字串，如'jev-1.13.0'，無則'')，本函數不會reject</p>
 </div>
 
 
@@ -12769,7 +13736,7 @@ console.log(getErrorResult(null).error)
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="getErrorType.mjs.html">getErrorType.mjs</a>, <a href="getErrorType.mjs.html#line55">line 55</a>
+        <a href="getErrorType.mjs.html">getErrorType.mjs</a>, <a href="getErrorType.mjs.html#line56">line 56</a>
     </li></ul></dd>
     
 
@@ -20411,7 +21378,7 @@ console.log(w.label, w.remainingPercent)
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Sep 14 2026 12:59:17 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Thu Sep 17 2026 13:48:00 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>