Open History to see the last commit
1import type { IsolateDriver } from '@tanstack/ai-code-mode'
2
3export type IsolateVM = 'node' | 'quickjs' | 'quickjs-bun' | 'cloudflare'
4
5function isIsolateVM(value: unknown): value is IsolateVM {
6 return (
7 value === 'node' ||
8 value === 'quickjs' ||
9 value === 'quickjs-bun' ||
10 value === 'cloudflare'
11 )
12}
13
14/**
15 * Default isolate for this process.
16 *
17 * - `CODE_MODE_DEFAULT_VM=node|quickjs|quickjs-bun|cloudflare` overrides everything
18 * - `CODE_MODE_BUN=1` (or a real Bun runtime) → `quickjs-bun`
19 * - otherwise → `node`
20 *
21 * Client UI defaults use `import.meta.env.VITE_CODE_MODE_BUN` (set from the
22 * same flag in vite.config).
23 */
24export function getDefaultIsolateVM(): IsolateVM {
25 const fromEnv =
26 typeof process !== 'undefined'
27 ? process.env.CODE_MODE_DEFAULT_VM
28 : undefined
29 if (isIsolateVM(fromEnv)) {
30 return fromEnv
31 }
32
33 const bunMode =
34 (typeof process !== 'undefined' && process.env.CODE_MODE_BUN === '1') ||
35 typeof (globalThis as { Bun?: unknown }).Bun !== 'undefined'
36
37 return bunMode ? 'quickjs-bun' : 'node'
38}
39
40/** Client-safe default (Vite injects `VITE_CODE_MODE_BUN` from CODE_MODE_BUN). */
41export function getClientDefaultIsolateVM(): IsolateVM {
42 try {
43 if (isIsolateVM(import.meta.env.VITE_CODE_MODE_DEFAULT_VM)) {
44 return import.meta.env.VITE_CODE_MODE_DEFAULT_VM
45 }
46 if (import.meta.env.VITE_CODE_MODE_BUN === '1') {
47 return 'quickjs-bun'
48 }
49 } catch {
50 // import.meta.env may be unavailable outside Vite
51 }
52 return 'node'
53}
54
55const driverCache = new Map<IsolateVM, IsolateDriver>()
56
57export async function createIsolateDriver(
58 vm: IsolateVM = getDefaultIsolateVM(),
59): Promise<IsolateDriver> {
60 const cached = driverCache.get(vm)
61 if (cached) {
62 console.info(`[createIsolateDriver] reusing cached driver for vm=${vm}`)
63 return cached
64 }
65
66 let driver: IsolateDriver
67 let resolved: string
68
69 switch (vm) {
70 case 'quickjs': {
71 const { createQuickJSIsolateDriver } =
72 await import('@tanstack/ai-isolate-quickjs')
73 driver = createQuickJSIsolateDriver()
74 resolved = 'quickjs-wasm'
75 break
76 }
77 case 'quickjs-bun': {
78 // The native bun:ffi driver only loads under Bun. On a Node server (the
79 // default `pnpm dev` workflow) fall back to the WASM QuickJS driver with
80 // a warning instead of throwing an opaque createContext error, so the
81 // sidebar option degrades gracefully rather than breaking the request.
82 const isBun = typeof (globalThis as { Bun?: unknown }).Bun !== 'undefined'
83 if (isBun) {
84 const { createQuickJSBunIsolateDriver } =
85 await import('@tanstack/ai-isolate-quickjs-bun')
86 driver = createQuickJSBunIsolateDriver()
87 resolved = 'quickjs-bun-native'
88 } else {
89 console.warn(
90 '[createIsolateDriver] QuickJS Bun driver requires running the server under Bun; falling back to QuickJS (WASM).',
91 )
92 const { createQuickJSIsolateDriver } =
93 await import('@tanstack/ai-isolate-quickjs')
94 driver = createQuickJSIsolateDriver()
95 resolved =
96 'quickjs-wasm-fallback (requested quickjs-bun, no global Bun)'
97 }
98 break
99 }
100 case 'cloudflare': {
101 const { createCloudflareIsolateDriver } =
102 await import('@tanstack/ai-isolate-cloudflare')
103 driver = createCloudflareIsolateDriver({
104 workerUrl: process.env.CLOUDFLARE_WORKER_URL || 'http://localhost:8787',
105 authorization: process.env.CLOUDFLARE_WORKER_AUTH,
106 timeout: 60000,
107 })
108 resolved = 'cloudflare'
109 break
110 }
111 case 'node':
112 default: {
113 try {
114 const { createNodeIsolateDriver } =
115 await import('@tanstack/ai-isolate-node')
116 driver = createNodeIsolateDriver()
117 resolved = 'node-isolated-vm'
118 } catch (err) {
119 console.warn(
120 `[createIsolateDriver] Node isolate driver unavailable, falling back to QuickJS: ${err instanceof Error ? err.message : String(err)}`,
121 )
122 const { createQuickJSIsolateDriver } =
123 await import('@tanstack/ai-isolate-quickjs')
124 driver = createQuickJSIsolateDriver()
125 resolved = 'quickjs-wasm-fallback (node addon unavailable)'
126 }
127 break
128 }
129 }
130
131 const runtime =
132 typeof (globalThis as { Bun?: unknown }).Bun !== 'undefined'
133 ? 'bun'
134 : 'node'
135 console.info(
136 `[createIsolateDriver] vm=${vm} resolved=${resolved} serverRuntime=${runtime}`,
137 )
138
139 driverCache.set(vm, driver)
140 return driver
141}