feat: open local runtime clients from the composer

Add composer shortcuts for local Continue and OpenCode terminals and the official DeepSeek Harness Web client, using the current project and model bridge. Manage browser service reuse, stop actions and terminal cleanup. Upgrade DeepSeek Harness to 0.1.7-rc.2 and Cordis to 4.0.4. Include the coordinated IPC handler extraction and related tests and documentation. Remote native-client coordinator wiring, managed Node consolidation, Ask MCP mappings and full desktop/package acceptance remain unfinished; this commit records the implemented local workflow and supporting SSH groundwork. Validation: typecheck and lint passed; 267 focused tests passed and 5 skipped. No new real-provider calls were made for this commit. Prior real-model evidence and remaining acceptance work are documented in the feature progress files. Release note: 本地项目选择 Continue 或 OpenCode 后，可从输入框下方打开原生终端；选择 DS 后，可打开使用当前项目和模型的官方 Web 客户端。客户端使用独立会话，DS 网页关闭后服务继续运行，可在 GoodBuddy 中停止；远程入口尚未完成。
2026-09-27 08:38:00 +08:00
parent 1094433a7d
commit f81f342cde
71 changed files with 11943 additions and 2478 deletions
@@ -0,0 +1,94 @@
+// @vitest-environment node
+import { mkdtemp, readFile, readdir, rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import type { ResolvedRuntimeSettings } from '../runtime-settings-store'
+import type { NativeTerminalLaunch } from '../terminal/terminal-session-manager'
+import type { TerminalSnapshot } from '../../shared/terminal-contracts'
+import { NativeTerminalClient, type NativeTerminalClientInput } from './native-terminal-client'
+
+const roots: string[] = []
+const launches: NativeTerminalLaunch[] = []
+afterEach(async () => {
+  await Promise.all(launches.splice(0).map(launch => launch.dispose()))
+  await Promise.all(roots.splice(0).map(root => rm(root, { recursive: true, force: true })))
+})
+
+async function fixture() {
+  const root = await mkdtemp(join(tmpdir(), 'native-terminal-test-'))
+  roots.push(root)
+  const create = vi.fn(async (_owner, _request, launch: NativeTerminalLaunch | undefined) => {
+    launches.push(launch!)
+    return { sessionId: 'terminal', state: 'running' } as TerminalSnapshot
+  })
+  const fetcher = vi.fn<typeof fetch>(async () => new Response(JSON.stringify({ choices: [{ message: { role: 'assistant', content: 'ok' } }] }), { headers: { 'content-type': 'application/json' } }))
+  const client = new NativeTerminalClient({
+    terminalManager: { create }, rootDirectory: root,
+    bundledRuntimePaths: { opencode: process.execPath, continue: process.execPath, ripgrep: '', deepseekHarness: '' }, fetcher
+  })
+  const profile = { id: 'selected', name: 'Selected model', modelName: 'selected-model', baseUrl: 'https://provider.example/v1', authentication: 'api-key' as const, protocol: 'openai-chat-completions' as const, apiKey: 'provider-secret', requestHeaders: { 'x-provider-option': 'configured' } }
+  const input: NativeTerminalClientInput = {
+    projectId: 'project', projectName: 'Project', directory: root, runtime: 'opencode', workMode: 'ask',
+    settings: { opencodeBinaryPath: '', opencodeModelProfile: profile } as unknown as ResolvedRuntimeSettings
+  }
+  return { root, client, create, fetcher, input }
+}
+
+describe('native terminal client', () => {
+  it('bridges successive native requests with the selected model and keeps credentials in Main', async () => {
+    const { client, input, create, fetcher, root } = await fixture()
+    const first = client.open(1, input)
+    expect(client.open(1, input)).toBe(first)
+    await first
+    expect(create).toHaveBeenCalledOnce()
+    const launch = launches[0]!
+    expect(JSON.stringify(launch.spawnSpec)).not.toContain('provider-secret')
+    const config = JSON.parse(launch.spawnSpec.env.OPENCODE_CONFIG_CONTENT!)
+    const provider = Object.values(config.provider)[0] as { options: { baseURL: string; apiKey: string } }
+    for (let i = 0; i < 2; i++) {
+      const response = await fetch(`${provider.options.baseURL}/chat/completions`, { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${provider.options.apiKey}` }, body: JSON.stringify({ model: 'selected-model', messages: [{ role: 'user', content: 'hi' }] }) })
+      expect(response.status).toBe(200)
+      expect(await response.text()).toContain('ok')
+    }
+    expect(fetcher).toHaveBeenCalledTimes(2)
+    expect(String(fetcher.mock.calls[0]?.[0])).toBe('https://provider.example/v1/chat/completions')
+    const headers = new Headers(fetcher.mock.calls[0]?.[1]?.headers)
+    expect(headers.get('authorization')).toBe('Bearer provider-secret')
+    expect(headers.get('x-provider-option')).toBe('configured')
+    const configDirectory = launch.spawnSpec.env.OPENCODE_CONFIG_DIR!
+    const pluginPath = new URL(config.plugin[0])
+    const plugin = await import(/* @vite-ignore */ pluginPath.href)
+    const hooks = await plugin.default()
+    await expect(hooks['tool.execute.before']({ tool: 'read' })).resolves.toBeUndefined()
+    await expect(hooks['tool.execute.before']({ tool: 'bash' })).rejects.toThrow('read-only')
+    await expect(hooks['tool.execute.before']({ tool: 'mcp_write' })).rejects.toThrow('read-only')
+    await launch.dispose()
+    await expect(readdir(configDirectory)).rejects.toThrow()
+    expect(await readdir(join(root, 'opencode'))).toHaveLength(1)
+    await expect(fetch(`${provider.options.baseURL}/chat/completions`, { method: 'POST' })).rejects.toThrow()
+    await client.open(1, input)
+    expect(create).toHaveBeenCalledTimes(2)
+  })
+
+  it('releases prepared resources after terminal creation fails and permits retry', async () => {
+    const { client, input, create, root } = await fixture()
+    create.mockImplementationOnce(async (_owner, _request, launch) => {
+      launches.push(launch!)
+      throw new Error('PTY unavailable')
+    })
+    await expect(client.open(1, input)).rejects.toThrow('PTY unavailable')
+    expect((await readdir(root)).filter(name => name.startsWith('launch-'))).toEqual([])
+    await expect(client.open(1, input)).resolves.toMatchObject({ state: 'running' })
+  })
+
+  it('uses Execute permissions and explicit session MCP endpoints', async () => {
+    const { client, input } = await fixture()
+    await client.open(1, { ...input, workMode: 'execute', mcpServers: [{ name: 'tools', url: 'http://127.0.0.1:12345/mcp', headers: { Authorization: 'Bearer local-token' } }] })
+    const launch = launches[0]!
+    const config = JSON.parse(launch.spawnSpec.env.OPENCODE_CONFIG_CONTENT!)
+    expect(config.permission).toBe('allow')
+    expect(config.mcp.tools.url).toBe('http://127.0.0.1:12345/mcp')
+    expect(await readFile(new URL(config.plugin[0]), 'utf8')).toContain('execute')
+  })
+})