w-dispatch-ai 1.0.1 → 1.0.3

package/test/unit-WDispatchAi.test.mjs

@@ -4,9 +4,12 @@ import map from 'lodash-es/map.js'
 import wi from '../src/WDispatchAi.mjs'
 import dispatchAi from '../src/dispatchAi.mjs'
 import dispatchAiFallback from '../src/dispatchAiFallback.mjs'
+import dispatchAiWkf from '../src/dispatchAiWkf.mjs'
 import dispatchOpencode from '../src/dispatchOpencode.mjs'
 import dispatchClaude from '../src/dispatchClaude.mjs'
 import dispatchCodex from '../src/dispatchCodex.mjs'
+import dispatchAntigravity from '../src/dispatchAntigravity.mjs'
+import dispatchApiOpenaiCompat from '../src/dispatchApiOpenaiCompat.mjs'
 
 
 describe('WDispatchAi', function() {
@@ -17,22 +20,25 @@ describe('WDispatchAi', function() {
             'KINDS',
             'dispatchAi',
             'dispatchAiFallback',
+            'dispatchAiWkf',
             'dispatchOpencode',
             'dispatchClaude',
             'dispatchCodex',
+            'dispatchAntigravity',
+            'dispatchApiOpenaiCompat',
         ]
         assert.strict.deepEqual(r, rr)
     })
 
     it('KINDS為可用之供應商種類字串陣列', function() {
         let r = wi.KINDS
-        let rr = ['opencode', 'claude', 'codex']
+        let rr = ['opencode', 'claude', 'codex', 'antigravity', 'api-openai-compat']
         assert.strict.deepEqual(r, rr)
     })
 
     it('除KINDS外各鍵值皆為函數', function() {
         let r = map(keys(wi), (k) => typeof wi[k])
-        let rr = ['object', 'function', 'function', 'function', 'function', 'function']
+        let rr = ['object', 'function', 'function', 'function', 'function', 'function', 'function', 'function', 'function']
         assert.strict.deepEqual(r, rr)
     })
 
@@ -40,11 +46,14 @@ describe('WDispatchAi', function() {
         let r = [
             wi.dispatchAi === dispatchAi,
             wi.dispatchAiFallback === dispatchAiFallback,
+            wi.dispatchAiWkf === dispatchAiWkf,
             wi.dispatchOpencode === dispatchOpencode,
             wi.dispatchClaude === dispatchClaude,
             wi.dispatchCodex === dispatchCodex,
+            wi.dispatchAntigravity === dispatchAntigravity,
+            wi.dispatchApiOpenaiCompat === dispatchApiOpenaiCompat,
         ]
-        let rr = [true, true, true, true, true]
+        let rr = [true, true, true, true, true, true, true, true]
         assert.strict.deepEqual(r, rr)
     })
 
@@ -54,20 +63,20 @@ describe('WDispatchAi', function() {
             let t = await wi.dispatchAi(kind, '')
             r.push(t.error)
         }
-        let rr = ['prompt must be a non-empty string', 'prompt must be a non-empty string', 'prompt must be a non-empty string']
+        let rr = ['prompt must be a non-empty string', 'prompt must be a non-empty string', 'prompt must be a non-empty string', 'prompt must be a non-empty string', 'prompt must be a non-empty string']
         assert.strict.deepEqual(r, rr)
     })
 
     it('可由WDispatchAi呼叫dispatchAi', async function() {
         let t = await wi.dispatchAi('gemini', 'abc')
         let r = [t.ok, t.error]
-        let rr = [false, 'unknown ai kind: "gemini" (available: opencode, claude, codex)']
+        let rr = [false, 'unknown ai kind: "gemini" (available: opencode, claude, codex, antigravity, api-openai-compat)']
         assert.strict.deepEqual(r, rr)
     })
 
     it('可由WDispatchAi呼叫各轉接器', async function() {
         let r = []
-        for (let fn of [wi.dispatchOpencode, wi.dispatchClaude, wi.dispatchCodex]) {
+        for (let fn of [wi.dispatchOpencode, wi.dispatchClaude, wi.dispatchCodex, wi.dispatchAntigravity, wi.dispatchApiOpenaiCompat]) {
             let t = await fn('')
             r.push([t.ok, t.error])
         }
@@ -75,6 +84,8 @@ describe('WDispatchAi', function() {
             [false, 'prompt must be a non-empty string'],
             [false, 'prompt must be a non-empty string'],
             [false, 'prompt must be a non-empty string'],
+            [false, 'prompt must be a non-empty string'],
+            [false, 'prompt must be a non-empty string'],
         ]
         assert.strict.deepEqual(r, rr)
     })

package/test/unit-adapters.test.mjs

@@ -5,19 +5,21 @@ import adapters from '../src/adapters.mjs'
 import dispatchOpencode from '../src/dispatchOpencode.mjs'
 import dispatchClaude from '../src/dispatchClaude.mjs'
 import dispatchCodex from '../src/dispatchCodex.mjs'
+import dispatchAntigravity from '../src/dispatchAntigravity.mjs'
+import dispatchApiOpenaiCompat from '../src/dispatchApiOpenaiCompat.mjs'
 
 
 describe('adapters', function() {
 
     it('對照表鍵名即為可用之供應商種類', function() {
         let r = keys(adapters)
-        let rr = ['opencode', 'claude', 'codex']
+        let rr = ['opencode', 'claude', 'codex', 'antigravity', 'api-openai-compat']
         assert.strict.deepEqual(r, rr)
     })
 
     it('各鍵值皆為函數', function() {
         let r = map(keys(adapters), (k) => typeof adapters[k])
-        let rr = ['function', 'function', 'function']
+        let rr = ['function', 'function', 'function', 'function', 'function']
         assert.strict.deepEqual(r, rr)
     })
 
@@ -26,8 +28,10 @@ describe('adapters', function() {
             adapters.opencode === dispatchOpencode,
             adapters.claude === dispatchClaude,
             adapters.codex === dispatchCodex,
+            adapters.antigravity === dispatchAntigravity,
+            adapters['api-openai-compat'] === dispatchApiOpenaiCompat,
         ]
-        let rr = [true, true, true]
+        let rr = [true, true, true, true, true]
         assert.strict.deepEqual(r, rr)
     })
 

package/test/unit-callAiWithFallback.test.mjs

@@ -0,0 +1,146 @@
+import assert from 'assert'
+import callAiWithFallback, { buildChain, NO_SIDE_EFFECT } from '../src/wkf/callAiWithFallback.mjs'
+import createFakeCli from './tools/fakeCliForTest.mjs'
+
+
+describe('callAiWithFallback', function() {
+
+    let fake = null
+    let providers = null
+
+    before(function() {
+        fake = createFakeCli('fake-wkf-call')
+        providers = {
+            'p-claude': { kind: 'claude', exe: fake.exe, model: 'sonnet' },
+            'p-codex': { kind: 'codex', exe: fake.exe, model: 'gpt-5.6-luna' },
+            'p-oc': { kind: 'opencode', exe: fake.exe, model: 'opencode/free', provider: 'opencode', keys: ['sk-c0', 'sk-c1'] },
+            'p-dead': { kind: 'claude', exe: fake.exe, model: 'sonnet', extraArgs: ['--fake-exit=1'] },
+            'p-noexe': { kind: 'claude', exe: 'wkf-no-such-cli' },
+        }
+    })
+
+    after(function() {
+        if (fake) {
+            fake.clean()
+        }
+    })
+
+    it('buildChain以名稱展開條目並回報查無定義之名稱', function() {
+        let { chain, missing } = buildChain(providers, { use: 'p-claude', fallback: ['p-codex', 'p-typo'] })
+        let r = [chain.map((x) => x.id), missing]
+        let rr = [['p-claude', 'p-codex'], ['p-typo']]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('prompt非有效字串時回傳錯誤結果物件', async function() {
+        let t = await callAiWithFallback('', { providers, spec: { use: 'p-claude' } })
+        let r = [t.ok, t.json, t.error, t.tried]
+        let rr = [false, null, 'prompt must be a non-empty string', []]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('providers或spec無效時回傳錯誤結果物件', async function() {
+        let r = []
+        for (let [p, s] of [[null, { use: 'x' }], [providers, null], [providers, 'abc']]) {
+            let t = await callAiWithFallback('abc', { providers: p, spec: s })
+            r.push([t.ok, t.error.indexOf('no valid provider') === 0])
+        }
+        let rr = [[false, true], [false, true], [false, true]]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('名稱查無定義時fail fast回報, 不靜默略過', async function() {
+        let t = await callAiWithFallback('abc', { providers, spec: { use: 'p-claude', fallback: ['p-typo1', 'p-codex', 'p-typo2'] } })
+        let r = [t.ok, t.error]
+        let rr = [false, 'unknown provider name(s): p-typo1, p-typo2']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('成功時回傳解析後json與名稱式providerId', async function() {
+        let t = await callAiWithFallback('abc', { providers, spec: { use: 'p-claude' }, promptPrefix: '' })
+        let r = [t.ok, t.providerId, t.keyIndex, t.keyId, t.json.args, t.json.stdin]
+        let rr = [true, 'p-claude', null, 'p-claude', ['-p', '--dangerously-skip-permissions', '--model', 'sonnet'], 'abc']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('預設掛防寫檔前綴, promptPrefix傳空字串可關閉, 自訂前綴可覆寫', async function() {
+        let t1 = await callAiWithFallback('abc', { providers, spec: { use: 'p-claude' } })
+        let t2 = await callAiWithFallback('abc', { providers, spec: { use: 'p-claude' }, promptPrefix: '' })
+        let t3 = await callAiWithFallback('abc', { providers, spec: { use: 'p-claude' }, promptPrefix: 'PREFIX:' })
+        let r = [t1.json.stdin, t2.json.stdin, t3.json.stdin]
+        let rr = [NO_SIDE_EFFECT + 'abc', 'abc', 'PREFIX:abc']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('check未過視為該家失敗, 遞補層自動換下一家', async function() {
+        //check要求args含opencode之run旗標 → p-claude不合(換家) → p-oc合
+        let t = await callAiWithFallback('abc', {
+            providers,
+            spec: { use: 'p-claude', fallback: ['p-oc'] },
+            check: (j) => j.args[0] === 'run',
+            promptPrefix: '',
+        })
+        let r = [t.ok, t.providerId, t.keyIndex, t.keyId, t.tried.map((x) => [x.providerId, x.outcome])]
+        let rr = [true, 'p-oc', 0, 'p-oc#0', [['p-claude', 'skip-group'], ['p-oc', 'ok']]]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('CLI失敗(exit 1)時遞補至下一家', async function() {
+        let t = await callAiWithFallback('abc', { providers, spec: { use: 'p-dead', fallback: ['p-codex'] }, promptPrefix: '' })
+        let r = [t.ok, t.providerId, t.tried.map((x) => [x.providerId, x.outcome])]
+        let rr = [true, 'p-codex', [['p-dead', 'next-key'], ['p-codex', 'ok']]]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('全數失敗時回傳error與完整tried', async function() {
+        let t = await callAiWithFallback('abc', { providers, spec: { use: 'p-dead', fallback: ['p-noexe'] }, promptPrefix: '' })
+        let r = [t.ok, t.json, t.error !== '', t.tried.length]
+        let rr = [false, null, true, 2]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('rawText模式不解析JSON, json欄為修剪後文字', async function() {
+        let t = await callAiWithFallback('abc', { providers, spec: { use: 'p-claude' }, rawText: true, promptPrefix: '' })
+        let r = [t.ok, typeof t.json, JSON.parse(t.json).stdin]
+        let rr = [true, 'string', 'abc']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('rawText模式check收文字', async function() {
+        let seen = []
+        let t = await callAiWithFallback('abc', {
+            providers,
+            spec: { use: 'p-claude' },
+            rawText: true,
+            check: (s) => {
+                seen.push(typeof s)
+                return s.includes('"stdin"')
+            },
+            promptPrefix: '',
+        })
+        let r = [t.ok, seen.includes('string')]
+        let rr = [true, true]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('自訂parse可覆寫預設解析器', async function() {
+        let t = await callAiWithFallback('abc', {
+            providers,
+            spec: { use: 'p-claude' },
+            parse: (stdout) => ({ wrapped: JSON.parse(stdout).stdin }),
+            promptPrefix: '',
+        })
+        let r = t.json
+        let rr = { wrapped: 'abc' }
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('多金鑰條目經由keys輪替且keyId帶索引', async function() {
+        let t = await callAiWithFallback('abc', { providers, spec: { use: 'p-oc' }, promptPrefix: '' })
+        let auth = JSON.parse(t.json.env.OPENCODE_AUTH_CONTENT)
+        let r = [t.ok, t.providerId, typeof t.keyIndex, t.keyId.indexOf('p-oc#') === 0, ['sk-c0', 'sk-c1'].includes(auth.opencode.key)]
+        let rr = [true, 'p-oc', 'number', true, true]
+        assert.strict.deepEqual(r, rr)
+    })
+
+})

package/test/unit-dispatchAi.test.mjs

@@ -20,7 +20,7 @@ describe('dispatchAi', function() {
     it('未知kind時回傳錯誤結果物件且不reject', async function() {
         let t = await dispatchAi('gemini', 'abc')
         let r = [t.ok, t.error, t.attempts]
-        let rr = [false, 'unknown ai kind: "gemini" (available: opencode, claude, codex)', 0]
+        let rr = [false, 'unknown ai kind: "gemini" (available: opencode, claude, codex, antigravity, api-openai-compat)', 0]
         assert.strict.deepEqual(r, rr)
     })
 
@@ -46,7 +46,7 @@ describe('dispatchAi', function() {
 
     it('prompt之檢核由各轉接器負責, 錯誤結果物件一致', async function() {
         let r = []
-        for (let kind of ['opencode', 'claude', 'codex']) {
+        for (let kind of ['opencode', 'claude', 'codex', 'antigravity']) {
             let t = await dispatchAi(kind, '')
             r.push([t.ok, t.error])
         }
@@ -54,13 +54,14 @@ describe('dispatchAi', function() {
             [false, 'prompt must be a non-empty string'],
             [false, 'prompt must be a non-empty string'],
             [false, 'prompt must be a non-empty string'],
+            [false, 'prompt must be a non-empty string'],
         ]
         assert.strict.deepEqual(r, rr)
     })
 
     it('各kind分派至對應轉接器, 由其固定旗標可辨識', async function() {
         let r = []
-        for (let kind of ['opencode', 'claude', 'codex']) {
+        for (let kind of ['opencode', 'claude', 'codex', 'antigravity']) {
             let t = await dispatchAi(kind, 'abc', { exe: fake.exe, model: 'mdl' })
             let o = JSON.parse(t.stdout)
             r.push([t.ok, o.args])
@@ -69,6 +70,7 @@ describe('dispatchAi', function() {
             [true, ['run', '--agent', 'build', '-m', 'mdl']],
             [true, ['-p', '--dangerously-skip-permissions', '--model', 'mdl']],
             [true, ['exec', '--sandbox', 'workspace-write', '--skip-git-repo-check', '-m', 'mdl']],
+            [true, ['--dangerously-skip-permissions', '--print-timeout', '270s', '--model', 'mdl', '--print', 'abc']],
         ]
         assert.strict.deepEqual(r, rr)
     })
@@ -86,6 +88,7 @@ describe('dispatchAi', function() {
             { kind: 'opencode', model: 'opencode/free', provider: 'opencode', key: 'sk-1' },
             { kind: 'claude', model: 'sonnet' },
             { kind: 'codex', model: 'gpt-5.6-luna' },
+            { kind: 'antigravity', model: 'gemini-3.6-flash-low' },
         ]
         let r = []
         for (let item of items) {
@@ -97,6 +100,7 @@ describe('dispatchAi', function() {
             ['opencode', 'run', true],
             ['claude', '-p', true],
             ['codex', 'exec', true],
+            ['antigravity', '--dangerously-skip-permissions', true],
         ]
         assert.strict.deepEqual(r, rr)
     })

package/test/unit-dispatchAiWkf.test.mjs

@@ -0,0 +1,118 @@
+import assert from 'assert'
+import keys from 'lodash-es/keys.js'
+import dispatchAiWkf from '../src/dispatchAiWkf.mjs'
+import { NO_SIDE_EFFECT } from '../src/wkf/callAiWithFallback.mjs'
+import createFakeCli from './tools/fakeCliForTest.mjs'
+
+
+describe('dispatchAiWkf', function() {
+
+    let fake = null
+    let providers = null
+
+    before(function() {
+        fake = createFakeCli('fake-wkf-factory')
+        providers = {
+            'p-a': { kind: 'claude', exe: fake.exe, model: 'sonnet' },
+            'p-b': { kind: 'codex', exe: fake.exe, model: 'gpt-5.6-luna' },
+            'p-int': { kind: 'opencode', exe: fake.exe, model: 'opencode/free' },
+        }
+    })
+
+    after(function() {
+        if (fake) {
+            fake.clean()
+        }
+    })
+
+    it('providers無效時throw(設定錯誤於啟動期即失敗)', function() {
+        let r = []
+        for (let providers of [undefined, null, 'abc', 123, []]) {
+            try {
+                dispatchAiWkf({ providers })
+                r.push('no-throw')
+            }
+            catch (err) {
+                r.push(err.message.indexOf('dispatchAiWkf:') === 0)
+            }
+        }
+        let rr = [true, true, true, true, true]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('回傳綁定版API物件', function() {
+        let wkf = dispatchAiWkf({ providers })
+        let r = [
+            keys(wkf),
+            wkf.providers === providers,
+            typeof wkf.callAi,
+            typeof wkf.runFanout,
+            typeof wkf.runRolePipeline,
+            typeof wkf.runFanoutPipeline,
+        ]
+        let rr = [
+            ['providers', 'callAi', 'runFanout', 'runRolePipeline', 'runFanoutPipeline'],
+            true,
+            'function',
+            'function',
+            'function',
+            'function',
+        ]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('callAi綁定providers, 以名稱宣告即可呼叫', async function() {
+        let wkf = dispatchAiWkf({ providers, defaults: { promptPrefix: '' } })
+        let t = await wkf.callAi('abc', { spec: { use: 'p-a' } })
+        let r = [t.ok, t.providerId, t.json.stdin]
+        let rr = [true, 'p-a', 'abc']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('defaults為共用預設且呼叫時可逐項覆寫', async function() {
+        let wkf = dispatchAiWkf({ providers, defaults: { promptPrefix: 'DEF:' } })
+        let t1 = await wkf.callAi('abc', { spec: { use: 'p-a' } })
+        let t2 = await wkf.callAi('abc', { spec: { use: 'p-a' }, promptPrefix: 'OVR:' })
+        let r = [t1.json.stdin, t2.json.stdin]
+        let rr = ['DEF:abc', 'OVR:abc']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('未給defaults時預設掛防寫檔前綴', async function() {
+        let wkf = dispatchAiWkf({ providers })
+        let t = await wkf.callAi('abc', { spec: { use: 'p-a' } })
+        let r = t.json.stdin
+        let rr = NO_SIDE_EFFECT + 'abc'
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('runFanout綁定providers與defaults(defaults併入callOpt)', async function() {
+        let wkf = dispatchAiWkf({ providers, defaults: { promptPrefix: '' } })
+        let t = await wkf.runFanout({
+            task: 'abc',
+            agents: [{ use: 'p-a' }, { use: 'p-b' }],
+            integrate: { use: 'p-int' },
+        })
+        let r = [t.ok, t.integrated, t.result.stdin.includes('【候選 1】')]
+        let rr = [true, true, true]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('runRolePipeline與runFanoutPipeline皆已綁定可用', async function() {
+        let wkf = dispatchAiWkf({ providers, defaults: { promptPrefix: '' } })
+        let t1 = await wkf.runRolePipeline({
+            input: 'x',
+            stages: [{ id: 's1', use: 'p-a', prompt: (ctx) => `on ${ctx.input}` }],
+        })
+        let t2 = await wkf.runFanoutPipeline({
+            task: 'abc',
+            agents: [{ use: 'p-a' }, { use: 'p-b' }],
+            integrate: { use: 'p-int' },
+            stages: [{ id: 's1', use: 'p-a', prompt: () => 'y' }],
+        })
+        let r = [t1.ok, t1.results.s1.stdin, t2.ok, t2.B.order]
+        let rr = [true, 'on x', true, ['s1']]
+        assert.strict.deepEqual(r, rr)
+    })
+
+})

package/test/unit-dispatchAntigravity.test.mjs

@@ -0,0 +1,173 @@
+import assert from 'assert'
+import dispatchAntigravity from '../src/dispatchAntigravity.mjs'
+import createFakeCli from './tools/fakeCliForTest.mjs'
+
+
+describe('dispatchAntigravity', function() {
+
+    let fake = null
+
+    before(function() {
+        fake = createFakeCli('fake-agy')
+    })
+
+    after(function() {
+        if (fake) {
+            fake.clean()
+        }
+    })
+
+    it('prompt非有效字串時回傳錯誤結果物件且不reject', async function() {
+        let r = []
+        for (let prompt of [null, undefined, '', 123, {}, []]) {
+            let t = await dispatchAntigravity(prompt)
+            r.push([t.ok, t.error, t.attempts])
+        }
+        let rr = [
+            [false, 'prompt must be a non-empty string', 0],
+            [false, 'prompt must be a non-empty string', 0],
+            [false, 'prompt must be a non-empty string', 0],
+            [false, 'prompt must be a non-empty string', 0],
+            [false, 'prompt must be a non-empty string', 0],
+            [false, 'prompt must be a non-empty string', 0],
+        ]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('prompt超過30000字元時回傳prompt too long且不spawn', async function() {
+        let t = await dispatchAntigravity('x'.repeat(30001), { exe: fake.exe })
+        let r = [t.ok, t.error.indexOf('prompt too long (30001 chars > 30000)') === 0, t.attempts]
+        let rr = [false, true, 0]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('prompt恰為30000字元時可正常spawn', async function() {
+        let prompt = 'x'.repeat(30000)
+        let t = await dispatchAntigravity(prompt, { exe: fake.exe })
+        let o = JSON.parse(t.stdout)
+        let r = [t.ok, o.args[o.args.length - 1] === prompt]
+        let rr = [true, true]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('轉義膨脹突破命令列上限時由try/catch兜底回傳錯誤結果物件不reject', async function() {
+        //29000個引號長度過前置檢查, 但spawn轉義後約58000字元 → 同步拋ENAMETOOLONG
+        let t = await dispatchAntigravity('"'.repeat(29000), { exe: fake.exe })
+        let r = [t.ok, t.error.includes('ENAMETOOLONG'), t.attempts]
+        let rr = [false, true, 0]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('預設帶--dangerously-skip-permissions與--print-timeout, prompt為--print之值且位於最後', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe })
+        let o = JSON.parse(t.stdout)
+        let r = [t.ok, o.args]
+        let rr = [true, ['--dangerously-skip-permissions', '--print-timeout', '270s', '--print', 'abc']]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('prompt不走stdin(agy由--print取得, 塞stdin會進互動模式)', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe })
+        let o = JSON.parse(t.stdout)
+        let r = [o.stdin, o.args.includes('abc')]
+        let rr = ['', true]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('有給model時帶--model旗標', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe, model: 'gemini-3.6-flash-low' })
+        let o = JSON.parse(t.stdout)
+        let r = o.args
+        let rr = ['--dangerously-skip-permissions', '--print-timeout', '270s', '--model', 'gemini-3.6-flash-low', '--print', 'abc']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('有給effort時帶--effort旗標', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe, model: 'gemini-3.1-pro', effort: 'low' })
+        let o = JSON.parse(t.stdout)
+        let r = o.args
+        let rr = ['--dangerously-skip-permissions', '--print-timeout', '270s', '--model', 'gemini-3.1-pro', '--effort', 'low', '--print', 'abc']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('skipPermissions為false時不帶--dangerously-skip-permissions旗標', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe, skipPermissions: false })
+        let o = JSON.parse(t.stdout)
+        let r = [t.ok, o.args]
+        let rr = [true, ['--print-timeout', '270s', '--print', 'abc']]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('printTimeout由timeoutMs推導並預留30秒緩衝, 下限30秒', async function() {
+        let r = []
+        for (let timeoutMs of [600000, 120000, 5000, undefined]) {
+            let opt = { exe: fake.exe }
+            if (timeoutMs !== undefined) {
+                opt.timeoutMs = timeoutMs
+            }
+            let t = await dispatchAntigravity('abc', opt)
+            let o = JSON.parse(t.stdout)
+            let i = o.args.indexOf('--print-timeout')
+            r.push(o.args[i + 1])
+        }
+        let rr = ['570s', '90s', '30s', '270s'] //600-30, 120-30, max(30,5-30), 預設300-30
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('printTimeout明確給定時不推導', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe, printTimeout: '10m', timeoutMs: 600000 })
+        let o = JSON.parse(t.stdout)
+        let i = o.args.indexOf('--print-timeout')
+        let r = o.args[i + 1]
+        let rr = '10m'
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('addDirs逐項展開為--add-dir並濾除非有效字串', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe, addDirs: ['c:/a', null, 'c:/b', 123] })
+        let o = JSON.parse(t.stdout)
+        let r = o.args
+        let rr = ['--dangerously-skip-permissions', '--print-timeout', '270s', '--add-dir', 'c:/a', '--add-dir', 'c:/b', '--print', 'abc']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('extraArgs接於固定旗標之後且於--print之前', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe, extraArgs: ['--output-format', 'json'] })
+        let o = JSON.parse(t.stdout)
+        let r = o.args
+        let rr = ['--dangerously-skip-permissions', '--print-timeout', '270s', '--output-format', 'json', '--print', 'abc']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('中文與多行prompt於--print值內完整保留', async function() {
+        let prompt = '第一行中文\n第二行 with "quote" & <sym>\n第三行'
+        let t = await dispatchAntigravity(prompt, { exe: fake.exe })
+        let o = JSON.parse(t.stdout)
+        let r = o.args[o.args.length - 1] === prompt
+        let rr = true
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('執行檔不存在時回傳ENOENT且不重試', async function() {
+        let t = await dispatchAntigravity('abc', { exe: 'agy-not-exist-for-test', maxRetries: 3 })
+        let r = [t.ok, t.error.includes('ENOENT'), t.attempts]
+        let rr = [false, true, 1]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('離開碼非0時回傳失敗(如model與effort衝突時agy回exit 1)', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe, extraArgs: ['--fake-exit=1', '--fake-stderr=conflicts with --effort'] })
+        let r = [t.ok, t.code, t.error, t.stderr]
+        let rr = [false, 1, 'Exit code 1', 'conflicts with --effort']
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('cwd等execCli設定原樣轉傳', async function() {
+        let t = await dispatchAntigravity('abc', { exe: fake.exe, cwd: process.cwd() })
+        let o = JSON.parse(t.stdout)
+        let r = [t.ok, o.cwd === process.cwd()]
+        let rr = [true, true]
+        assert.strict.deepEqual(r, rr)
+    })
+
+})