@poe-platform/safe-bash 0.1.662 → 0.1.664

package/dist/safe-bash/commands/python/executor-pool.d.ts

@@ -0,0 +1,16 @@
+import type { PythonAsyncExecutor } from './index.js';
+export interface PythonExecutorPoolOptions {
+    readonly createExecutor: () => PythonAsyncExecutor;
+    readonly maxConcurrentExecutors: number;
+}
+export interface PythonExecutorPool {
+    createExecutor(): PythonAsyncExecutor;
+    inspect(): {
+        readonly active: number;
+        readonly capacity: number;
+        readonly closed: boolean;
+    };
+    dispose(): Promise<void>;
+}
+export declare function createPythonExecutorPool(options: PythonExecutorPoolOptions): PythonExecutorPool;
+//# sourceMappingURL=executor-pool.d.ts.map

package/dist/safe-bash/commands/python/executor-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-pool.d.ts","sourceRoot":"","sources":["../../../src/commands/python/executor-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAuB,MAAM,YAAY,CAAC;AAG3E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,mBAAmB,CAAC;IACnD,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,IAAI,mBAAmB,CAAC;IACtC,OAAO,IAAI;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAsE/F"}

package/dist/safe-bash/commands/python/executor-pool.js

@@ -0,0 +1,90 @@
+import { PythonFailure } from './diagnostics.js';
+export function createPythonExecutorPool(options) {
+    if (typeof options?.createExecutor !== 'function')
+        throw new TypeError('Python executor pool requires a factory');
+    const factory = options.createExecutor;
+    const capacity = options.maxConcurrentExecutors;
+    if (!Number.isSafeInteger(capacity) || capacity < 1)
+        throw new RangeError('Invalid Python executor pool capacity');
+    const entries = new Set();
+    let closed = false;
+    let disposal;
+    return {
+        createExecutor() {
+            if (closed)
+                throw new PythonFailure('executor-unavailable');
+            if (entries.size >= capacity)
+                throw new PythonFailure('capacity');
+            let acquired;
+            const acquisition = new Promise(resolve => { acquired = resolve; });
+            let retirement;
+            let execution;
+            let started = false;
+            const entry = {
+                retire() {
+                    retirement ??= Promise.resolve().then(async () => {
+                        const executor = await acquisition;
+                        if (executor !== undefined) {
+                            const results = await Promise.allSettled([Promise.resolve().then(() => {
+                                    const terminate = executor?.terminate;
+                                    if (typeof terminate !== 'function')
+                                        throw new PythonFailure('cleanup');
+                                    return terminate.call(executor);
+                                }), execution]);
+                            const failed = results.find(result => result.status === 'rejected');
+                            if (failed?.status === 'rejected')
+                                throw failed.reason;
+                        }
+                        entries.delete(entry);
+                    });
+                    return retirement;
+                },
+            };
+            entries.add(entry);
+            let executor;
+            try {
+                executor = factory();
+            }
+            catch (error) {
+                acquired(undefined);
+                entries.delete(entry);
+                throw error;
+            }
+            acquired(executor);
+            try {
+                if (closed || !executor || typeof executor.run !== 'function' || typeof executor.terminate !== 'function')
+                    throw new PythonFailure('executor-unavailable');
+            }
+            catch (error) {
+                void entry.retire().catch(() => { });
+                throw error;
+            }
+            return {
+                async run(start) {
+                    if (started || closed || retirement)
+                        throw new PythonFailure('executor-unavailable');
+                    started = true;
+                    const running = Promise.resolve().then(() => {
+                        if (closed || retirement)
+                            throw new PythonFailure('executor-unavailable');
+                        return executor.run(start);
+                    });
+                    execution = running.then(() => { }, () => { });
+                    return running;
+                },
+                terminate: entry.retire,
+            };
+        },
+        inspect() { return { active: entries.size, capacity, closed }; },
+        dispose() {
+            closed = true;
+            disposal ??= Promise.allSettled([...entries].map(entry => entry.retire())).then(results => {
+                const failed = results.find(result => result.status === 'rejected');
+                if (failed?.status === 'rejected')
+                    throw failed.reason;
+            });
+            return disposal;
+        },
+    };
+}
+//# sourceMappingURL=executor-pool.js.map

package/dist/safe-bash/commands/python/executor-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-pool.js","sourceRoot":"","sources":["../../../src/commands/python/executor-pool.ts"],"names":[],"mappings":"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"}

package/dist/safe-bash/commands/python/index.browser.js

@@ -1,17 +1,18 @@
 import {
   PythonPackageConflictError,
   createPythonCommands,
+  createPythonExecutorPool,
   createPythonPackageCache,
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,
   pythonCommands,
   pythonDocumentPackages
-} from "../../chunks/chunk-Z4UKD5FF.js";
+} from "../../chunks/chunk-6VT3VSBX.js";
 import "../../chunks/chunk-2E4KBFO6.js";
 import {
   PythonFailure,
   inspectPythonCapabilities
-} from "../../chunks/chunk-Y7MAMRAF.js";
+} from "../../chunks/chunk-AJ355TRJ.js";
 import "../../chunks/chunk-CDBQXRWL.js";
 import "../../chunks/chunk-THXJ6CLF.js";
 import "../../chunks/chunk-CHHAB5SS.js";
@@ -22,6 +23,7 @@ export {
   PythonFailure,
   PythonPackageConflictError,
   createPythonCommands,
+  createPythonExecutorPool,
   createPythonPackageCache,
   createPythonPackageEnvironment,
   createPythonPackageManifestStore,

package/dist/safe-bash/commands/python/index.d.ts

@@ -12,7 +12,8 @@ export interface PythonInitializationProgress {
     readonly command: string;
 }
 export interface PythonCommandsOptions {
-    readonly createWorker: () => PythonWorkerEndpoint;
+    readonly createWorker?: () => PythonWorkerEndpoint;
+    readonly createExecutor?: () => PythonAsyncExecutor;
     /** Explicit distribution requirements; no import scanning or implicit package downloads. */
     readonly packages?: readonly string[];
     /** Requirements files in the canonical filesystem. */
@@ -46,6 +47,18 @@ export interface PythonWorkerStart {
     readonly runtimeMount: string;
     readonly maxTransferBytes: number;
 }
+export interface PythonExecutorStart extends Omit<PythonWorkerStart, 'type' | 'shared'> {
+    readonly signal: AbortSignal;
+    dispatch(request: {
+        readonly op: string;
+        readonly args: unknown[];
+    }): Promise<unknown>;
+    onReady(): void;
+}
+export interface PythonAsyncExecutor {
+    run(start: PythonExecutorStart): Promise<number>;
+    terminate(): void | Promise<void>;
+}
 export declare function createPythonCommands(options: PythonCommandsOptions): readonly CommandDefinition[];
 export declare function pythonCommands(options: PythonCommandsOptions): VirtualShellPlugin;
 export { createPythonPackageEnvironment, pythonDocumentPackages } from './provisioning.js';
@@ -53,6 +66,8 @@ export type { PythonPackageOptions, PythonPackageCache, PythonPackageProgress, P
 export { PythonPackageConflictError, createPythonPackageManifestStore } from './manifest.js';
 export type { PythonPackageManifest, PythonPackageManifestStore } from './manifest.js';
 export { createPythonPackageCache } from './cache.js';
+export { createPythonExecutorPool } from './executor-pool.js';
+export type { PythonExecutorPool, PythonExecutorPoolOptions } from './executor-pool.js';
 export { PythonFailure, inspectPythonCapabilities } from './diagnostics.js';
 export type { PythonFailureCategory, PythonDiagnostic, PythonDiagnosticObserver, PythonFileSystemRequirement, PythonCapabilityOptions, PythonCapabilityReport } from './diagnostics.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/safe-bash/commands/python/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/python/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/python/index.ts"],"names":[],"mappings":"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"}

package/dist/safe-bash/commands/python/index.js

@@ -12,7 +12,9 @@ import { PythonFailure, isPythonFailureCategory, reportPythonFailure } from './d
 class PythonInputChunkError extends RangeError {
 }
 export function createPythonCommands(options) {
-    if (typeof options?.createWorker !== 'function')
+    if (!options || (typeof options.createWorker === 'function') === (typeof options.createExecutor === 'function')
+        || options.createWorker !== undefined && typeof options.createWorker !== 'function'
+        || options.createExecutor !== undefined && typeof options.createExecutor !== 'function')
         throw new PythonFailure('executor-unavailable');
     if (options.onDiagnostic !== undefined && typeof options.onDiagnostic !== 'function')
         throw new TypeError('Python onDiagnostic must be a function');
@@ -67,6 +69,7 @@ export function createPythonCommands(options) {
         let stdoutOperation;
         let stderrOperation;
         let endpoint;
+        let executor;
         let packages;
         let unsubscribe;
         let admitted = false;
@@ -89,7 +92,7 @@ export function createPythonCommands(options) {
             void (async () => {
                 signal.removeEventListener('abort', aborted);
                 const subscription = Promise.resolve().then(() => unsubscribe?.());
-                const termination = Promise.resolve().then(() => endpoint?.terminate());
+                const termination = Promise.resolve().then(() => executor ? executor.terminate() : endpoint?.terminate());
                 const results = await Promise.allSettled([subscription, termination, service.close(), stdoutOperation?.close(), stderrOperation?.close(), ...pending]);
                 await input.return?.(undefined);
                 fragment = undefined;
@@ -123,36 +126,17 @@ export function createPythonCommands(options) {
             const outputContext = { signal, ...(context.registerCleanup ? { registerCleanup: context.registerCleanup } : {}) };
             stdoutOperation = createOutputOperation(outputContext, context.stdout);
             stderrOperation = createOutputOperation(outputContext, context.stderr);
-            let shared;
-            try {
-                shared = new SharedArrayBuffer(8 + maxTransferBytes * 6 + 65536);
-            }
-            catch (reason) {
-                throw reportPythonFailure('transport-unavailable', reason, options.onDiagnostic);
-            }
-            const control = new Int32Array(shared, 0, 2);
-            const payload = new Uint8Array(shared, 8);
-            const reply = (value, status) => {
-                if (closed)
+            const diagnoseFilesystemFailure = async (operation, error) => {
+                if (typeof error !== 'object' || error === null || !('code' in error) || error.code !== 'ENOTSUP')
                     return;
-                let bytes;
-                try {
-                    bytes = encodePythonReply(value, payload.length);
-                }
-                catch (error) {
-                    if (typeof error !== 'object' || error === null || !('code' in error) || error.code !== 'EFBIG')
-                        throw error;
-                    bytes = encodePythonReply({ code: 'EFBIG' }, payload.length);
-                    status = 2;
-                }
-                payload.set(bytes);
-                try {
-                    Atomics.store(control, 1, bytes.length);
-                    Atomics.store(control, 0, status);
-                    Atomics.notify(control, 0);
-                }
-                catch (reason) {
-                    throw reportPythonFailure('transport-unavailable', reason, options.onDiagnostic);
+                const category = operation === 'open' ? 'filesystem-open'
+                    : operation === 'read' ? 'filesystem-read'
+                        : operation === 'write' || operation === 'ftruncate' ? 'filesystem-write'
+                            : operation === 'readdir' ? 'filesystem-directory' : 'filesystem-operation';
+                if (!filesystemDiagnostics.has(category)) {
+                    filesystemDiagnostics.add(category);
+                    const failure = reportPythonFailure(category, error, options.onDiagnostic);
+                    await writeBytes(stderrOperation.output, new TextEncoder().encode('python: ' + failure.message + '\n'), signal);
                 }
             };
             const dispatch = async (request) => {
@@ -208,110 +192,216 @@ export function createPythonCommands(options) {
                 pending.delete(preparation);
             }
             signal.throwIfAborted();
-            try {
-                endpoint = options.createWorker();
-            }
-            catch (reason) {
-                throw reportPythonFailure(reason instanceof PythonFailure ? reason.category : 'startup', reason, options.onDiagnostic);
-            }
-            signal.throwIfAborted();
-            result = await new Promise((resolve, reject) => {
-                let settled = false;
-                const fail = (reason) => { settled = true; reject(reason); };
-                rejectRun = fail;
-                signal.addEventListener('abort', aborted, { once: true });
-                const transportFailure = (reason) => { fail(reportPythonFailure('transport-unavailable', reason, options.onDiagnostic)); };
+            if (options.createExecutor) {
                 try {
-                    unsubscribe = endpoint.subscribe(value => {
-                        if (closed || settled)
-                            return;
-                        if (typeof value !== 'object' || value === null) {
-                            transportFailure(new TypeError('Invalid Python worker message'));
+                    executor = options.createExecutor();
+                }
+                catch (reason) {
+                    throw reportPythonFailure(reason instanceof PythonFailure ? reason.category : 'startup', reason, options.onDiagnostic);
+                }
+                if (!executor || typeof executor.run !== 'function' || typeof executor.terminate !== 'function')
+                    throw reportPythonFailure('executor-unavailable', undefined, options.onDiagnostic);
+                let requesting = false;
+                let running = true;
+                const start = {
+                    invocation: { command: context.command, args: [...context.args], cwd: context.cwd, env: { ...context.env } },
+                    runtimeMount, maxTransferBytes, signal, ...(packages ? { packages } : {}), installOnly: !!installation,
+                    onReady() {
+                        if (closed || !running || signal.aborted || ready)
                             return;
+                        ready = true;
+                        try {
+                            options.onProgress?.({ phase: 'ready', command: context.command });
                         }
-                        const message = value;
-                        if (message.type === 'ready') {
-                            ready = true;
-                            try {
-                                options.onProgress?.({ phase: 'ready', command: context.command });
-                            }
-                            catch (error) {
-                                fail(error);
-                            }
-                            return;
+                        catch (reason) {
+                            running = false;
+                            rejectRun?.(reason);
+                            throw reason;
+                        }
+                    },
+                    async dispatch(request) {
+                        signal.throwIfAborted();
+                        if (closed || !running || requesting || !request || typeof request.op !== 'string' || !Array.isArray(request.args))
+                            throw reportPythonFailure('transport-unavailable', undefined, options.onDiagnostic);
+                        requesting = true;
+                        const operation = Promise.resolve().then(() => dispatch(request)).catch(async (error) => {
+                            signal.throwIfAborted();
+                            if (error instanceof PythonInputChunkError)
+                                rejectRun?.(error);
+                            if (request.op.startsWith('package-'))
+                                throw Object.assign(reportPythonFailure('runtime-assets', error, options.onDiagnostic), { code: 'EPACKAGE' });
+                            await diagnoseFilesystemFailure(request.op, error);
+                            throw error;
+                        });
+                        const tracked = operation.then(() => { }, () => { });
+                        pending.add(tracked);
+                        try {
+                            return await operation;
+                        }
+                        finally {
+                            requesting = false;
+                            pending.delete(tracked);
                         }
-                        if (message.type === 'exit') {
-                            if (pending.size) {
-                                transportFailure(new TypeError('Python worker exited with an outstanding request'));
+                    },
+                };
+                const execution = Promise.resolve().then(() => {
+                    signal.throwIfAborted();
+                    return executor.run(start);
+                }).catch(reason => {
+                    running = false;
+                    if (signal.aborted)
+                        throw signal.reason;
+                    throw reportPythonFailure(reason instanceof PythonFailure ? reason.category : ready ? 'runtime' : 'startup', reason, options.onDiagnostic);
+                }).then(status => {
+                    running = false;
+                    if (requesting)
+                        throw reportPythonFailure('transport-unavailable', undefined, options.onDiagnostic);
+                    try {
+                        return validateExitCode(status);
+                    }
+                    catch (reason) {
+                        throw reportPythonFailure('transport-unavailable', reason, options.onDiagnostic);
+                    }
+                });
+                const tracked = execution.then(() => { }, () => { });
+                pending.add(tracked);
+                void tracked.then(() => pending.delete(tracked));
+                result = await new Promise((resolve, reject) => {
+                    rejectRun = reject;
+                    signal.addEventListener('abort', aborted, { once: true });
+                    if (signal.aborted)
+                        aborted();
+                    execution.then(resolve, reject);
+                });
+            }
+            else {
+                let shared;
+                try {
+                    shared = new SharedArrayBuffer(8 + maxTransferBytes * 6 + 65536);
+                }
+                catch (reason) {
+                    throw reportPythonFailure('transport-unavailable', reason, options.onDiagnostic);
+                }
+                const control = new Int32Array(shared, 0, 2);
+                const payload = new Uint8Array(shared, 8);
+                const reply = (value, status) => {
+                    if (closed)
+                        return;
+                    let bytes;
+                    try {
+                        bytes = encodePythonReply(value, payload.length);
+                    }
+                    catch (error) {
+                        if (typeof error !== 'object' || error === null || !('code' in error) || error.code !== 'EFBIG')
+                            throw error;
+                        bytes = encodePythonReply({ code: 'EFBIG' }, payload.length);
+                        status = 2;
+                    }
+                    payload.set(bytes);
+                    try {
+                        Atomics.store(control, 1, bytes.length);
+                        Atomics.store(control, 0, status);
+                        Atomics.notify(control, 0);
+                    }
+                    catch (reason) {
+                        throw reportPythonFailure('transport-unavailable', reason, options.onDiagnostic);
+                    }
+                };
+                try {
+                    endpoint = options.createWorker();
+                }
+                catch (reason) {
+                    throw reportPythonFailure(reason instanceof PythonFailure ? reason.category : 'startup', reason, options.onDiagnostic);
+                }
+                signal.throwIfAborted();
+                result = await new Promise((resolve, reject) => {
+                    let settled = false;
+                    const fail = (reason) => { settled = true; reject(reason); };
+                    rejectRun = fail;
+                    signal.addEventListener('abort', aborted, { once: true });
+                    const transportFailure = (reason) => { fail(reportPythonFailure('transport-unavailable', reason, options.onDiagnostic)); };
+                    try {
+                        unsubscribe = endpoint.subscribe(value => {
+                            if (closed || settled)
+                                return;
+                            if (typeof value !== 'object' || value === null) {
+                                transportFailure(new TypeError('Invalid Python worker message'));
                                 return;
                             }
-                            try {
-                                const status = validateExitCode(message.exitCode);
-                                settled = true;
-                                resolve(status);
-                            }
-                            catch (error) {
-                                transportFailure(error);
+                            const message = value;
+                            if (message.type === 'ready') {
+                                ready = true;
+                                try {
+                                    options.onProgress?.({ phase: 'ready', command: context.command });
+                                }
+                                catch (error) {
+                                    fail(error);
+                                }
+                                return;
                             }
-                            return;
-                        }
-                        if (message.type === 'error') {
-                            fail(reportPythonFailure(isPythonFailureCategory(message.category) ? message.category : ready ? 'runtime' : 'startup', message.message, options.onDiagnostic));
-                            return;
-                        }
-                        if (typeof message.op !== 'string' || !Array.isArray(message.args) || pending.size) {
-                            transportFailure(new TypeError('Invalid concurrent Python worker request'));
-                            return;
-                        }
-                        const work = dispatch({ op: message.op, args: message.args }).then(value => { pending.delete(work); reply(value, 1); }, async (error) => {
-                            if (signal.aborted) {
-                                pending.delete(work);
-                                fail(signal.reason);
+                            if (message.type === 'exit') {
+                                if (pending.size) {
+                                    transportFailure(new TypeError('Python worker exited with an outstanding request'));
+                                    return;
+                                }
+                                try {
+                                    const status = validateExitCode(message.exitCode);
+                                    settled = true;
+                                    resolve(status);
+                                }
+                                catch (error) {
+                                    transportFailure(error);
+                                }
                                 return;
                             }
-                            if (typeof message.op === 'string' && message.op.startsWith('package-')) {
-                                const failure = reportPythonFailure('runtime-assets', error, options.onDiagnostic);
-                                pending.delete(work);
-                                reply({ code: 'EPACKAGE', message: failure.message }, 2);
+                            if (message.type === 'error') {
+                                fail(reportPythonFailure(isPythonFailureCategory(message.category) ? message.category : ready ? 'runtime' : 'startup', message.message, options.onDiagnostic));
                                 return;
                             }
-                            if (typeof error !== 'object' || error === null || !('code' in error) || typeof error.code !== 'string') {
-                                pending.delete(work);
-                                fail(error);
+                            if (typeof message.op !== 'string' || !Array.isArray(message.args) || pending.size) {
+                                transportFailure(new TypeError('Invalid concurrent Python worker request'));
                                 return;
                             }
-                            if (error.code === 'ENOTSUP') {
-                                const category = message.op === 'open' ? 'filesystem-open'
-                                    : message.op === 'read' ? 'filesystem-read'
-                                        : message.op === 'write' || message.op === 'ftruncate' ? 'filesystem-write'
-                                            : message.op === 'readdir' ? 'filesystem-directory' : 'filesystem-operation';
-                                if (!filesystemDiagnostics.has(category)) {
-                                    filesystemDiagnostics.add(category);
-                                    const failure = reportPythonFailure(category, error, options.onDiagnostic);
-                                    await writeBytes(stderrOperation.output, new TextEncoder().encode('python: ' + failure.message + '\n'), signal);
+                            const work = dispatch({ op: message.op, args: message.args }).then(value => { pending.delete(work); reply(value, 1); }, async (error) => {
+                                if (signal.aborted) {
+                                    pending.delete(work);
+                                    fail(signal.reason);
+                                    return;
                                 }
-                            }
-                            pending.delete(work);
-                            reply({ code: error.code }, 2);
-                        });
-                        pending.add(work);
-                        void work.catch(reason => { pending.delete(work); fail(reason); });
-                    }, transportFailure);
-                }
-                catch (reason) {
-                    transportFailure(reason);
-                }
-                if (settled)
-                    return;
-                const start = { type: 'start', shared, invocation: { command: context.command, args: [...context.args], cwd: context.cwd, env: { ...context.env } }, runtimeMount, maxTransferBytes, ...(packages ? { packages } : {}), installOnly: !!installation };
-                signal.throwIfAborted();
-                try {
-                    endpoint.postMessage(start);
-                }
-                catch (reason) {
-                    transportFailure(reason);
-                }
-            });
+                                if (typeof message.op === 'string' && message.op.startsWith('package-')) {
+                                    const failure = reportPythonFailure('runtime-assets', error, options.onDiagnostic);
+                                    pending.delete(work);
+                                    reply({ code: 'EPACKAGE', message: failure.message }, 2);
+                                    return;
+                                }
+                                if (typeof error !== 'object' || error === null || !('code' in error) || typeof error.code !== 'string') {
+                                    pending.delete(work);
+                                    fail(error);
+                                    return;
+                                }
+                                await diagnoseFilesystemFailure(message.op, error);
+                                pending.delete(work);
+                                reply({ code: error.code }, 2);
+                            });
+                            pending.add(work);
+                            void work.catch(reason => { pending.delete(work); fail(reason); });
+                        }, transportFailure);
+                    }
+                    catch (reason) {
+                        transportFailure(reason);
+                    }
+                    if (settled)
+                        return;
+                    const start = { type: 'start', shared, invocation: { command: context.command, args: [...context.args], cwd: context.cwd, env: { ...context.env } }, runtimeMount, maxTransferBytes, ...(packages ? { packages } : {}), installOnly: !!installation };
+                    signal.throwIfAborted();
+                    try {
+                        endpoint.postMessage(start);
+                    }
+                    catch (reason) {
+                        transportFailure(reason);
+                    }
+                });
+            }
         }
         catch (reason) {
             if (!signal.aborted && reason instanceof PythonInputChunkError) {
@@ -350,10 +440,10 @@ export function createPythonCommands(options) {
         }
         return { exitCode: result };
     };
-    return ['python', 'python3'].map(name => ({ name, description: 'Python with an explicit synchronous interpreter worker and canonical filesystem', execute }));
+    return ['python', 'python3'].map(name => ({ name, description: 'Python with an explicit interpreter executor and canonical filesystem', execute }));
 }
 export function pythonCommands(options) {
-    if (typeof options?.createWorker !== 'function')
+    if (!options || (typeof options.createWorker === 'function') === (typeof options.createExecutor === 'function'))
         throw new PythonFailure('executor-unavailable');
     if (options?.environment && options.provisioning)
         throw new TypeError('A borrowed Python environment cannot be combined with provisioning options');
@@ -372,5 +462,6 @@ export function pythonCommands(options) {
 export { createPythonPackageEnvironment, pythonDocumentPackages } from './provisioning.js';
 export { PythonPackageConflictError, createPythonPackageManifestStore } from './manifest.js';
 export { createPythonPackageCache } from './cache.js';
+export { createPythonExecutorPool } from './executor-pool.js';
 export { PythonFailure, inspectPythonCapabilities } from './diagnostics.js';
 //# sourceMappingURL=index.js.map