w-dispatch-ai 1.0.0

package/docs/styles/prettify.css

@@ -0,0 +1,80 @@
+.pln {
+  color: #ddd;
+}
+
+/* string content */
+.str {
+  color: #61ce3c;
+}
+
+/* a keyword */
+.kwd {
+  color: #fbde2d;
+}
+
+/* a comment */
+.com {
+  color: #aeaeae;
+}
+
+/* a type name */
+.typ {
+  color: #8da6ce;
+}
+
+/* a literal value */
+.lit {
+  color: #fbde2d;
+}
+
+/* punctuation */
+.pun {
+  color: #ddd;
+}
+
+/* lisp open bracket */
+.opn {
+  color: #000000;
+}
+
+/* lisp close bracket */
+.clo {
+  color: #000000;
+}
+
+/* a markup tag name */
+.tag {
+  color: #8da6ce;
+}
+
+/* a markup attribute name */
+.atn {
+  color: #fbde2d;
+}
+
+/* a markup attribute value */
+.atv {
+  color: #ddd;
+}
+
+/* a declaration */
+.dec {
+  color: #EF5050;
+}
+
+/* a variable name */
+.var {
+  color: #c82829;
+}
+
+/* a function name */
+.fun {
+  color: #4271ae;
+}
+
+/* Specify class=linenums on a pre to get line numbering */
+ol.linenums {
+  margin-top: 0;
+  margin-bottom: 0;
+  padding-bottom: 2px;
+}

package/g.mjs

@@ -0,0 +1,94 @@
+import wdi from './src/WDispatchAi.mjs'
+
+
+//由.env載入金鑰, OPENCODE_KEYS與AGNES_KEYS各以逗號分隔多把, 未提供時沿用各CLI既有登入狀態
+try {
+    process.loadEnvFile('./.env')
+}
+catch {}
+let opencodeKeys = (process.env.OPENCODE_KEYS || '').split(',').filter(Boolean)
+let agnesKeys = (process.env.AGNES_KEYS || '').split(',').filter(Boolean)
+
+
+//agnes-ai為opencode未內建之第三方provider, 須另給其provider定義
+let configAgnes = {
+    provider: {
+        'agnes-ai': {
+            npm: '@ai-sdk/openai-compatible',
+            name: 'Agnes',
+            options: { baseURL: 'https://apihub.agnes-ai.com/v1' },
+            models: { 'agnes-2.0-flash': { name: 'Agnes 2.0 Flash' } },
+        },
+    },
+}
+
+
+let test = async () => {
+
+    //可用之AI供應商種類
+    console.log('KINDS:', wdi.KINDS)
+    // => KINDS: [ 'opencode', 'claude', 'codex' ]
+
+    let prompt = '請只回覆兩個字：完成，不要有任何其他文字'
+
+    //以Claude Code CLI呼叫, 沿用CLI既有登入狀態
+    let r1 = await wdi.dispatchClaude(prompt, { model: 'sonnet' })
+    console.log('claude:', r1.ok, r1.stdout.trim())
+    // => claude: true 完成
+
+    //以Codex CLI呼叫, 可指定沙箱模式
+    let r2 = await wdi.dispatchCodex(prompt, { model: 'gpt-5.6-luna', sandbox: 'read-only' })
+    console.log('codex:', r2.ok, r2.stdout.trim())
+    // => codex: true 完成
+
+    //以opencode CLI呼叫, 未給key與provider即沿用CLI既有登入狀態
+    let r3 = await wdi.dispatchOpencode(prompt, { model: 'opencode/deepseek-v4-flash-free', timeoutMs: 180000 })
+    console.log('opencode:', r3.ok, r3.stdout.trim())
+    // => opencode: true 完成
+
+    //以供應商條目輪替, 一個條目即一組(kind, model, 可選的key與provider與config), 輪到誰就用誰的CLI與模型
+    //opencode支援逐次注入金鑰, 故同一provider之多把金鑰可各成一個條目
+    let items = [
+        { kind: 'claude', model: 'sonnet' },
+        { kind: 'codex', model: 'gpt-5.6-luna', sandbox: 'read-only' },
+        { kind: 'opencode', model: 'opencode/deepseek-v4-flash-free', provider: 'opencode', key: opencodeKeys[0], timeoutMs: 180000 },
+        { kind: 'opencode', model: 'opencode/deepseek-v4-flash-free', provider: 'opencode', key: opencodeKeys[1], timeoutMs: 180000 },
+        { kind: 'opencode', model: 'agnes-ai/agnes-2.0-flash', provider: 'agnes-ai', key: agnesKeys[0], config: configAgnes, timeoutMs: 180000 },
+    ]
+    for (let item of items) {
+        let r = await wdi.dispatchAi(item.kind, prompt, item)
+        console.log('dispatchAi ' + item.model + ':', r.ok, r.stdout.trim())
+        // => dispatchAi sonnet: true 完成
+        // => dispatchAi gpt-5.6-luna: true 完成
+        // => dispatchAi opencode/deepseek-v4-flash-free: true 完成
+        // => dispatchAi opencode/deepseek-v4-flash-free: true 完成
+        // => dispatchAi agnes-ai/agnes-2.0-flash: true 完成
+    }
+
+    //未知供應商回傳error結果物件, 不會reject
+    let r4 = await wdi.dispatchAi('gemini', prompt)
+    console.log('invalid kind:', r4.ok, r4.error)
+    // => invalid kind: false unknown ai kind: "gemini" (available: opencode, claude, codex)
+
+    //prompt非有效字串亦回傳error結果物件
+    let r5 = await wdi.dispatchClaude('')
+    console.log('invalid prompt:', r5.ok, r5.error)
+    // => invalid prompt: false prompt must be a non-empty string
+
+    //CLI執行失敗時, 由ok、code、error與stderr判斷原因
+    let r6 = await wdi.dispatchOpencode(prompt, {
+        model: 'opencode/deepseek-v4-flash-free',
+        provider: 'opencode',
+        key: 'sk-invalid-key',
+    })
+    console.log('invalid key:', r6.ok, r6.code, r6.error, r6.stderr.includes('Invalid API key'))
+    // => invalid key: false 1 Exit code 1 true
+
+}
+await test()
+    .catch((err) => {
+        console.log(err)
+    })
+
+
+//node g.mjs

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "w-dispatch-ai",
+  "version": "1.0.0",
+  "main": "dist/w-dispatch-ai.umd.js",
+  "dependencies": {
+    "wsemi": "^1.8.70"
+  },
+  "devDependencies": {
+    "w-package-tools": "^1.1.12"
+  },
+  "scripts": {
+    "test": "mocha --parallel --timeout 60000",
+    "deploy": "gh-pages -d docs"
+  },
+  "mocha": {
+    "spec": [
+      "test/unit-*.test.mjs"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yuda-lyu/w-dispatch-ai.git"
+  },
+  "keywords": [
+    "package",
+    "tool",
+    "dispatch",
+    "ai",
+    "llm",
+    "cli",
+    "claude",
+    "codex",
+    "opencode",
+    "nodejs"
+  ],
+  "author": "yuda-lyu(semisphere)",
+  "license": "MIT"
+}

package/script.txt

@@ -0,0 +1,17 @@
+#node toolg/addVersion.mjs
+node toolg/modifyReadme.mjs
+
+node toolg/cleanFolder.mjs
+./node_modules/.bin/jsdoc -c .jsdoc
+
+node toolg/gDistRollup.mjs
+
+git add .  -A
+git commit -m 'modify: '
+git push origin master:master
+
+npm run deploy
+
+#npm test
+
+#npm publish

package/src/WDispatchAi.mjs

@@ -0,0 +1,38 @@
+import keys from 'lodash-es/keys.js'
+import adapters from './adapters.mjs'
+import dispatchAi from './dispatchAi.mjs'
+import dispatchOpencode from './dispatchOpencode.mjs'
+import dispatchClaude from './dispatchClaude.mjs'
+import dispatchCodex from './dispatchCodex.mjs'
+
+
+// WDispatchAi.mjs — AI供應商分派層
+//
+// 本套件封裝「以CLI調用各家AI」的差異，對外提供單一介面。
+// 依專案方針，不引用全域技能(dispatch-claude／dispatch-codex／dispatch-opencode)，
+// 而是把其調用方式移植於各轉接器內，方便自行偵錯、修改與擴充。
+
+
+//KINDS, 由adapters鍵名產生, 令供應商清單只有一處來源
+let KINDS = keys(adapters)
+
+
+/**
+ * AI供應商分派
+ *
+ * @returns {Object} 回傳物件，其內含KINDS(可用供應商種類字串陣列)，以及dispatchAi、dispatchOpencode、dispatchClaude、dispatchCodex之async函數
+ * @example
+ *
+ * 詳見dispatchAi、dispatchOpencode、dispatchClaude、dispatchCodex範例
+ *
+ */
+let WDispatchAi = {
+    KINDS,
+    dispatchAi,
+    dispatchOpencode,
+    dispatchClaude,
+    dispatchCodex,
+}
+
+
+export default WDispatchAi

package/src/adapters.mjs

@@ -0,0 +1,28 @@
+import dispatchOpencode from './dispatchOpencode.mjs'
+import dispatchClaude from './dispatchClaude.mjs'
+import dispatchCodex from './dispatchCodex.mjs'
+
+
+/**
+ * 各AI供應商種類(kind)對CLI轉接器函數之對照表
+ *
+ * 本對照表為kind之唯一來源，dispatchAi以其鍵值分派，WDispatchAi以其鍵名產生KINDS，
+ * 新增供應商時僅須於此加入一個鍵值對即可
+ *
+ * @returns {Object} 回傳對照表物件，鍵名為供應商種類字串，鍵值為對應之dispatch函數
+ * @example
+ *
+ * import adapters from './src/adapters.mjs'
+ *
+ * console.log(Object.keys(adapters))
+ * // => ['opencode', 'claude', 'codex']
+ *
+ */
+let adapters = {
+    opencode: dispatchOpencode,
+    claude: dispatchClaude,
+    codex: dispatchCodex,
+}
+
+
+export default adapters

package/src/dispatchAi.mjs

@@ -0,0 +1,61 @@
+import keys from 'lodash-es/keys.js'
+import includes from 'lodash-es/includes.js'
+import isestr from 'wsemi/src/isestr.mjs'
+import adapters from './adapters.mjs'
+import getErrorResult from './getErrorResult.mjs'
+
+
+/**
+ * 依供應商種類(kind)分派至對應之CLI轉接器
+ *
+ * 三種供應商的差異(2026-08-08於本機實測確認)：
+ * opencode支援逐次注入金鑰(OPENCODE_AUTH_CONTENT)，故可多把金鑰輪替；
+ * claude與codex則沿用CLI既有登入狀態，無逐次金鑰概念。
+ * 故「輪替」的單位是「供應商條目」而非單純的金鑰：一個條目即一組(kind, model, 可選的key／provider)，
+ * 輪到誰就用誰的CLI與模型
+ *
+ * @param {String} kind 輸入供應商種類字串，可選'opencode'、'claude'、'codex'
+ * @param {String} prompt 輸入提示詞字串，一律以stdin傳入子進程
+ * @param {Object} [opt={}] 輸入設定物件，原樣轉傳對應轉接器，各轉接器可用設定詳見dispatchOpencode、dispatchClaude、dispatchCodex，預設{}
+ * @returns {Promise} 回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(標準輸出字串)、stderr(標準錯誤字串)、code(離開碼)、error(錯誤訊息字串，成功時為空字串)、durationMs(耗時毫秒)、attempts(實際嘗試次數)，本函數不會reject
+ * @example
+ * //need claude, codex or opencode cli in system PATH
+ *
+ * import dispatchAi from './src/dispatchAi.mjs'
+ *
+ * let test = async () => {
+ *
+ *     let r = await dispatchAi('claude', '請只回覆兩個字：完成', { model: 'sonnet' })
+ *     console.log(r.ok, r.stdout.trim())
+ *     // => true '完成'
+ *
+ *     let re = await dispatchAi('gemini', 'abc')
+ *     console.log(re.ok, re.error)
+ *     // => false 'unknown ai kind: "gemini" (available: opencode, claude, codex)'
+ *
+ * }
+ * await test()
+ *     .catch((err) => {
+ *         console.log(err)
+ *     })
+ *
+ */
+async function dispatchAi(kind, prompt, opt = {}) {
+
+    //ks
+    let ks = keys(adapters)
+
+    //check kind, 須為對照表既有鍵名, 不可用物件取值判斷, 否則'constructor'等原型鍵會誤判為有效
+    if (!isestr(kind) || !includes(ks, kind)) {
+        return getErrorResult(`unknown ai kind: "${kind}" (available: ${ks.join(', ')})`)
+    }
+
+    //fn
+    let fn = adapters[kind]
+
+    //dispatch, prompt與opt之檢核由各轉接器自行負責
+    return fn(prompt, opt)
+}
+
+
+export default dispatchAi

package/src/dispatchClaude.mjs

@@ -0,0 +1,118 @@
+import get from 'lodash-es/get.js'
+import omit from 'lodash-es/omit.js'
+import isbol from 'wsemi/src/isbol.mjs'
+import isestr from 'wsemi/src/isestr.mjs'
+import execCli from 'wsemi/src/execCli.mjs'
+import getCliArgs from './getCliArgs.mjs'
+import getErrorResult from './getErrorResult.mjs'
+
+
+// dispatchClaude.mjs — 以Claude Code CLI呼叫Claude模型
+//
+// 【調用方式】參考全域技能dispatch-claude之慣例，依專案方針「不直接引用全域技能」，
+//   將其調用方式移植於此，方便本專案自行偵錯、修改與擴充。
+//   2026-08-08於本機實測：`claude -p --dangerously-skip-permissions --model sonnet` + stdin
+//   可正確產出合規JSON摘要(15.5s)。
+//
+// 【認證】沿用Claude Code既有登入狀態(帳號層級)，不需也不支援逐次注入API key，
+//   故本轉接器無key參數——輪替時它是「一個獨立的供應商」而非「另一把金鑰」。
+
+
+//預設值
+let DEFAULT_EXE = 'claude'
+
+
+//本轉接器自用之設定鍵, 其餘鍵一律原樣轉傳execCli
+let OWN_KEYS = ['exe', 'model', 'skipPermissions', 'extraArgs', 'input']
+
+
+/**
+ * 以Claude Code CLI呼叫Claude模型
+ *
+ * 特點：
+ * prompt一律走stdin而非位置參數，因摘要內文可達數萬字，當命令列參數會spawn ENAMETOOLONG；
+ * 沿用Claude Code既有登入狀態，無逐次注入API key之概念，故無key參數；
+ * 未給model時不帶`--model`旗標，由CLI自行決定使用模型；
+ * 預設帶`--dangerously-skip-permissions`令非互動之`-p`模式不因權限確認而卡住，
+ * 惟prompt含不可信內容(例如待摘要之網頁)時該內容之指示亦將無權限閘門執行，
+ * 可給予skipPermissions為false保留CLI權限閘門；
+ * 本函數不會reject，一律以結果物件之ok與error欄位回報成敗
+ *
+ * @param {String} prompt 輸入提示詞字串，一律以stdin傳入子進程
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {String} [opt.exe='claude'] 輸入claude執行檔名稱或絕對路徑字串，給予名稱時由execCli自系統PATH解析，預設'claude'
+ * @param {String} [opt.model=''] 輸入模型別名或模型ID字串，例如'sonnet'、'opus'，預設''代表不帶`--model`旗標
+ * @param {Boolean} [opt.skipPermissions=true] 輸入是否帶`--dangerously-skip-permissions`旗標布林值，false代表保留CLI權限閘門，預設true
+ * @param {Array} [opt.extraArgs=[]] 輸入額外命令列旗標字串陣列，將接於固定旗標之後，預設[]
+ * @param {Number} [opt.timeoutMs=120000] 輸入逾時毫秒正整數，逾時將強制關閉子進程及其子孫程序，預設120000
+ * @param {String} [opt.cwd=process.cwd()] 輸入子進程工作目錄字串，預設process.cwd()
+ * @param {String|Function} [opt.validate=undefined] 輸入stdout驗證規則字串或自訂驗證函數，規則字串支援'nonempty'、'json'、'min:100'，多規則可用逗號串接，預設undefined代表不驗證
+ * @param {Number} [opt.maxRetries=0] 輸入失敗後最大重試次數非負整數，預設0
+ * @returns {Promise} 回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(標準輸出字串)、stderr(標準錯誤字串)、code(離開碼)、error(錯誤訊息字串，成功時為空字串)、durationMs(耗時毫秒)、attempts(實際嘗試次數)，本函數不會reject
+ * @example
+ * //need claude cli in system PATH
+ *
+ * import dispatchClaude from './src/dispatchClaude.mjs'
+ *
+ * let test = async () => {
+ *
+ *     let r = await dispatchClaude('請只回覆兩個字：完成', { model: 'sonnet', timeoutMs: 120000 })
+ *     console.log(r.ok, r.stdout.trim())
+ *     // => true '完成'
+ *
+ *     let re = await dispatchClaude('')
+ *     console.log(re.ok, re.error)
+ *     // => false 'prompt must be a non-empty string'
+ *
+ * }
+ * await test()
+ *     .catch((err) => {
+ *         console.log(err)
+ *     })
+ *
+ */
+async function dispatchClaude(prompt, opt = {}) {
+
+    //check prompt, 不reject故以錯誤結果物件回報
+    if (!isestr(prompt)) {
+        return getErrorResult('prompt must be a non-empty string')
+    }
+
+    //exe, 無效回退預設'claude', 由execCli自系統PATH解析實體路徑
+    let exe = get(opt, 'exe', null)
+    if (!isestr(exe)) {
+        exe = DEFAULT_EXE
+    }
+
+    //model, 無效時整段`--model`旗標不出現, 由CLI自行決定使用模型
+    let model = get(opt, 'model', null)
+
+    //skipPermissions, 非布林值回退預設true(非互動-p模式不卡權限確認)
+    let skipPermissions = get(opt, 'skipPermissions', null)
+    if (!isbol(skipPermissions)) {
+        skipPermissions = true
+    }
+
+    //extraArgs
+    let extraArgs = get(opt, 'extraArgs', null)
+
+    //args
+    let args = getCliArgs(
+        '-p',
+        skipPermissions ? '--dangerously-skip-permissions' : [],
+        isestr(model) ? ['--model', model] : [],
+        extraArgs,
+    )
+
+    //optCli, 剔除本轉接器自用鍵後原樣轉傳, 令呼叫端可用execCli全部設定(例如onStdout、maxBuffer)
+    let optCli = omit(opt, OWN_KEYS)
+
+    //execCli, prompt一律走stdin
+    return execCli(exe, args, {
+        ...optCli,
+        input: prompt,
+    })
+}
+
+
+export default dispatchClaude

package/src/dispatchCodex.mjs

@@ -0,0 +1,119 @@
+import get from 'lodash-es/get.js'
+import omit from 'lodash-es/omit.js'
+import isestr from 'wsemi/src/isestr.mjs'
+import execCli from 'wsemi/src/execCli.mjs'
+import getCliArgs from './getCliArgs.mjs'
+import getErrorResult from './getErrorResult.mjs'
+
+
+// dispatchCodex.mjs — 以OpenAI Codex CLI呼叫GPT模型
+//
+// 【調用方式】參考全域技能dispatch-codex之慣例，依專案方針「不直接引用全域技能」，
+//   將其調用方式移植於此，方便本專案自行偵錯、修改與擴充。
+//
+// 【走stdin而非位置參數】技能文件的範例是把prompt當位置參數，但摘要內文可達數萬字，
+//   當命令列參數會spawn ENAMETOOLONG(本專案在opencode上已實際踩過)。
+//   2026-08-08實測：codex exec未帶位置prompt時可從stdin讀取，
+//   以gpt-5.6-luna產出合規JSON摘要(10.5s)，與位置參數版結果等價。
+//
+// 【認證】沿用Codex CLI既有登入狀態，不逐次注入API key。
+
+
+//預設值
+let DEFAULT_EXE = 'codex'
+let DEFAULT_SANDBOX = 'workspace-write'
+
+
+//本轉接器自用之設定鍵, 其餘鍵一律原樣轉傳execCli
+let OWN_KEYS = ['exe', 'model', 'sandbox', 'extraArgs', 'input']
+
+
+/**
+ * 以OpenAI Codex CLI呼叫GPT模型
+ *
+ * 特點：
+ * prompt一律走stdin而非位置參數，因摘要內文可達數萬字，當命令列參數會spawn ENAMETOOLONG；
+ * 固定帶`--skip-git-repo-check`，令非git倉庫之工作目錄亦可執行；
+ * 沿用Codex CLI既有登入狀態，無逐次注入API key之概念，故無key參數；
+ * 未給model時不帶`-m`旗標，由CLI自行決定使用模型；
+ * 本函數不會reject，一律以結果物件之ok與error欄位回報成敗
+ *
+ * @param {String} prompt 輸入提示詞字串，一律以stdin傳入子進程
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {String} [opt.exe='codex'] 輸入codex執行檔名稱或絕對路徑字串，給予名稱時由execCli自系統PATH解析，預設'codex'
+ * @param {String} [opt.model=''] 輸入模型ID字串，例如'gpt-5.6-luna'，預設''代表不帶`-m`旗標
+ * @param {String} [opt.sandbox='workspace-write'] 輸入沙箱模式字串，例如'read-only'、'workspace-write'、'danger-full-access'，預設'workspace-write'
+ * @param {Array} [opt.extraArgs=[]] 輸入額外命令列旗標字串陣列，例如['--config', 'model_reasoning_effort="max"']，將接於固定旗標之後，預設[]
+ * @param {Number} [opt.timeoutMs=120000] 輸入逾時毫秒正整數，逾時將強制關閉子進程及其子孫程序，預設120000
+ * @param {String} [opt.cwd=process.cwd()] 輸入子進程工作目錄字串，預設process.cwd()
+ * @param {String|Function} [opt.validate=undefined] 輸入stdout驗證規則字串或自訂驗證函數，規則字串支援'nonempty'、'json'、'min:100'，多規則可用逗號串接，預設undefined代表不驗證
+ * @param {Number} [opt.maxRetries=0] 輸入失敗後最大重試次數非負整數，預設0
+ * @returns {Promise} 回傳Promise，resolve回傳結果物件，內含ok(是否成功布林值)、stdout(標準輸出字串)、stderr(標準錯誤字串)、code(離開碼)、error(錯誤訊息字串，成功時為空字串)、durationMs(耗時毫秒)、attempts(實際嘗試次數)，本函數不會reject
+ * @example
+ * //need codex cli in system PATH
+ *
+ * import dispatchCodex from './src/dispatchCodex.mjs'
+ *
+ * let test = async () => {
+ *
+ *     let r = await dispatchCodex('請只回覆兩個字：完成', { model: 'gpt-5.6-luna', sandbox: 'read-only' })
+ *     console.log(r.ok, r.stdout.includes('完成'))
+ *     // => true true
+ *
+ *     let re = await dispatchCodex('abc', { exe: 'codex-not-exist' })
+ *     console.log(re.ok, re.error.includes('ENOENT'))
+ *     // => false true
+ *
+ * }
+ * await test()
+ *     .catch((err) => {
+ *         console.log(err)
+ *     })
+ *
+ */
+async function dispatchCodex(prompt, opt = {}) {
+
+    //check prompt, 不reject故以錯誤結果物件回報
+    if (!isestr(prompt)) {
+        return getErrorResult('prompt must be a non-empty string')
+    }
+
+    //exe, 無效回退預設'codex', 由execCli自系統PATH解析實體路徑
+    let exe = get(opt, 'exe', null)
+    if (!isestr(exe)) {
+        exe = DEFAULT_EXE
+    }
+
+    //model, 無效時整段`-m`旗標不出現, 由CLI自行決定使用模型
+    let model = get(opt, 'model', null)
+
+    //sandbox, 無效回退預設'workspace-write'
+    let sandbox = get(opt, 'sandbox', null)
+    if (!isestr(sandbox)) {
+        sandbox = DEFAULT_SANDBOX
+    }
+
+    //extraArgs
+    let extraArgs = get(opt, 'extraArgs', null)
+
+    //args, --skip-git-repo-check令非git倉庫之工作目錄亦可執行, 缺此旗標codex會拒絕執行
+    let args = getCliArgs(
+        'exec',
+        ['--sandbox', sandbox],
+        '--skip-git-repo-check',
+        isestr(model) ? ['-m', model] : [],
+        extraArgs,
+    )
+
+    //optCli, 剔除本轉接器自用鍵後原樣轉傳, 令呼叫端可用execCli全部設定(例如onStdout、maxBuffer)
+    let optCli = omit(opt, OWN_KEYS)
+
+    //execCli, prompt一律走stdin
+    return execCli(exe, args, {
+        ...optCli,
+        input: prompt,
+    })
+}
+
+
+export default dispatchCodex