@execbox/quickjs 0.2.1 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -4
- package/dist/index.cjs +543 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +15 -4
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.ts +15 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +543 -3
- package/dist/index.js.map +1 -1
- package/dist/processEntry.cjs +17 -0
- package/dist/processEntry.cjs.map +1 -0
- package/dist/processEntry.d.cts +5 -0
- package/dist/processEntry.d.ts +5 -0
- package/dist/processEntry.js +18 -0
- package/dist/processEntry.js.map +1 -0
- package/dist/protocolEndpoint-DGOUVf6J.cjs +147 -0
- package/dist/protocolEndpoint-DGOUVf6J.cjs.map +1 -0
- package/dist/protocolEndpoint-T_JEz8YY.js +142 -0
- package/dist/protocolEndpoint-T_JEz8YY.js.map +1 -0
- package/dist/runner/index.cjs +1 -1
- package/dist/runner/index.d.cts +10 -3
- package/dist/runner/index.d.cts.map +1 -1
- package/dist/runner/index.d.ts +10 -3
- package/dist/runner/index.d.ts.map +1 -1
- package/dist/runner/index.js +1 -1
- package/dist/runner/protocolEndpoint.cjs +3 -141
- package/dist/runner/protocolEndpoint.d.cts +1 -1
- package/dist/runner/protocolEndpoint.d.ts +1 -1
- package/dist/runner/protocolEndpoint.js +3 -141
- package/dist/{runner-CVaY4RVQ.js → runner-CteKTaPD.js} +28 -10
- package/dist/runner-CteKTaPD.js.map +1 -0
- package/dist/{runner-BqkDnP0t.cjs → runner-DRt0kpEk.cjs} +33 -9
- package/dist/{runner-CVaY4RVQ.js.map → runner-DRt0kpEk.cjs.map} +1 -1
- package/dist/types-BeVqrcj8.d.ts +71 -0
- package/dist/types-BeVqrcj8.d.ts.map +1 -0
- package/dist/types-CnNmLawC.d.cts +71 -0
- package/dist/types-CnNmLawC.d.cts.map +1 -0
- package/dist/workerEntry.cjs +19 -0
- package/dist/workerEntry.cjs.map +1 -0
- package/dist/workerEntry.d.cts +5 -0
- package/dist/workerEntry.d.ts +5 -0
- package/dist/workerEntry.js +20 -0
- package/dist/workerEntry.js.map +1 -0
- package/package.json +3 -4
- package/dist/runner/protocolEndpoint.cjs.map +0 -1
- package/dist/runner/protocolEndpoint.js.map +0 -1
- package/dist/runner-BqkDnP0t.cjs.map +0 -1
- package/dist/types-BXi8Lqtk.d.ts +0 -18
- package/dist/types-BXi8Lqtk.d.ts.map +0 -1
- package/dist/types-CVE2n2LY.d.cts +0 -18
- package/dist/types-CVE2n2LY.d.cts.map +0 -1
package/dist/index.js
CHANGED
|
@@ -1,4 +1,10 @@
|
|
|
1
|
-
import { a as
|
|
1
|
+
import { a as isJsonSerializable, c as getExecutionTimeoutMessage, i as isExecuteFailure, l as normalizeThrownMessage, n as resolveExecutorRuntimeOptions, o as createExecutionContext, r as ExecuteFailure, s as createTimeoutExecuteResult, t as runQuickJsSession } from "./runner-CteKTaPD.js";
|
|
2
|
+
import { fork } from "node:child_process";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
import { createResourcePool, getNodeTransportExecArgv, runHostTransportSession } from "@execbox/core/protocol";
|
|
5
|
+
import { randomUUID } from "node:crypto";
|
|
6
|
+
import { availableParallelism } from "node:os";
|
|
7
|
+
import { Worker } from "node:worker_threads";
|
|
2
8
|
|
|
3
9
|
//#region ../core/src/runner.ts
|
|
4
10
|
function toTrustedExecuteError(error) {
|
|
@@ -63,23 +69,557 @@ function createToolCallDispatcher(providers, signal) {
|
|
|
63
69
|
};
|
|
64
70
|
}
|
|
65
71
|
|
|
72
|
+
//#endregion
|
|
73
|
+
//#region src/hosted/shared.ts
|
|
74
|
+
/**
|
|
75
|
+
* Default grace period before a hosted shell is forcefully terminated.
|
|
76
|
+
*/
|
|
77
|
+
const DEFAULT_CANCEL_GRACE_MS = 25;
|
|
78
|
+
/**
|
|
79
|
+
* Default pooling limits shared by the hosted QuickJS executors.
|
|
80
|
+
*/
|
|
81
|
+
const DEFAULT_POOL_OPTIONS = {
|
|
82
|
+
idleTimeoutMs: 3e4,
|
|
83
|
+
maxSize: 1,
|
|
84
|
+
minSize: 0,
|
|
85
|
+
prewarm: false
|
|
86
|
+
};
|
|
87
|
+
/**
|
|
88
|
+
* Minimal code used to warm a hosted shell without touching user providers.
|
|
89
|
+
*/
|
|
90
|
+
const DEFAULT_PREWARM_CODE = "undefined";
|
|
91
|
+
/**
|
|
92
|
+
* Wraps a transport so warmup and pooled execution can borrow it without
|
|
93
|
+
* taking ownership of its lifecycle.
|
|
94
|
+
*/
|
|
95
|
+
function createBorrowedTransport(transport) {
|
|
96
|
+
return {
|
|
97
|
+
dispose() {},
|
|
98
|
+
onClose: transport.onClose,
|
|
99
|
+
onError: transport.onError,
|
|
100
|
+
onMessage: transport.onMessage,
|
|
101
|
+
send: transport.send,
|
|
102
|
+
terminate: transport.terminate
|
|
103
|
+
};
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Resolves how many pooled shells should be prewarmed from the pool settings.
|
|
107
|
+
*/
|
|
108
|
+
function getPrewarmCount(pool) {
|
|
109
|
+
if (!pool?.prewarm) return 0;
|
|
110
|
+
if (typeof pool.prewarm === "number") return Math.max(0, Math.min(pool.prewarm, pool.maxSize));
|
|
111
|
+
return Math.max(1, Math.min(pool.minSize ?? 1, pool.maxSize));
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Caps an explicit warmup request to the configured pool boundaries.
|
|
115
|
+
*/
|
|
116
|
+
function getWarmupTarget(count, poolOptions) {
|
|
117
|
+
return Math.max(0, Math.min(count ?? poolOptions.minSize ?? 0, poolOptions.maxSize));
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Returns whether a hosted execution result is safe to return to a pool.
|
|
121
|
+
*/
|
|
122
|
+
function isReusableResult(result) {
|
|
123
|
+
return result.ok || !["internal_error", "timeout"].includes(result.error.code);
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Normalizes a failed warmup result into an actionable host-side error.
|
|
127
|
+
*/
|
|
128
|
+
function toWarmupError(label, result) {
|
|
129
|
+
if (result.ok) return /* @__PURE__ */ new Error(`Failed to prewarm pooled ${label}`);
|
|
130
|
+
return /* @__PURE__ */ new Error(`Failed to prewarm pooled ${label}: ${result.error.message}`);
|
|
131
|
+
}
|
|
132
|
+
/**
|
|
133
|
+
* Runs one transport-backed execution session with resolved runtime limits and
|
|
134
|
+
* a fresh execution identifier.
|
|
135
|
+
*/
|
|
136
|
+
async function runHostedTransportSession(options) {
|
|
137
|
+
return await runHostTransportSession({
|
|
138
|
+
cancelGraceMs: options.cancelGraceMs,
|
|
139
|
+
code: options.code,
|
|
140
|
+
executionId: randomUUID(),
|
|
141
|
+
onSettled: options.onSettled,
|
|
142
|
+
providers: options.providers,
|
|
143
|
+
runtimeOptions: resolveExecutorRuntimeOptions(options.executorOptions, options.requestOptions),
|
|
144
|
+
signal: options.requestOptions?.signal,
|
|
145
|
+
transport: options.transport
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* Exercises a set of leased shells with a warmup run and releases each lease
|
|
150
|
+
* according to the warmup result.
|
|
151
|
+
*/
|
|
152
|
+
async function warmHostedPool(options) {
|
|
153
|
+
const rejected = (await Promise.allSettled(options.shells.map(async (shell) => {
|
|
154
|
+
let reusable = false;
|
|
155
|
+
try {
|
|
156
|
+
const result = await options.runSession(createBorrowedTransport(options.getTransport(shell)), DEFAULT_PREWARM_CODE, []);
|
|
157
|
+
reusable = result.ok;
|
|
158
|
+
if (!result.ok) throw toWarmupError(options.label, result);
|
|
159
|
+
} finally {
|
|
160
|
+
await options.onRelease(shell, reusable);
|
|
161
|
+
}
|
|
162
|
+
}))).find((result) => result.status === "rejected");
|
|
163
|
+
if (rejected?.status === "rejected") throw rejected.reason;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
//#endregion
|
|
167
|
+
//#region src/hosted/processHostedExecutor.ts
|
|
168
|
+
function resolveProcessEntryPath() {
|
|
169
|
+
const extension = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
|
|
170
|
+
return fileURLToPath(new URL(`../processEntry${extension}`, import.meta.url));
|
|
171
|
+
}
|
|
172
|
+
function createUnexpectedExitMessage(code, signal) {
|
|
173
|
+
if (code !== null) return `Child process exited unexpectedly with code ${code}`;
|
|
174
|
+
if (signal) return `Child process exited unexpectedly with signal ${signal}`;
|
|
175
|
+
return "Child process exited unexpectedly";
|
|
176
|
+
}
|
|
177
|
+
function createChildProcess() {
|
|
178
|
+
return fork(resolveProcessEntryPath(), [], {
|
|
179
|
+
execArgv: getNodeTransportExecArgv(import.meta.url),
|
|
180
|
+
stdio: [
|
|
181
|
+
"ignore",
|
|
182
|
+
"ignore",
|
|
183
|
+
"ignore",
|
|
184
|
+
"ipc"
|
|
185
|
+
]
|
|
186
|
+
});
|
|
187
|
+
}
|
|
188
|
+
function createProcessTransport(child) {
|
|
189
|
+
let terminated = false;
|
|
190
|
+
let closeReason;
|
|
191
|
+
const closeHandlers = /* @__PURE__ */ new Set();
|
|
192
|
+
const errorHandlers = /* @__PURE__ */ new Set();
|
|
193
|
+
const messageHandlers = /* @__PURE__ */ new Set();
|
|
194
|
+
const terminateChild = () => {
|
|
195
|
+
if (terminated) return;
|
|
196
|
+
terminated = true;
|
|
197
|
+
child.kill("SIGKILL");
|
|
198
|
+
};
|
|
199
|
+
const notifyClose = (reason) => {
|
|
200
|
+
if (closeReason) return;
|
|
201
|
+
closeReason = reason;
|
|
202
|
+
for (const handler of closeHandlers) handler(reason);
|
|
203
|
+
};
|
|
204
|
+
const onDisconnect = () => {
|
|
205
|
+
notifyClose({ message: "Child process disconnected unexpectedly" });
|
|
206
|
+
};
|
|
207
|
+
const onExit = (code, signal) => {
|
|
208
|
+
notifyClose({
|
|
209
|
+
code,
|
|
210
|
+
message: createUnexpectedExitMessage(code, signal),
|
|
211
|
+
signal
|
|
212
|
+
});
|
|
213
|
+
};
|
|
214
|
+
const onError = (error) => {
|
|
215
|
+
for (const handler of errorHandlers) handler(error);
|
|
216
|
+
};
|
|
217
|
+
const onMessage = (message) => {
|
|
218
|
+
for (const handler of messageHandlers) handler(message);
|
|
219
|
+
};
|
|
220
|
+
child.on("disconnect", onDisconnect);
|
|
221
|
+
child.on("exit", onExit);
|
|
222
|
+
child.on("error", onError);
|
|
223
|
+
child.on("message", onMessage);
|
|
224
|
+
return {
|
|
225
|
+
dispose: () => {
|
|
226
|
+
child.off("disconnect", onDisconnect);
|
|
227
|
+
child.off("exit", onExit);
|
|
228
|
+
child.off("error", onError);
|
|
229
|
+
child.off("message", onMessage);
|
|
230
|
+
terminateChild();
|
|
231
|
+
},
|
|
232
|
+
onClose: (handler) => {
|
|
233
|
+
closeHandlers.add(handler);
|
|
234
|
+
if (closeReason) queueMicrotask(() => {
|
|
235
|
+
if (closeHandlers.has(handler)) handler(closeReason);
|
|
236
|
+
});
|
|
237
|
+
return () => {
|
|
238
|
+
closeHandlers.delete(handler);
|
|
239
|
+
};
|
|
240
|
+
},
|
|
241
|
+
onError: (handler) => {
|
|
242
|
+
errorHandlers.add(handler);
|
|
243
|
+
return () => errorHandlers.delete(handler);
|
|
244
|
+
},
|
|
245
|
+
onMessage: (handler) => {
|
|
246
|
+
messageHandlers.add(handler);
|
|
247
|
+
return () => messageHandlers.delete(handler);
|
|
248
|
+
},
|
|
249
|
+
send: (message) => new Promise((resolve, reject) => {
|
|
250
|
+
if (!child.connected || typeof child.send !== "function") {
|
|
251
|
+
reject(/* @__PURE__ */ new Error("Child process disconnected unexpectedly"));
|
|
252
|
+
return;
|
|
253
|
+
}
|
|
254
|
+
child.send(message, (error) => {
|
|
255
|
+
if (error) {
|
|
256
|
+
reject(error);
|
|
257
|
+
return;
|
|
258
|
+
}
|
|
259
|
+
resolve();
|
|
260
|
+
});
|
|
261
|
+
}),
|
|
262
|
+
terminate: () => {
|
|
263
|
+
terminateChild();
|
|
264
|
+
}
|
|
265
|
+
};
|
|
266
|
+
}
|
|
267
|
+
function createProcessShell() {
|
|
268
|
+
const child = createChildProcess();
|
|
269
|
+
return {
|
|
270
|
+
child,
|
|
271
|
+
transport: createProcessTransport(child)
|
|
272
|
+
};
|
|
273
|
+
}
|
|
274
|
+
function resolvePoolOptions$1(options) {
|
|
275
|
+
if (options.mode === "ephemeral") return;
|
|
276
|
+
return {
|
|
277
|
+
...DEFAULT_POOL_OPTIONS,
|
|
278
|
+
...options.pool
|
|
279
|
+
};
|
|
280
|
+
}
|
|
281
|
+
/**
|
|
282
|
+
* Child-process executor that runs guest code inside a dedicated QuickJS runtime per call.
|
|
283
|
+
*/
|
|
284
|
+
var ProcessHostedQuickJsExecutor = class {
|
|
285
|
+
cancelGraceMs;
|
|
286
|
+
options;
|
|
287
|
+
pool;
|
|
288
|
+
poolOptions;
|
|
289
|
+
warmup;
|
|
290
|
+
/**
|
|
291
|
+
* Creates a hosted QuickJS executor that launches child-process shells on demand.
|
|
292
|
+
*/
|
|
293
|
+
constructor(options) {
|
|
294
|
+
this.cancelGraceMs = options.cancelGraceMs ?? DEFAULT_CANCEL_GRACE_MS;
|
|
295
|
+
this.options = options;
|
|
296
|
+
const poolOptions = resolvePoolOptions$1(options);
|
|
297
|
+
this.poolOptions = poolOptions;
|
|
298
|
+
if (poolOptions) {
|
|
299
|
+
this.pool = createResourcePool({
|
|
300
|
+
create: async () => createProcessShell(),
|
|
301
|
+
destroy: async (shell) => {
|
|
302
|
+
await shell.transport.dispose();
|
|
303
|
+
},
|
|
304
|
+
idleTimeoutMs: poolOptions.idleTimeoutMs,
|
|
305
|
+
maxSize: poolOptions.maxSize,
|
|
306
|
+
minSize: poolOptions.minSize
|
|
307
|
+
});
|
|
308
|
+
const prewarmCount = getPrewarmCount(poolOptions);
|
|
309
|
+
if (prewarmCount > 0) this.warmup = this.warmPool(prewarmCount);
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
/**
|
|
313
|
+
* Disposes any pooled child-process shells owned by this executor.
|
|
314
|
+
*/
|
|
315
|
+
async dispose() {
|
|
316
|
+
await this.pool?.dispose();
|
|
317
|
+
}
|
|
318
|
+
/**
|
|
319
|
+
* Prewarms pooled child-process shells up to the requested count.
|
|
320
|
+
*/
|
|
321
|
+
async prewarm(count) {
|
|
322
|
+
if (!this.pool || !this.poolOptions) return;
|
|
323
|
+
const target = getWarmupTarget(count, this.poolOptions);
|
|
324
|
+
if (target <= 0) return;
|
|
325
|
+
await this.warmPool(target);
|
|
326
|
+
}
|
|
327
|
+
async runTransportSession(transport, code, providers, options = {}, onSettled) {
|
|
328
|
+
return await runHostedTransportSession({
|
|
329
|
+
cancelGraceMs: this.cancelGraceMs,
|
|
330
|
+
code,
|
|
331
|
+
executorOptions: this.options,
|
|
332
|
+
onSettled,
|
|
333
|
+
providers,
|
|
334
|
+
requestOptions: options,
|
|
335
|
+
transport
|
|
336
|
+
});
|
|
337
|
+
}
|
|
338
|
+
async warmPool(count) {
|
|
339
|
+
if (!this.pool) return;
|
|
340
|
+
await this.pool.prewarm(count);
|
|
341
|
+
const leases = [];
|
|
342
|
+
try {
|
|
343
|
+
for (let index = 0; index < count; index += 1) leases.push(await this.pool.acquire());
|
|
344
|
+
} catch (error) {
|
|
345
|
+
await Promise.allSettled(leases.map(async (lease) => await lease.release(false)));
|
|
346
|
+
throw error;
|
|
347
|
+
}
|
|
348
|
+
await warmHostedPool({
|
|
349
|
+
count,
|
|
350
|
+
getTransport: (lease) => lease.value.transport,
|
|
351
|
+
label: "child process",
|
|
352
|
+
onRelease: async (lease, reusable) => await lease.release(reusable),
|
|
353
|
+
runSession: async (transport, code, providers) => await this.runTransportSession(transport, code, providers),
|
|
354
|
+
shells: leases
|
|
355
|
+
});
|
|
356
|
+
}
|
|
357
|
+
/**
|
|
358
|
+
* Executes guest code in a child-process-hosted QuickJS shell.
|
|
359
|
+
*/
|
|
360
|
+
async execute(code, providers, options = {}) {
|
|
361
|
+
if (options.signal?.aborted) return createTimeoutExecuteResult();
|
|
362
|
+
await this.warmup;
|
|
363
|
+
if (this.pool) {
|
|
364
|
+
const lease = await this.pool.acquire();
|
|
365
|
+
return await this.runTransportSession(createBorrowedTransport(lease.value.transport), code, providers, options, async (result) => {
|
|
366
|
+
await lease.release(isReusableResult(result));
|
|
367
|
+
});
|
|
368
|
+
}
|
|
369
|
+
let child;
|
|
370
|
+
try {
|
|
371
|
+
child = createChildProcess();
|
|
372
|
+
} catch (error) {
|
|
373
|
+
return {
|
|
374
|
+
durationMs: 0,
|
|
375
|
+
error: {
|
|
376
|
+
code: "internal_error",
|
|
377
|
+
message: error instanceof Error ? error.message : String(error)
|
|
378
|
+
},
|
|
379
|
+
logs: [],
|
|
380
|
+
ok: false
|
|
381
|
+
};
|
|
382
|
+
}
|
|
383
|
+
return await this.runTransportSession(createProcessTransport(child), code, providers, options);
|
|
384
|
+
}
|
|
385
|
+
};
|
|
386
|
+
|
|
387
|
+
//#endregion
|
|
388
|
+
//#region src/hosted/workerHostedExecutor.ts
|
|
389
|
+
const DEFAULT_POOLED_WORKER_MAX_SIZE = 4;
|
|
390
|
+
function resolveWorkerEntryUrl() {
|
|
391
|
+
const extension = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
|
|
392
|
+
return new URL(`../workerEntry${extension}`, import.meta.url);
|
|
393
|
+
}
|
|
394
|
+
function createWorkerTransport(worker) {
|
|
395
|
+
let terminated = false;
|
|
396
|
+
let closeReason;
|
|
397
|
+
const closeHandlers = /* @__PURE__ */ new Set();
|
|
398
|
+
const errorHandlers = /* @__PURE__ */ new Set();
|
|
399
|
+
const messageHandlers = /* @__PURE__ */ new Set();
|
|
400
|
+
const terminateWorker = async () => {
|
|
401
|
+
if (terminated) return;
|
|
402
|
+
terminated = true;
|
|
403
|
+
await worker.terminate().catch(() => {});
|
|
404
|
+
};
|
|
405
|
+
const notifyClose = (reason) => {
|
|
406
|
+
if (closeReason) return;
|
|
407
|
+
closeReason = reason;
|
|
408
|
+
for (const handler of closeHandlers) handler(reason);
|
|
409
|
+
};
|
|
410
|
+
const onExit = (code) => {
|
|
411
|
+
notifyClose({
|
|
412
|
+
code,
|
|
413
|
+
message: `Worker exited unexpectedly with code ${code}`
|
|
414
|
+
});
|
|
415
|
+
};
|
|
416
|
+
const onError = (error) => {
|
|
417
|
+
for (const handler of errorHandlers) handler(error);
|
|
418
|
+
};
|
|
419
|
+
const onMessage = (message) => {
|
|
420
|
+
for (const handler of messageHandlers) handler(message);
|
|
421
|
+
};
|
|
422
|
+
worker.on("exit", onExit);
|
|
423
|
+
worker.on("error", onError);
|
|
424
|
+
worker.on("message", onMessage);
|
|
425
|
+
return {
|
|
426
|
+
dispose: async () => {
|
|
427
|
+
worker.off("exit", onExit);
|
|
428
|
+
worker.off("error", onError);
|
|
429
|
+
worker.off("message", onMessage);
|
|
430
|
+
await terminateWorker();
|
|
431
|
+
},
|
|
432
|
+
onClose: (handler) => {
|
|
433
|
+
closeHandlers.add(handler);
|
|
434
|
+
if (closeReason) queueMicrotask(() => {
|
|
435
|
+
if (closeHandlers.has(handler)) handler(closeReason);
|
|
436
|
+
});
|
|
437
|
+
return () => closeHandlers.delete(handler);
|
|
438
|
+
},
|
|
439
|
+
onError: (handler) => {
|
|
440
|
+
errorHandlers.add(handler);
|
|
441
|
+
return () => errorHandlers.delete(handler);
|
|
442
|
+
},
|
|
443
|
+
onMessage: (handler) => {
|
|
444
|
+
messageHandlers.add(handler);
|
|
445
|
+
return () => messageHandlers.delete(handler);
|
|
446
|
+
},
|
|
447
|
+
send: (message) => {
|
|
448
|
+
worker.postMessage(message);
|
|
449
|
+
},
|
|
450
|
+
terminate: async () => {
|
|
451
|
+
await terminateWorker();
|
|
452
|
+
}
|
|
453
|
+
};
|
|
454
|
+
}
|
|
455
|
+
function createWorkerShell(options) {
|
|
456
|
+
const worker = new Worker(resolveWorkerEntryUrl(), {
|
|
457
|
+
execArgv: getNodeTransportExecArgv(import.meta.url),
|
|
458
|
+
resourceLimits: options.workerResourceLimits
|
|
459
|
+
});
|
|
460
|
+
return {
|
|
461
|
+
transport: createWorkerTransport(worker),
|
|
462
|
+
worker
|
|
463
|
+
};
|
|
464
|
+
}
|
|
465
|
+
function getDefaultPoolMaxSize() {
|
|
466
|
+
try {
|
|
467
|
+
return Math.max(1, Math.min(availableParallelism(), DEFAULT_POOLED_WORKER_MAX_SIZE));
|
|
468
|
+
} catch {
|
|
469
|
+
return 1;
|
|
470
|
+
}
|
|
471
|
+
}
|
|
472
|
+
function resolvePoolOptions(options) {
|
|
473
|
+
if (options.mode === "ephemeral") return;
|
|
474
|
+
return {
|
|
475
|
+
...DEFAULT_POOL_OPTIONS,
|
|
476
|
+
maxSize: getDefaultPoolMaxSize(),
|
|
477
|
+
...options.pool
|
|
478
|
+
};
|
|
479
|
+
}
|
|
480
|
+
/**
|
|
481
|
+
* Worker-thread executor that runs guest code inside a dedicated QuickJS runtime per call.
|
|
482
|
+
*/
|
|
483
|
+
var WorkerHostedQuickJsExecutor = class {
|
|
484
|
+
cancelGraceMs;
|
|
485
|
+
options;
|
|
486
|
+
pool;
|
|
487
|
+
poolOptions;
|
|
488
|
+
warmup;
|
|
489
|
+
/**
|
|
490
|
+
* Creates a hosted QuickJS executor that launches worker-thread shells on demand.
|
|
491
|
+
*/
|
|
492
|
+
constructor(options) {
|
|
493
|
+
this.cancelGraceMs = options.cancelGraceMs ?? DEFAULT_CANCEL_GRACE_MS;
|
|
494
|
+
this.options = options;
|
|
495
|
+
const poolOptions = resolvePoolOptions(options);
|
|
496
|
+
this.poolOptions = poolOptions;
|
|
497
|
+
if (poolOptions) {
|
|
498
|
+
this.pool = createResourcePool({
|
|
499
|
+
create: async () => createWorkerShell(options),
|
|
500
|
+
destroy: async (shell) => {
|
|
501
|
+
await shell.transport.dispose();
|
|
502
|
+
},
|
|
503
|
+
idleTimeoutMs: poolOptions.idleTimeoutMs,
|
|
504
|
+
maxSize: poolOptions.maxSize,
|
|
505
|
+
minSize: poolOptions.minSize
|
|
506
|
+
});
|
|
507
|
+
const prewarmCount = getPrewarmCount(poolOptions);
|
|
508
|
+
if (prewarmCount > 0) this.warmup = this.warmPool(prewarmCount);
|
|
509
|
+
}
|
|
510
|
+
}
|
|
511
|
+
/**
|
|
512
|
+
* Disposes any pooled worker-thread shells owned by this executor.
|
|
513
|
+
*/
|
|
514
|
+
async dispose() {
|
|
515
|
+
await this.pool?.dispose();
|
|
516
|
+
}
|
|
517
|
+
/**
|
|
518
|
+
* Prewarms pooled worker-thread shells up to the requested count.
|
|
519
|
+
*/
|
|
520
|
+
async prewarm(count) {
|
|
521
|
+
if (!this.pool || !this.poolOptions) return;
|
|
522
|
+
const target = getWarmupTarget(count, this.poolOptions);
|
|
523
|
+
if (target <= 0) return;
|
|
524
|
+
await this.warmPool(target);
|
|
525
|
+
}
|
|
526
|
+
async runTransportSession(transport, code, providers, options = {}, onSettled) {
|
|
527
|
+
return await runHostedTransportSession({
|
|
528
|
+
cancelGraceMs: this.cancelGraceMs,
|
|
529
|
+
code,
|
|
530
|
+
executorOptions: this.options,
|
|
531
|
+
onSettled,
|
|
532
|
+
providers,
|
|
533
|
+
requestOptions: options,
|
|
534
|
+
transport
|
|
535
|
+
});
|
|
536
|
+
}
|
|
537
|
+
async warmPool(count) {
|
|
538
|
+
if (!this.pool) return;
|
|
539
|
+
await this.pool.prewarm(count);
|
|
540
|
+
const leases = [];
|
|
541
|
+
try {
|
|
542
|
+
for (let index = 0; index < count; index += 1) leases.push(await this.pool.acquire());
|
|
543
|
+
} catch (error) {
|
|
544
|
+
await Promise.allSettled(leases.map(async (lease) => await lease.release(false)));
|
|
545
|
+
throw error;
|
|
546
|
+
}
|
|
547
|
+
await warmHostedPool({
|
|
548
|
+
count,
|
|
549
|
+
getTransport: (lease) => lease.value.transport,
|
|
550
|
+
label: "worker shell",
|
|
551
|
+
onRelease: async (lease, reusable) => await lease.release(reusable),
|
|
552
|
+
runSession: async (transport, code, providers) => await this.runTransportSession(transport, code, providers),
|
|
553
|
+
shells: leases
|
|
554
|
+
});
|
|
555
|
+
}
|
|
556
|
+
/**
|
|
557
|
+
* Executes guest code in a worker-thread-hosted QuickJS shell.
|
|
558
|
+
*/
|
|
559
|
+
async execute(code, providers, options = {}) {
|
|
560
|
+
if (options.signal?.aborted) return createTimeoutExecuteResult();
|
|
561
|
+
await this.warmup;
|
|
562
|
+
if (this.pool) {
|
|
563
|
+
const lease = await this.pool.acquire();
|
|
564
|
+
return await this.runTransportSession(createBorrowedTransport(lease.value.transport), code, providers, options, async (result) => {
|
|
565
|
+
await lease.release(isReusableResult(result));
|
|
566
|
+
});
|
|
567
|
+
}
|
|
568
|
+
const worker = new Worker(resolveWorkerEntryUrl(), {
|
|
569
|
+
execArgv: getNodeTransportExecArgv(import.meta.url),
|
|
570
|
+
resourceLimits: this.options.workerResourceLimits
|
|
571
|
+
});
|
|
572
|
+
return await this.runTransportSession(createWorkerTransport(worker), code, providers, options);
|
|
573
|
+
}
|
|
574
|
+
};
|
|
575
|
+
|
|
66
576
|
//#endregion
|
|
67
577
|
//#region src/quickjsExecutor.ts
|
|
578
|
+
function isWorkerOptions(options) {
|
|
579
|
+
return options.host === "worker";
|
|
580
|
+
}
|
|
581
|
+
function isProcessOptions(options) {
|
|
582
|
+
return options.host === "process";
|
|
583
|
+
}
|
|
68
584
|
/**
|
|
69
|
-
* QuickJS-backed executor for
|
|
585
|
+
* QuickJS-backed executor for inline, worker-backed, or process-backed JavaScript runs.
|
|
70
586
|
*/
|
|
71
587
|
var QuickJsExecutor = class {
|
|
588
|
+
hostedExecutor;
|
|
72
589
|
options;
|
|
73
590
|
/**
|
|
74
|
-
* Creates a QuickJS executor with
|
|
591
|
+
* Creates a QuickJS executor with inline QuickJS by default, or a hosted
|
|
592
|
+
* worker/process shell when `host` is explicitly set.
|
|
75
593
|
*/
|
|
76
594
|
constructor(options = {}) {
|
|
595
|
+
if (isWorkerOptions(options)) {
|
|
596
|
+
this.hostedExecutor = new WorkerHostedQuickJsExecutor(options);
|
|
597
|
+
return;
|
|
598
|
+
}
|
|
599
|
+
if (isProcessOptions(options)) {
|
|
600
|
+
this.hostedExecutor = new ProcessHostedQuickJsExecutor(options);
|
|
601
|
+
return;
|
|
602
|
+
}
|
|
77
603
|
this.options = options;
|
|
78
604
|
}
|
|
79
605
|
/**
|
|
606
|
+
* Disposes any pooled hosted shells owned by this executor.
|
|
607
|
+
*/
|
|
608
|
+
async dispose() {
|
|
609
|
+
await this.hostedExecutor?.dispose?.();
|
|
610
|
+
}
|
|
611
|
+
/**
|
|
612
|
+
* Prewarms pooled hosted shells when the executor is running in worker or
|
|
613
|
+
* process mode. Inline mode treats this as a no-op.
|
|
614
|
+
*/
|
|
615
|
+
async prewarm(count) {
|
|
616
|
+
await this.hostedExecutor?.prewarm?.(count);
|
|
617
|
+
}
|
|
618
|
+
/**
|
|
80
619
|
* Executes JavaScript against the provided tool namespaces in a fresh QuickJS runtime.
|
|
81
620
|
*/
|
|
82
621
|
async execute(code, providers, options = {}) {
|
|
622
|
+
if (this.hostedExecutor) return await this.hostedExecutor.execute(code, providers, options);
|
|
83
623
|
if (options.signal?.aborted) return createTimeoutExecuteResult();
|
|
84
624
|
const abortController = new AbortController();
|
|
85
625
|
const onToolCall = createToolCallDispatcher(providers, abortController.signal);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../../core/src/runner.ts","../src/quickjsExecutor.ts"],"sourcesContent":["import {\n createExecutionContext,\n getExecutionTimeoutMessage,\n normalizeThrownMessage,\n} from \"./executor/shared.ts\";\nimport {\n ExecuteFailure,\n isExecuteFailure,\n isJsonSerializable,\n} from \"./errors.ts\";\nimport type { ExecuteError, ResolvedToolProvider } from \"./types.ts\";\n\n/**\n * Transport-safe metadata for one exposed tool.\n */\nexport interface ProviderToolManifest {\n description?: string;\n originalName: string;\n safeName: string;\n}\n\n/**\n * Namespace manifest shared with runner implementations.\n */\nexport interface ProviderManifest {\n name: string;\n tools: Record<string, ProviderToolManifest>;\n types: string;\n}\n\n/**\n * Execution limits forwarded to runner implementations.\n */\nexport interface ExecutorRuntimeOptions {\n maxLogChars?: number;\n maxLogLines?: number;\n memoryLimitBytes?: number;\n timeoutMs?: number;\n}\n\n/**\n * Public execution options accepted by executors per call.\n */\nexport interface ExecutionOptions extends ExecutorRuntimeOptions {\n signal?: AbortSignal;\n}\n\n/**\n * Tool invocation request emitted from a runner.\n */\nexport interface ToolCall {\n input: unknown;\n providerName: string;\n safeToolName: string;\n}\n\n/**\n * Trusted host response to a tool invocation request.\n */\nexport type ToolCallResult =\n | {\n ok: true;\n result: unknown;\n }\n | {\n error: ExecuteError;\n ok: false;\n };\n\nfunction toTrustedExecuteError(error: unknown): ExecuteError {\n if (isExecuteFailure(error)) {\n return {\n code: error.code,\n message: error.message,\n };\n }\n\n return {\n code: \"tool_error\",\n message: normalizeThrownMessage(error),\n };\n}\n\n/**\n * Converts resolved providers into manifest metadata that reveals only namespace details.\n */\nexport function extractProviderManifests(\n providers: ResolvedToolProvider[],\n): ProviderManifest[] {\n return providers.map((provider) => ({\n name: provider.name,\n tools: Object.fromEntries(\n Object.entries(provider.tools).map(([safeToolName, descriptor]) => [\n safeToolName,\n {\n description: descriptor.description,\n originalName: descriptor.originalName,\n safeName: descriptor.safeName,\n },\n ]),\n ),\n types: provider.types,\n }));\n}\n\n/**\n * Creates a host-side dispatcher for runner-emitted tool calls.\n */\nexport function createToolCallDispatcher(\n providers: ResolvedToolProvider[],\n signal: AbortSignal,\n): (call: ToolCall) => Promise<ToolCallResult> {\n const providerMap = new Map(\n providers.map((provider) => [provider.name, provider] as const),\n );\n\n return async (call) => {\n const provider = providerMap.get(call.providerName);\n const descriptor = provider?.tools[call.safeToolName];\n\n if (!provider || !descriptor) {\n return {\n error: {\n code: \"internal_error\",\n message: `Unknown tool ${call.providerName}.${call.safeToolName}`,\n },\n ok: false,\n };\n }\n\n try {\n if (signal.aborted) {\n return {\n error: {\n code: \"timeout\",\n message: getExecutionTimeoutMessage(),\n },\n ok: false,\n };\n }\n\n const result = await descriptor.execute(\n call.input,\n createExecutionContext(\n signal,\n provider.name,\n descriptor.safeName,\n descriptor.originalName,\n ),\n );\n\n if (result !== undefined && !isJsonSerializable(result)) {\n throw new ExecuteFailure(\n \"serialization_error\",\n \"Host value is not JSON-serializable\",\n );\n }\n\n return {\n ok: true,\n result,\n };\n } catch (error) {\n return {\n error: toTrustedExecuteError(error),\n ok: false,\n };\n }\n };\n}\n","import {\n createTimeoutExecuteResult,\n createToolCallDispatcher,\n extractProviderManifests,\n} from \"../../core/src/runtime.ts\";\nimport type {\n ExecutionOptions,\n ExecuteResult,\n Executor,\n ResolvedToolProvider,\n} from \"@execbox/core\";\n\nimport { runQuickJsSession } from \"./runner/index.ts\";\nimport type { QuickJsExecutorOptions } from \"./types\";\n\n/**\n * QuickJS-backed executor for ephemeral sandboxed JavaScript runs.\n */\nexport class QuickJsExecutor implements Executor {\n private readonly options: QuickJsExecutorOptions;\n\n /**\n * Creates a QuickJS executor with ephemeral runtime limits and host bridging configuration.\n */\n constructor(options: QuickJsExecutorOptions = {}) {\n this.options = options;\n }\n\n /**\n * Executes JavaScript against the provided tool namespaces in a fresh QuickJS runtime.\n */\n async execute(\n code: string,\n providers: ResolvedToolProvider[],\n options: ExecutionOptions = {},\n ): Promise<ExecuteResult> {\n if (options.signal?.aborted) {\n return createTimeoutExecuteResult();\n }\n\n const abortController = new AbortController();\n const onToolCall = createToolCallDispatcher(\n providers,\n abortController.signal,\n );\n const onAbort = () => {\n abortController.abort();\n };\n\n options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n try {\n return await runQuickJsSession(\n {\n abortController,\n code,\n onToolCall,\n providers: extractProviderManifests(providers),\n },\n {\n ...this.options,\n ...options,\n },\n );\n } finally {\n options.signal?.removeEventListener(\"abort\", onAbort);\n abortController.abort();\n }\n }\n}\n"],"mappings":";;;AAqEA,SAAS,sBAAsB,OAA8B;AAC3D,KAAI,iBAAiB,MAAM,CACzB,QAAO;EACL,MAAM,MAAM;EACZ,SAAS,MAAM;EAChB;AAGH,QAAO;EACL,MAAM;EACN,SAAS,uBAAuB,MAAM;EACvC;;;;;AAMH,SAAgB,yBACd,WACoB;AACpB,QAAO,UAAU,KAAK,cAAc;EAClC,MAAM,SAAS;EACf,OAAO,OAAO,YACZ,OAAO,QAAQ,SAAS,MAAM,CAAC,KAAK,CAAC,cAAc,gBAAgB,CACjE,cACA;GACE,aAAa,WAAW;GACxB,cAAc,WAAW;GACzB,UAAU,WAAW;GACtB,CACF,CAAC,CACH;EACD,OAAO,SAAS;EACjB,EAAE;;;;;AAML,SAAgB,yBACd,WACA,QAC6C;CAC7C,MAAM,cAAc,IAAI,IACtB,UAAU,KAAK,aAAa,CAAC,SAAS,MAAM,SAAS,CAAU,CAChE;AAED,QAAO,OAAO,SAAS;EACrB,MAAM,WAAW,YAAY,IAAI,KAAK,aAAa;EACnD,MAAM,aAAa,UAAU,MAAM,KAAK;AAExC,MAAI,CAAC,YAAY,CAAC,WAChB,QAAO;GACL,OAAO;IACL,MAAM;IACN,SAAS,gBAAgB,KAAK,aAAa,GAAG,KAAK;IACpD;GACD,IAAI;GACL;AAGH,MAAI;AACF,OAAI,OAAO,QACT,QAAO;IACL,OAAO;KACL,MAAM;KACN,SAAS,4BAA4B;KACtC;IACD,IAAI;IACL;GAGH,MAAM,SAAS,MAAM,WAAW,QAC9B,KAAK,OACL,uBACE,QACA,SAAS,MACT,WAAW,UACX,WAAW,aACZ,CACF;AAED,OAAI,WAAW,UAAa,CAAC,mBAAmB,OAAO,CACrD,OAAM,IAAI,eACR,uBACA,sCACD;AAGH,UAAO;IACL,IAAI;IACJ;IACD;WACM,OAAO;AACd,UAAO;IACL,OAAO,sBAAsB,MAAM;IACnC,IAAI;IACL;;;;;;;;;;ACpJP,IAAa,kBAAb,MAAiD;CAC/C,AAAiB;;;;CAKjB,YAAY,UAAkC,EAAE,EAAE;AAChD,OAAK,UAAU;;;;;CAMjB,MAAM,QACJ,MACA,WACA,UAA4B,EAAE,EACN;AACxB,MAAI,QAAQ,QAAQ,QAClB,QAAO,4BAA4B;EAGrC,MAAM,kBAAkB,IAAI,iBAAiB;EAC7C,MAAM,aAAa,yBACjB,WACA,gBAAgB,OACjB;EACD,MAAM,gBAAgB;AACpB,mBAAgB,OAAO;;AAGzB,UAAQ,QAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM,CAAC;AAElE,MAAI;AACF,UAAO,MAAM,kBACX;IACE;IACA;IACA;IACA,WAAW,yBAAyB,UAAU;IAC/C,EACD;IACE,GAAG,KAAK;IACR,GAAG;IACJ,CACF;YACO;AACR,WAAQ,QAAQ,oBAAoB,SAAS,QAAQ;AACrD,mBAAgB,OAAO"}
|
|
1
|
+
{"version":3,"file":"index.js","names":["DEFAULT_POOL_OPTIONS: Required<ExecutorPoolOptions>","closeReason: TransportCloseReason | undefined","resolvePoolOptions","leases: Array<{\n release: (reusable: boolean) => Promise<void>;\n value: ProcessShell;\n }>","child: ChildProcess","closeReason: TransportCloseReason | undefined","leases: Array<{\n release: (reusable: boolean) => Promise<void>;\n value: WorkerShell;\n }>"],"sources":["../../core/src/runner.ts","../src/hosted/shared.ts","../src/hosted/processHostedExecutor.ts","../src/hosted/workerHostedExecutor.ts","../src/quickjsExecutor.ts"],"sourcesContent":["import {\n createExecutionContext,\n getExecutionTimeoutMessage,\n normalizeThrownMessage,\n} from \"./executor/shared.ts\";\nimport {\n ExecuteFailure,\n isExecuteFailure,\n isJsonSerializable,\n} from \"./errors.ts\";\nimport type { ExecuteError, ResolvedToolProvider } from \"./types.ts\";\n\n/**\n * Transport-safe metadata for one exposed tool.\n */\nexport interface ProviderToolManifest {\n description?: string;\n originalName: string;\n safeName: string;\n}\n\n/**\n * Namespace manifest shared with runner implementations.\n */\nexport interface ProviderManifest {\n name: string;\n tools: Record<string, ProviderToolManifest>;\n types: string;\n}\n\n/**\n * Execution limits forwarded to runner implementations.\n */\nexport interface ExecutorRuntimeOptions {\n maxLogChars?: number;\n maxLogLines?: number;\n memoryLimitBytes?: number;\n timeoutMs?: number;\n}\n\n/**\n * Public execution options accepted by executors per call.\n */\nexport interface ExecutionOptions extends ExecutorRuntimeOptions {\n signal?: AbortSignal;\n}\n\n/**\n * Tool invocation request emitted from a runner.\n */\nexport interface ToolCall {\n input: unknown;\n providerName: string;\n safeToolName: string;\n}\n\n/**\n * Trusted host response to a tool invocation request.\n */\nexport type ToolCallResult =\n | {\n ok: true;\n result: unknown;\n }\n | {\n error: ExecuteError;\n ok: false;\n };\n\nfunction toTrustedExecuteError(error: unknown): ExecuteError {\n if (isExecuteFailure(error)) {\n return {\n code: error.code,\n message: error.message,\n };\n }\n\n return {\n code: \"tool_error\",\n message: normalizeThrownMessage(error),\n };\n}\n\n/**\n * Converts resolved providers into manifest metadata that reveals only namespace details.\n */\nexport function extractProviderManifests(\n providers: ResolvedToolProvider[],\n): ProviderManifest[] {\n return providers.map((provider) => ({\n name: provider.name,\n tools: Object.fromEntries(\n Object.entries(provider.tools).map(([safeToolName, descriptor]) => [\n safeToolName,\n {\n description: descriptor.description,\n originalName: descriptor.originalName,\n safeName: descriptor.safeName,\n },\n ]),\n ),\n types: provider.types,\n }));\n}\n\n/**\n * Creates a host-side dispatcher for runner-emitted tool calls.\n */\nexport function createToolCallDispatcher(\n providers: ResolvedToolProvider[],\n signal: AbortSignal,\n): (call: ToolCall) => Promise<ToolCallResult> {\n const providerMap = new Map(\n providers.map((provider) => [provider.name, provider] as const),\n );\n\n return async (call) => {\n const provider = providerMap.get(call.providerName);\n const descriptor = provider?.tools[call.safeToolName];\n\n if (!provider || !descriptor) {\n return {\n error: {\n code: \"internal_error\",\n message: `Unknown tool ${call.providerName}.${call.safeToolName}`,\n },\n ok: false,\n };\n }\n\n try {\n if (signal.aborted) {\n return {\n error: {\n code: \"timeout\",\n message: getExecutionTimeoutMessage(),\n },\n ok: false,\n };\n }\n\n const result = await descriptor.execute(\n call.input,\n createExecutionContext(\n signal,\n provider.name,\n descriptor.safeName,\n descriptor.originalName,\n ),\n );\n\n if (result !== undefined && !isJsonSerializable(result)) {\n throw new ExecuteFailure(\n \"serialization_error\",\n \"Host value is not JSON-serializable\",\n );\n }\n\n return {\n ok: true,\n result,\n };\n } catch (error) {\n return {\n error: toTrustedExecuteError(error),\n ok: false,\n };\n }\n };\n}\n","import { randomUUID } from \"node:crypto\";\n\nimport {\n runHostTransportSession,\n type HostTransport,\n} from \"@execbox/core/protocol\";\nimport type { ExecutorPoolOptions } from \"@execbox/core\";\nimport {\n resolveExecutorRuntimeOptions,\n type ExecutionOptions,\n type ExecuteResult,\n type ExecutorRuntimeOptions,\n type ResolvedToolProvider,\n} from \"../../../core/src/runtime.ts\";\n\n/**\n * Default grace period before a hosted shell is forcefully terminated.\n */\nconst DEFAULT_CANCEL_GRACE_MS = 25;\n\n/**\n * Default pooling limits shared by the hosted QuickJS executors.\n */\nconst DEFAULT_POOL_OPTIONS: Required<ExecutorPoolOptions> = {\n idleTimeoutMs: 30_000,\n maxSize: 1,\n minSize: 0,\n prewarm: false,\n};\n\n/**\n * Minimal code used to warm a hosted shell without touching user providers.\n */\nconst DEFAULT_PREWARM_CODE = \"undefined\";\n\nexport { DEFAULT_CANCEL_GRACE_MS, DEFAULT_POOL_OPTIONS, DEFAULT_PREWARM_CODE };\n\n/**\n * Wraps a transport so warmup and pooled execution can borrow it without\n * taking ownership of its lifecycle.\n */\nexport function createBorrowedTransport(\n transport: HostTransport,\n): HostTransport {\n return {\n dispose() {},\n onClose: transport.onClose,\n onError: transport.onError,\n onMessage: transport.onMessage,\n send: transport.send,\n terminate: transport.terminate,\n };\n}\n\n/**\n * Resolves how many pooled shells should be prewarmed from the pool settings.\n */\nexport function getPrewarmCount(pool: ExecutorPoolOptions | undefined): number {\n if (!pool?.prewarm) {\n return 0;\n }\n\n if (typeof pool.prewarm === \"number\") {\n return Math.max(0, Math.min(pool.prewarm, pool.maxSize));\n }\n\n return Math.max(1, Math.min(pool.minSize ?? 1, pool.maxSize));\n}\n\n/**\n * Caps an explicit warmup request to the configured pool boundaries.\n */\nexport function getWarmupTarget(\n count: number | undefined,\n poolOptions: ExecutorPoolOptions,\n): number {\n return Math.max(\n 0,\n Math.min(count ?? poolOptions.minSize ?? 0, poolOptions.maxSize),\n );\n}\n\n/**\n * Returns whether a hosted execution result is safe to return to a pool.\n */\nexport function isReusableResult(result: ExecuteResult): boolean {\n return (\n result.ok || ![\"internal_error\", \"timeout\"].includes(result.error.code)\n );\n}\n\n/**\n * Normalizes a failed warmup result into an actionable host-side error.\n */\nexport function toWarmupError(label: string, result: ExecuteResult): Error {\n if (result.ok) {\n return new Error(`Failed to prewarm pooled ${label}`);\n }\n\n return new Error(\n `Failed to prewarm pooled ${label}: ${result.error.message}`,\n );\n}\n\n/**\n * Runs one transport-backed execution session with resolved runtime limits and\n * a fresh execution identifier.\n */\nexport async function runHostedTransportSession(options: {\n cancelGraceMs: number;\n code: string;\n executorOptions: ExecutorRuntimeOptions;\n onSettled?: (result: ExecuteResult) => Promise<void> | void;\n providers: ResolvedToolProvider[];\n requestOptions?: ExecutionOptions;\n transport: HostTransport;\n}): Promise<ExecuteResult> {\n return await runHostTransportSession({\n cancelGraceMs: options.cancelGraceMs,\n code: options.code,\n executionId: randomUUID(),\n onSettled: options.onSettled,\n providers: options.providers,\n runtimeOptions: resolveExecutorRuntimeOptions(\n options.executorOptions,\n options.requestOptions,\n ),\n signal: options.requestOptions?.signal,\n transport: options.transport,\n });\n}\n\n/**\n * Exercises a set of leased shells with a warmup run and releases each lease\n * according to the warmup result.\n */\nexport async function warmHostedPool<Shell>(options: {\n count: number;\n getTransport: (shell: Shell) => HostTransport;\n label: string;\n onRelease: (shell: Shell, reusable: boolean) => Promise<void>;\n runSession: (\n transport: HostTransport,\n code: string,\n providers: ResolvedToolProvider[],\n ) => Promise<ExecuteResult>;\n shells: Shell[];\n}): Promise<void> {\n const results = await Promise.allSettled(\n options.shells.map(async (shell) => {\n let reusable = false;\n\n try {\n const result = await options.runSession(\n createBorrowedTransport(options.getTransport(shell)),\n DEFAULT_PREWARM_CODE,\n [],\n );\n reusable = result.ok;\n if (!result.ok) {\n throw toWarmupError(options.label, result);\n }\n } finally {\n await options.onRelease(shell, reusable);\n }\n }),\n );\n\n const rejected = results.find((result) => result.status === \"rejected\");\n if (rejected?.status === \"rejected\") {\n throw rejected.reason;\n }\n}\n","import { fork, type ChildProcess } from \"node:child_process\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n createResourcePool,\n getNodeTransportExecArgv,\n type HostTransport,\n type ResourcePool,\n type RunnerMessage,\n type TransportCloseReason,\n} from \"@execbox/core/protocol\";\nimport {\n createTimeoutExecuteResult,\n type ExecutionOptions,\n type Executor,\n type ExecuteResult,\n type ResolvedToolProvider,\n} from \"../../../core/src/runtime.ts\";\nimport type { ExecutorPoolOptions } from \"@execbox/core\";\n\nimport type { QuickJsProcessExecutorOptions } from \"../types.ts\";\nimport {\n DEFAULT_CANCEL_GRACE_MS,\n DEFAULT_POOL_OPTIONS,\n createBorrowedTransport,\n getPrewarmCount,\n getWarmupTarget,\n isReusableResult,\n runHostedTransportSession,\n warmHostedPool,\n} from \"./shared.ts\";\n\ninterface ProcessShell {\n child: ChildProcess;\n transport: HostTransport;\n}\n\nfunction resolveProcessEntryPath(): string {\n const extension = import.meta.url.endsWith(\".ts\") ? \".ts\" : \".js\";\n return fileURLToPath(new URL(`../processEntry${extension}`, import.meta.url));\n}\n\nfunction createUnexpectedExitMessage(\n code: number | null,\n signal: NodeJS.Signals | null,\n): string {\n if (code !== null) {\n return `Child process exited unexpectedly with code ${code}`;\n }\n\n if (signal) {\n return `Child process exited unexpectedly with signal ${signal}`;\n }\n\n return \"Child process exited unexpectedly\";\n}\n\nfunction createChildProcess(): ChildProcess {\n return fork(resolveProcessEntryPath(), [], {\n execArgv: getNodeTransportExecArgv(import.meta.url),\n stdio: [\"ignore\", \"ignore\", \"ignore\", \"ipc\"],\n });\n}\n\nfunction createProcessTransport(child: ChildProcess): HostTransport {\n let terminated = false;\n let closeReason: TransportCloseReason | undefined;\n const closeHandlers = new Set<(reason?: TransportCloseReason) => void>();\n const errorHandlers = new Set<(error: Error) => void>();\n const messageHandlers = new Set<(message: RunnerMessage) => void>();\n\n const terminateChild = () => {\n if (terminated) {\n return;\n }\n\n terminated = true;\n child.kill(\"SIGKILL\");\n };\n\n const notifyClose = (reason: TransportCloseReason) => {\n if (closeReason) {\n return;\n }\n\n closeReason = reason;\n for (const handler of closeHandlers) {\n handler(reason);\n }\n };\n\n const onDisconnect = () => {\n notifyClose({\n message: \"Child process disconnected unexpectedly\",\n });\n };\n const onExit = (code: number | null, signal: NodeJS.Signals | null) => {\n notifyClose({\n code,\n message: createUnexpectedExitMessage(code, signal),\n signal,\n });\n };\n const onError = (error: Error) => {\n for (const handler of errorHandlers) {\n handler(error);\n }\n };\n const onMessage = (message: unknown) => {\n for (const handler of messageHandlers) {\n handler(message as RunnerMessage);\n }\n };\n\n child.on(\"disconnect\", onDisconnect);\n child.on(\"exit\", onExit);\n child.on(\"error\", onError);\n child.on(\"message\", onMessage);\n\n return {\n dispose: () => {\n child.off(\"disconnect\", onDisconnect);\n child.off(\"exit\", onExit);\n child.off(\"error\", onError);\n child.off(\"message\", onMessage);\n terminateChild();\n },\n onClose: (handler) => {\n closeHandlers.add(handler);\n if (closeReason) {\n queueMicrotask(() => {\n if (closeHandlers.has(handler)) {\n handler(closeReason);\n }\n });\n }\n return () => {\n closeHandlers.delete(handler);\n };\n },\n onError: (handler) => {\n errorHandlers.add(handler);\n return () => errorHandlers.delete(handler);\n },\n onMessage: (handler) => {\n messageHandlers.add(handler);\n return () => messageHandlers.delete(handler);\n },\n send: (message) =>\n new Promise<void>((resolve, reject) => {\n if (!child.connected || typeof child.send !== \"function\") {\n reject(new Error(\"Child process disconnected unexpectedly\"));\n return;\n }\n\n child.send(message, (error) => {\n if (error) {\n reject(error);\n return;\n }\n\n resolve();\n });\n }),\n terminate: () => {\n terminateChild();\n },\n };\n}\n\nfunction createProcessShell(): ProcessShell {\n const child = createChildProcess();\n return {\n child,\n transport: createProcessTransport(child),\n };\n}\n\nfunction resolvePoolOptions(\n options: QuickJsProcessExecutorOptions,\n): ExecutorPoolOptions | undefined {\n if (options.mode === \"ephemeral\") {\n return undefined;\n }\n\n return {\n ...DEFAULT_POOL_OPTIONS,\n ...options.pool,\n };\n}\n\n/**\n * Child-process executor that runs guest code inside a dedicated QuickJS runtime per call.\n */\nexport class ProcessHostedQuickJsExecutor implements Executor {\n private readonly cancelGraceMs: number;\n private readonly options: QuickJsProcessExecutorOptions;\n private readonly pool: ResourcePool<ProcessShell> | undefined;\n private readonly poolOptions: ExecutorPoolOptions | undefined;\n private readonly warmup: Promise<void> | undefined;\n\n /**\n * Creates a hosted QuickJS executor that launches child-process shells on demand.\n */\n constructor(options: QuickJsProcessExecutorOptions) {\n this.cancelGraceMs = options.cancelGraceMs ?? DEFAULT_CANCEL_GRACE_MS;\n this.options = options;\n const poolOptions = resolvePoolOptions(options);\n this.poolOptions = poolOptions;\n\n if (poolOptions) {\n this.pool = createResourcePool({\n create: async () => createProcessShell(),\n destroy: async (shell) => {\n await shell.transport.dispose();\n },\n idleTimeoutMs: poolOptions.idleTimeoutMs,\n maxSize: poolOptions.maxSize,\n minSize: poolOptions.minSize,\n });\n const prewarmCount = getPrewarmCount(poolOptions);\n if (prewarmCount > 0) {\n this.warmup = this.warmPool(prewarmCount);\n }\n }\n }\n\n /**\n * Disposes any pooled child-process shells owned by this executor.\n */\n async dispose(): Promise<void> {\n await this.pool?.dispose();\n }\n\n /**\n * Prewarms pooled child-process shells up to the requested count.\n */\n async prewarm(count?: number): Promise<void> {\n if (!this.pool || !this.poolOptions) {\n return;\n }\n\n const target = getWarmupTarget(count, this.poolOptions);\n if (target <= 0) {\n return;\n }\n\n await this.warmPool(target);\n }\n\n private async runTransportSession(\n transport: HostTransport,\n code: string,\n providers: ResolvedToolProvider[],\n options: ExecutionOptions = {},\n onSettled?: (result: ExecuteResult) => Promise<void> | void,\n ): Promise<ExecuteResult> {\n return await runHostedTransportSession({\n cancelGraceMs: this.cancelGraceMs,\n code,\n executorOptions: this.options,\n onSettled,\n providers,\n requestOptions: options,\n transport,\n });\n }\n\n private async warmPool(count: number): Promise<void> {\n if (!this.pool) {\n return;\n }\n\n await this.pool.prewarm(count);\n\n const leases: Array<{\n release: (reusable: boolean) => Promise<void>;\n value: ProcessShell;\n }> = [];\n try {\n for (let index = 0; index < count; index += 1) {\n leases.push(await this.pool.acquire());\n }\n } catch (error) {\n await Promise.allSettled(\n leases.map(async (lease) => await lease.release(false)),\n );\n throw error;\n }\n\n await warmHostedPool({\n count,\n getTransport: (lease) => lease.value.transport,\n label: \"child process\",\n onRelease: async (lease, reusable) => await lease.release(reusable),\n runSession: async (transport, code, providers) =>\n await this.runTransportSession(transport, code, providers),\n shells: leases,\n });\n }\n\n /**\n * Executes guest code in a child-process-hosted QuickJS shell.\n */\n async execute(\n code: string,\n providers: ResolvedToolProvider[],\n options: ExecutionOptions = {},\n ): Promise<ExecuteResult> {\n if (options.signal?.aborted) {\n return createTimeoutExecuteResult();\n }\n\n await this.warmup;\n if (this.pool) {\n const lease = await this.pool.acquire();\n\n return await this.runTransportSession(\n createBorrowedTransport(lease.value.transport),\n code,\n providers,\n options,\n async (result) => {\n await lease.release(isReusableResult(result));\n },\n );\n }\n\n let child: ChildProcess;\n\n try {\n child = createChildProcess();\n } catch (error) {\n return {\n durationMs: 0,\n error: {\n code: \"internal_error\",\n message: error instanceof Error ? error.message : String(error),\n },\n logs: [],\n ok: false,\n };\n }\n\n return await this.runTransportSession(\n createProcessTransport(child),\n code,\n providers,\n options,\n );\n }\n}\n","import { availableParallelism } from \"node:os\";\nimport { Worker } from \"node:worker_threads\";\n\nimport {\n createResourcePool,\n getNodeTransportExecArgv,\n type HostTransport,\n type ResourcePool,\n type RunnerMessage,\n type TransportCloseReason,\n} from \"@execbox/core/protocol\";\nimport {\n createTimeoutExecuteResult,\n type ExecutionOptions,\n type Executor,\n type ExecuteResult,\n type ResolvedToolProvider,\n} from \"../../../core/src/runtime.ts\";\nimport type { ExecutorPoolOptions } from \"@execbox/core\";\n\nimport type { QuickJsWorkerExecutorOptions } from \"../types.ts\";\nimport {\n DEFAULT_CANCEL_GRACE_MS,\n DEFAULT_POOL_OPTIONS,\n createBorrowedTransport,\n getPrewarmCount,\n getWarmupTarget,\n isReusableResult,\n runHostedTransportSession,\n warmHostedPool,\n} from \"./shared.ts\";\n\nconst DEFAULT_POOLED_WORKER_MAX_SIZE = 4;\n\ninterface WorkerShell {\n transport: HostTransport;\n worker: Worker;\n}\n\nfunction resolveWorkerEntryUrl(): URL {\n const extension = import.meta.url.endsWith(\".ts\") ? \".ts\" : \".js\";\n return new URL(`../workerEntry${extension}`, import.meta.url);\n}\n\nfunction createWorkerTransport(worker: Worker): HostTransport {\n let terminated = false;\n let closeReason: TransportCloseReason | undefined;\n const closeHandlers = new Set<(reason?: TransportCloseReason) => void>();\n const errorHandlers = new Set<(error: Error) => void>();\n const messageHandlers = new Set<(message: RunnerMessage) => void>();\n\n const terminateWorker = async () => {\n if (terminated) {\n return;\n }\n\n terminated = true;\n await worker.terminate().catch(() => {});\n };\n\n const notifyClose = (reason: TransportCloseReason) => {\n if (closeReason) {\n return;\n }\n\n closeReason = reason;\n for (const handler of closeHandlers) {\n handler(reason);\n }\n };\n\n const onExit = (code: number) => {\n notifyClose({\n code,\n message: `Worker exited unexpectedly with code ${code}`,\n });\n };\n const onError = (error: Error) => {\n for (const handler of errorHandlers) {\n handler(error);\n }\n };\n const onMessage = (message: unknown) => {\n for (const handler of messageHandlers) {\n handler(message as RunnerMessage);\n }\n };\n\n worker.on(\"exit\", onExit);\n worker.on(\"error\", onError);\n worker.on(\"message\", onMessage);\n\n return {\n dispose: async () => {\n worker.off(\"exit\", onExit);\n worker.off(\"error\", onError);\n worker.off(\"message\", onMessage);\n await terminateWorker();\n },\n onClose: (handler) => {\n closeHandlers.add(handler);\n if (closeReason) {\n queueMicrotask(() => {\n if (closeHandlers.has(handler)) {\n handler(closeReason);\n }\n });\n }\n return () => closeHandlers.delete(handler);\n },\n onError: (handler) => {\n errorHandlers.add(handler);\n return () => errorHandlers.delete(handler);\n },\n onMessage: (handler) => {\n messageHandlers.add(handler);\n return () => messageHandlers.delete(handler);\n },\n send: (message) => {\n worker.postMessage(message);\n },\n terminate: async () => {\n await terminateWorker();\n },\n };\n}\n\nfunction createWorkerShell(options: QuickJsWorkerExecutorOptions): WorkerShell {\n const worker = new Worker(resolveWorkerEntryUrl(), {\n execArgv: getNodeTransportExecArgv(import.meta.url),\n resourceLimits: options.workerResourceLimits,\n });\n\n return {\n transport: createWorkerTransport(worker),\n worker,\n };\n}\n\nfunction getDefaultPoolMaxSize(): number {\n try {\n return Math.max(\n 1,\n Math.min(availableParallelism(), DEFAULT_POOLED_WORKER_MAX_SIZE),\n );\n } catch {\n return 1;\n }\n}\n\nfunction resolvePoolOptions(\n options: QuickJsWorkerExecutorOptions,\n): ExecutorPoolOptions | undefined {\n if (options.mode === \"ephemeral\") {\n return undefined;\n }\n\n return {\n ...DEFAULT_POOL_OPTIONS,\n maxSize: getDefaultPoolMaxSize(),\n ...options.pool,\n };\n}\n\n/**\n * Worker-thread executor that runs guest code inside a dedicated QuickJS runtime per call.\n */\nexport class WorkerHostedQuickJsExecutor implements Executor {\n private readonly cancelGraceMs: number;\n private readonly options: QuickJsWorkerExecutorOptions;\n private readonly pool: ResourcePool<WorkerShell> | undefined;\n private readonly poolOptions: ExecutorPoolOptions | undefined;\n private readonly warmup: Promise<void> | undefined;\n\n /**\n * Creates a hosted QuickJS executor that launches worker-thread shells on demand.\n */\n constructor(options: QuickJsWorkerExecutorOptions) {\n this.cancelGraceMs = options.cancelGraceMs ?? DEFAULT_CANCEL_GRACE_MS;\n this.options = options;\n const poolOptions = resolvePoolOptions(options);\n this.poolOptions = poolOptions;\n\n if (poolOptions) {\n this.pool = createResourcePool({\n create: async () => createWorkerShell(options),\n destroy: async (shell) => {\n await shell.transport.dispose();\n },\n idleTimeoutMs: poolOptions.idleTimeoutMs,\n maxSize: poolOptions.maxSize,\n minSize: poolOptions.minSize,\n });\n const prewarmCount = getPrewarmCount(poolOptions);\n if (prewarmCount > 0) {\n this.warmup = this.warmPool(prewarmCount);\n }\n }\n }\n\n /**\n * Disposes any pooled worker-thread shells owned by this executor.\n */\n async dispose(): Promise<void> {\n await this.pool?.dispose();\n }\n\n /**\n * Prewarms pooled worker-thread shells up to the requested count.\n */\n async prewarm(count?: number): Promise<void> {\n if (!this.pool || !this.poolOptions) {\n return;\n }\n\n const target = getWarmupTarget(count, this.poolOptions);\n if (target <= 0) {\n return;\n }\n\n await this.warmPool(target);\n }\n\n private async runTransportSession(\n transport: HostTransport,\n code: string,\n providers: ResolvedToolProvider[],\n options: ExecutionOptions = {},\n onSettled?: (result: ExecuteResult) => Promise<void> | void,\n ): Promise<ExecuteResult> {\n return await runHostedTransportSession({\n cancelGraceMs: this.cancelGraceMs,\n code,\n executorOptions: this.options,\n onSettled,\n providers,\n requestOptions: options,\n transport,\n });\n }\n\n private async warmPool(count: number): Promise<void> {\n if (!this.pool) {\n return;\n }\n\n await this.pool.prewarm(count);\n\n const leases: Array<{\n release: (reusable: boolean) => Promise<void>;\n value: WorkerShell;\n }> = [];\n try {\n for (let index = 0; index < count; index += 1) {\n leases.push(await this.pool.acquire());\n }\n } catch (error) {\n await Promise.allSettled(\n leases.map(async (lease) => await lease.release(false)),\n );\n throw error;\n }\n\n await warmHostedPool({\n count,\n getTransport: (lease) => lease.value.transport,\n label: \"worker shell\",\n onRelease: async (lease, reusable) => await lease.release(reusable),\n runSession: async (transport, code, providers) =>\n await this.runTransportSession(transport, code, providers),\n shells: leases,\n });\n }\n\n /**\n * Executes guest code in a worker-thread-hosted QuickJS shell.\n */\n async execute(\n code: string,\n providers: ResolvedToolProvider[],\n options: ExecutionOptions = {},\n ): Promise<ExecuteResult> {\n if (options.signal?.aborted) {\n return createTimeoutExecuteResult();\n }\n\n await this.warmup;\n if (this.pool) {\n const lease = await this.pool.acquire();\n\n return await this.runTransportSession(\n createBorrowedTransport(lease.value.transport),\n code,\n providers,\n options,\n async (result) => {\n await lease.release(isReusableResult(result));\n },\n );\n }\n\n const worker = new Worker(resolveWorkerEntryUrl(), {\n execArgv: getNodeTransportExecArgv(import.meta.url),\n resourceLimits: this.options.workerResourceLimits,\n });\n\n return await this.runTransportSession(\n createWorkerTransport(worker),\n code,\n providers,\n options,\n );\n }\n}\n","import {\n createTimeoutExecuteResult,\n createToolCallDispatcher,\n extractProviderManifests,\n} from \"../../core/src/runtime.ts\";\nimport type {\n ExecutionOptions,\n ExecuteResult,\n Executor,\n ResolvedToolProvider,\n} from \"@execbox/core\";\n\nimport { ProcessHostedQuickJsExecutor } from \"./hosted/processHostedExecutor.ts\";\nimport { WorkerHostedQuickJsExecutor } from \"./hosted/workerHostedExecutor.ts\";\nimport { runQuickJsSession } from \"./runner/index.ts\";\nimport type {\n QuickJsExecutorOptions,\n QuickJsInlineExecutorOptions,\n QuickJsProcessExecutorOptions,\n QuickJsWorkerExecutorOptions,\n} from \"./types\";\n\nfunction isWorkerOptions(\n options: QuickJsExecutorOptions,\n): options is QuickJsWorkerExecutorOptions {\n return options.host === \"worker\";\n}\n\nfunction isProcessOptions(\n options: QuickJsExecutorOptions,\n): options is QuickJsProcessExecutorOptions {\n return options.host === \"process\";\n}\n\n/**\n * QuickJS-backed executor for inline, worker-backed, or process-backed JavaScript runs.\n */\nexport class QuickJsExecutor implements Executor {\n private readonly hostedExecutor: Executor | undefined;\n private readonly options: QuickJsInlineExecutorOptions | undefined;\n\n /**\n * Creates a QuickJS executor with inline QuickJS by default, or a hosted\n * worker/process shell when `host` is explicitly set.\n */\n constructor(options: QuickJsExecutorOptions = {}) {\n if (isWorkerOptions(options)) {\n this.hostedExecutor = new WorkerHostedQuickJsExecutor(options);\n return;\n }\n\n if (isProcessOptions(options)) {\n this.hostedExecutor = new ProcessHostedQuickJsExecutor(options);\n return;\n }\n\n this.options = options;\n }\n\n /**\n * Disposes any pooled hosted shells owned by this executor.\n */\n async dispose(): Promise<void> {\n await this.hostedExecutor?.dispose?.();\n }\n\n /**\n * Prewarms pooled hosted shells when the executor is running in worker or\n * process mode. Inline mode treats this as a no-op.\n */\n async prewarm(count?: number): Promise<void> {\n await this.hostedExecutor?.prewarm?.(count);\n }\n\n /**\n * Executes JavaScript against the provided tool namespaces in a fresh QuickJS runtime.\n */\n async execute(\n code: string,\n providers: ResolvedToolProvider[],\n options: ExecutionOptions = {},\n ): Promise<ExecuteResult> {\n if (this.hostedExecutor) {\n return await this.hostedExecutor.execute(code, providers, options);\n }\n\n if (options.signal?.aborted) {\n return createTimeoutExecuteResult();\n }\n\n const abortController = new AbortController();\n const onToolCall = createToolCallDispatcher(\n providers,\n abortController.signal,\n );\n const onAbort = () => {\n abortController.abort();\n };\n\n options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n try {\n return await runQuickJsSession(\n {\n abortController,\n code,\n onToolCall,\n providers: extractProviderManifests(providers),\n },\n {\n ...this.options,\n ...options,\n },\n );\n } finally {\n options.signal?.removeEventListener(\"abort\", onAbort);\n abortController.abort();\n }\n }\n}\n"],"mappings":"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"}
|