humanish 0.104.3 → 0.106.0

package/dist/e2b-desktop-recording.js

@@ -1,162 +0,0 @@
-import { Readable, Transform } from "node:stream";
-import { pipeline } from "node:stream/promises";
-import { buildDesktopRecorderCommand, buildDesktopRecorderPulseSetupCommands, buildDesktopRecorderProbeCommand, parseDesktopRecorderDuration } from "./desktop-recorder.js";
-import { DESKTOP_RECORDING_MAX_BYTES } from "./desktop-recording-types.js";
-const OUTPUT_PATH = "/tmp/humanish-desktop-recording.mp4";
-const PID_PATH = "/tmp/humanish-desktop-recording.pid";
-const PULSE_RUNTIME = "/tmp/humanish-recording-runtime";
-const FINALIZE_TIMEOUT_MS = 10_000;
-const FORCE_REAP_TIMEOUT_MS = 5_000;
-const baseEnv = Object.freeze({
-    PATH: "/usr/local/bin:/usr/bin:/bin",
-    HOME: "/home/user",
-    USER: "user",
-    LOGNAME: "user",
-    LANG: "C.UTF-8",
-    DISPLAY: ":0"
-});
-function quote(value) { return `'${value.replaceAll("'", `'"'"'`)}'`; }
-async function settlesWithin(promise, timeoutMs) {
-    let timer;
-    return Promise.race([
-        promise.then(() => true),
-        new Promise(resolve => { timer = setTimeout(() => resolve(false), timeoutMs); })
-    ]).finally(() => clearTimeout(timer));
-}
-async function preparePulse(desktop, requestTimeoutMs) {
-    const env = { ...baseEnv, XDG_RUNTIME_DIR: PULSE_RUNTIME, PULSE_SERVER: `unix:${PULSE_RUNTIME}/pulse/native`,
-        PULSE_SOURCE: "humanish_input", PULSE_SINK: "humanish_speaker" };
-    try {
-        await desktop.commands.run("install -d -m 0700 /tmp/humanish-recording-runtime && "
-            + "pulseaudio --daemonize=yes --exit-idle-time=-1 --log-target=stderr && "
-            + "pactl load-module module-null-sink sink_name=humanish_mic sink_properties=device.description=HumanishSyntheticMicrophone >/dev/null && "
-            + "pactl load-module module-remap-source master=humanish_mic.monitor source_name=humanish_input source_properties=device.description=HumanishSyntheticMicrophone >/dev/null && "
-            + "pactl load-module module-null-sink sink_name=humanish_speaker sink_properties=device.description=HumanishSyntheticSpeaker >/dev/null && "
-            + "pactl set-default-source humanish_input && pactl set-default-sink humanish_speaker", {
-            envs: env, timeoutMs: 30_000, requestTimeoutMs
-        });
-        return env;
-    }
-    catch (error) {
-        await desktop.commands.run("pulseaudio --kill", { envs: env, timeoutMs: 5_000, requestTimeoutMs }).catch(() => { });
-        throw error;
-    }
-}
-/** Starts the shared FFmpeg recipe through E2B's command transport; retrieval remains host-owned. */
-export async function startE2BDesktopRecording(options) {
-    if (!options.desktop.files.read)
-        throw new Error("Installed @e2b/desktop does not support streamed recording retrieval.");
-    const audioSources = options.audio ? ["microphone-input", "speaker-output"] : [];
-    const ownsPulse = options.audio && options.pulseEnv === undefined;
-    const env = options.audio ? options.pulseEnv ?? await preparePulse(options.desktop, options.requestTimeoutMs) : baseEnv;
-    const stopOwnedPulse = async () => {
-        if (ownsPulse)
-            await options.desktop.commands.run("pulseaudio --kill", { envs: { ...env }, timeoutMs: 5_000,
-                requestTimeoutMs: options.requestTimeoutMs }).catch(() => { });
-    };
-    try {
-        for (const setup of options.audio ? buildDesktopRecorderPulseSetupCommands() : []) {
-            await options.desktop.commands.run(`${quote(setup.binary)} ${setup.args.map(quote).join(" ")}`, {
-                envs: { ...env }, timeoutMs: 5_000, requestTimeoutMs: options.requestTimeoutMs
-            });
-        }
-    }
-    catch (error) {
-        await stopOwnedPulse();
-        throw error;
-    }
-    const startedAtMs = Date.now();
-    const command = buildDesktopRecorderCommand({ display: ":0", width: options.width, height: options.height,
-        outputPath: OUTPUT_PATH, audioSources }, startedAtMs);
-    const launch = `set -eu; rm -f ${quote(PID_PATH)}; /usr/bin/env --default-signal=INT,TERM ${quote(command.binary)} ${command.args.map(quote).join(" ")} & `
-        + `child=$!; printf '%s\\n' "$child" > ${quote(PID_PATH)}; wait "$child"`;
-    let handle;
-    // The host launch boundary is the only clock shared with later run events. Capture it before
-    // the provider RPC so startup transport latency is not silently removed from the timeline.
-    const startedAt = new Date(startedAtMs).toISOString();
-    try {
-        handle = await options.desktop.commands.run(launch, {
-            background: true, envs: { ...baseEnv, ...env }, timeoutMs: 0, requestTimeoutMs: options.requestTimeoutMs
-        });
-    }
-    catch (error) {
-        await stopOwnedPulse();
-        throw error;
-    }
-    if (!handle.wait || !handle.kill || !Number.isSafeInteger(handle.pid) || handle.pid < 1) {
-        await handle.kill?.().catch(() => { });
-        await stopOwnedPulse();
-        throw new Error("Installed @e2b/desktop does not expose an owned recording process handle.");
-    }
-    const wait = handle.wait.bind(handle);
-    const kill = handle.kill.bind(handle);
-    let stopping = false, exitedEarly = false;
-    const exited = wait().then(result => { if (!stopping)
-        exitedEarly = true; return result; }, error => {
-        if (!stopping)
-            exitedEarly = true;
-        return error;
-    });
-    void exited.catch(() => { });
-    await options.desktop.wait(150);
-    if (exitedEarly) {
-        await stopOwnedPulse();
-        throw new Error("E2B desktop recorder exited during startup.");
-    }
-    const pidResult = await options.desktop.commands.run(`cat ${quote(PID_PATH)}`, {
-        timeoutMs: 5_000, requestTimeoutMs: options.requestTimeoutMs
-    }).catch(async (error) => { await kill().catch(() => { }); await stopOwnedPulse(); throw error; });
-    const recorderPid = Number(pidResult.stdout?.trim());
-    if (!Number.isSafeInteger(recorderPid) || recorderPid < 1) {
-        await kill().catch(() => { });
-        await stopOwnedPulse();
-        throw new Error("E2B desktop recorder did not report its owned process ID.");
-    }
-    let finishing;
-    return { env, finish: destination => finishing ??= (async () => {
-            let forced = false;
-            try {
-                stopping = true;
-                if (!exitedEarly) {
-                    await options.desktop.commands.run(`kill -INT -- ${recorderPid}`, { timeoutMs: 5_000, requestTimeoutMs: options.requestTimeoutMs });
-                }
-                let timer;
-                await Promise.race([exited, new Promise(resolve => { timer = setTimeout(() => { forced = true; resolve(); }, FINALIZE_TIMEOUT_MS); })])
-                    .finally(() => clearTimeout(timer));
-                if (forced) {
-                    await kill().catch(() => { });
-                    if (!await settlesWithin(exited, FORCE_REAP_TIMEOUT_MS))
-                        throw new Error("E2B recorder process did not stop.");
-                }
-                const probeCommand = buildDesktopRecorderProbeCommand(OUTPUT_PATH);
-                const probe = await options.desktop.commands.run(`${quote(probeCommand.binary)} ${probeCommand.args.map(quote).join(" ")}`, {
-                    timeoutMs: 30_000, requestTimeoutMs: options.requestTimeoutMs
-                });
-                const durationMs = parseDesktopRecorderDuration(probe.stdout ?? "");
-                const transferSignal = AbortSignal.timeout(options.requestTimeoutMs);
-                const web = await options.desktop.files.read(OUTPUT_PATH, { format: "stream", requestTimeoutMs: options.requestTimeoutMs,
-                    streamIdleTimeoutMs: options.requestTimeoutMs, signal: transferSignal });
-                let transferred = 0;
-                const count = new Transform({ transform(chunk, _encoding, callback) {
-                        if (transferred + chunk.length > DESKTOP_RECORDING_MAX_BYTES) {
-                            callback(new Error("E2B recording exceeds the size limit."));
-                            return;
-                        }
-                        transferred += chunk.length;
-                        callback(undefined, chunk);
-                    } });
-                await pipeline(Readable.fromWeb(web), count, destination, { signal: transferSignal });
-                if (transferred < 1)
-                    throw new Error("E2B desktop recorder produced empty output.");
-                return { mimeType: "video/mp4", startedAt, durationMs, bytes: transferred,
-                    audioSources, complete: !exitedEarly && !forced };
-            }
-            catch {
-                throw new Error("E2B desktop recording failed.");
-            }
-            finally {
-                await stopOwnedPulse();
-            }
-        })() };
-}
-//# sourceMappingURL=e2b-desktop-recording.js.map

package/dist/e2b-desktop-recording.js.map

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

package/dist/e2b-desktop-resources.d.ts

@@ -1,11 +0,0 @@
-import type { E2BDesktopSandbox } from "./e2b-desktop-launch.js";
-import { type DesktopResources } from "./pricing.js";
-export type DesktopResourceObservation = {
-    resources: DesktopResources;
-    source: "e2b.getInfo";
-} | {
-    reason: "metadata_unavailable" | "metadata_invalid" | "metadata_timeout";
-};
-/** Called once after the caller owns and journals the handle. Never throws or delays cleanup
- * beyond the bounded wait. Persist only resource quantities, never the raw info/connection. */
-export declare function observeDesktopResources(desktop: Pick<E2BDesktopSandbox, "getInfo">, timeoutMs?: number): Promise<DesktopResourceObservation>;

package/dist/e2b-desktop-resources.js

@@ -1,33 +0,0 @@
-import { isDesktopResources } from "./pricing.js";
-/** Called once after the caller owns and journals the handle. Never throws or delays cleanup
- * beyond the bounded wait. Persist only resource quantities, never the raw info/connection. */
-export async function observeDesktopResources(desktop, timeoutMs = 1_000) {
-    const controller = new AbortController();
-    let timer;
-    try {
-        if (typeof desktop.getInfo !== "function")
-            return { reason: "metadata_unavailable" };
-        const waitMs = Number.isFinite(timeoutMs) && timeoutMs > 0 ? Math.min(timeoutMs, 1_000) : 1_000;
-        return await Promise.race([
-            Promise.resolve().then(async () => {
-                const info = await desktop.getInfo({ requestTimeoutMs: waitMs, signal: controller.signal });
-                const resources = { cpuCount: info?.cpuCount, memoryMiB: info?.memoryMB };
-                return isDesktopResources(resources)
-                    ? { resources, source: "e2b.getInfo" }
-                    : { reason: "metadata_invalid" };
-            }),
-            new Promise((resolve) => {
-                timer = setTimeout(() => resolve({ reason: "metadata_timeout" }), waitMs);
-            })
-        ]);
-    }
-    catch {
-        return { reason: "metadata_unavailable" };
-    }
-    finally {
-        if (timer !== undefined)
-            clearTimeout(timer);
-        controller.abort();
-    }
-}
-//# sourceMappingURL=e2b-desktop-resources.js.map

package/dist/e2b-desktop-resources.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"e2b-desktop-resources.js","sourceRoot":"","sources":["../src/e2b-desktop-resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAyB,MAAM,cAAc,CAAC;AAMzE;+FAC+F;AAC/F,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAA2C,EAC3C,SAAS,GAAG,KAAK;IAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACH,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;YAAE,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAChG,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,IAAyC,EAAE;gBACrE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAQ,CAAC,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7F,MAAM,SAAS,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC1E,OAAO,kBAAkB,CAAC,SAAS,CAAC;oBAClC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE;oBACtC,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;YACrC,CAAC,CAAC;YACF,IAAI,OAAO,CAA6B,CAAC,OAAO,EAAE,EAAE;gBAClD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5E,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/e2b-desktop-screenshot-cleanup.d.ts

@@ -1,15 +0,0 @@
-import type { E2BDesktopSandbox } from "./e2b-desktop-launch.js";
-/** Runtime diagnostic only; no provider errors, file paths, or image contents are retained. */
-export declare function desktopScreenshotCleanupFailures(desktop: object): number;
-/**
- * @e2b/desktop 2.3.3 screenshot() awaits capture and files.read(path), then discards the
- * files.remove(path) promise. A removal that races sandbox teardown can therefore crash Node
- * AFTER valid bytes were returned. Installed-SDK conformance tests pin that behavior (#662).
- *
- * Observe only removal of a file successfully read within THIS screenshot invocation. The
- * exact path comes from the SDK, not a guessed filename pattern. AsyncLocalStorage isolates
- * concurrent screenshots and unrelated file operations without changing SDK method receivers.
- * The ORIGINAL removal promise is returned: an SDK version (or caller) that awaits it still
- * receives the original rejection. No process-wide rejection handler or filesystem retry.
- */
-export declare function protectDesktopScreenshotCleanup<T extends E2BDesktopSandbox>(desktop: T): T;

package/dist/e2b-desktop-screenshot-cleanup.js

@@ -1,67 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-const guarded = new WeakSet();
-const failureCounts = new WeakMap();
-// One long-lived context instance: creating one per desktop would require disable() on every
-// teardown for AsyncLocalStorage itself to be collected. Invocation stores follow async work.
-const screenshotScope = new AsyncLocalStorage();
-/** Runtime diagnostic only; no provider errors, file paths, or image contents are retained. */
-export function desktopScreenshotCleanupFailures(desktop) {
-    return failureCounts.get(desktop) ?? 0;
-}
-/**
- * @e2b/desktop 2.3.3 screenshot() awaits capture and files.read(path), then discards the
- * files.remove(path) promise. A removal that races sandbox teardown can therefore crash Node
- * AFTER valid bytes were returned. Installed-SDK conformance tests pin that behavior (#662).
- *
- * Observe only removal of a file successfully read within THIS screenshot invocation. The
- * exact path comes from the SDK, not a guessed filename pattern. AsyncLocalStorage isolates
- * concurrent screenshots and unrelated file operations without changing SDK method receivers.
- * The ORIGINAL removal promise is returned: an SDK version (or caller) that awaits it still
- * receives the original rejection. No process-wide rejection handler or filesystem retry.
- */
-export function protectDesktopScreenshotCleanup(desktop) {
-    if (guarded.has(desktop))
-        return desktop;
-    const files = desktop.files;
-    const read = files.read;
-    const remove = files.remove;
-    if (typeof read !== "function" || typeof remove !== "function")
-        return desktop;
-    const screenshot = desktop.screenshot;
-    files.read = function (path, ...args) {
-        const pending = read.call(this, path, ...args);
-        const scope = screenshotScope.getStore();
-        if (scope?.desktop !== desktop)
-            return pending;
-        return pending.then((value) => {
-            scope.paths.add(path);
-            return value;
-        });
-    };
-    files.remove = function (path, ...args) {
-        const pending = remove.call(this, path, ...args);
-        const scope = screenshotScope.getStore();
-        if (scope?.desktop === desktop && scope.paths.has(path)) {
-            // The secondary handler resolves independently. Returning pending (not catch's promise)
-            // preserves awaited removal failures while observing the SDK's detached rejection.
-            void pending.catch(() => {
-                const count = desktopScreenshotCleanupFailures(desktop) + 1;
-                failureCounts.set(desktop, count);
-                try {
-                    process.stderr.write(`humanish desktop: screenshot temporary-file cleanup failed (${count}); image read completed. Sandbox teardown reclaims temporary files.\n`);
-                }
-                catch {
-                    // A closed diagnostic stream must not turn this secondary rejection observer into a
-                    // new unhandled rejection. The per-instance counter remains available.
-                }
-            });
-        }
-        return pending;
-    };
-    desktop.screenshot = function (...args) {
-        return screenshotScope.run({ desktop, paths: new Set() }, () => screenshot.apply(this, args));
-    };
-    guarded.add(desktop);
-    return desktop;
-}
-//# sourceMappingURL=e2b-desktop-screenshot-cleanup.js.map

package/dist/e2b-desktop-screenshot-cleanup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"e2b-desktop-screenshot-cleanup.js","sourceRoot":"","sources":["../src/e2b-desktop-screenshot-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAU,CAAC;AACtC,MAAM,aAAa,GAAG,IAAI,OAAO,EAAkB,CAAC;AACpD,6FAA6F;AAC7F,8FAA8F;AAC9F,MAAM,eAAe,GAAG,IAAI,iBAAiB,EAA2C,CAAC;AAEzF,+FAA+F;AAC/F,MAAM,UAAU,gCAAgC,CAAC,OAAe;IAC9D,OAAO,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,+BAA+B,CAA8B,OAAU;IACrF,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAwB,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,OAAO,IAAI,KAAK,UAAU,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IAE/E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,KAAK,CAAC,IAAI,GAAG,UAAU,IAAI,EAAE,GAAG,IAAI;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC;QACzC,IAAI,KAAK,EAAE,OAAO,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QAC/C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5B,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,KAAK,CAAC,MAAM,GAAG,UAAU,IAAI,EAAE,GAAG,IAAI;QACpC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC;QACzC,IAAI,KAAK,EAAE,OAAO,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,wFAAwF;YACxF,mFAAmF;YACnF,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;gBACtB,MAAM,KAAK,GAAG,gCAAgC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC5D,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAClC,IAAI,CAAC;oBACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+DAA+D,KAAK,uEAAuE,CAAC,CAAC;gBACpK,CAAC;gBAAC,MAAM,CAAC;oBACP,oFAAoF;oBACpF,uEAAuE;gBACzE,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IACF,OAAO,CAAC,UAAU,GAAG,UAAU,GAAG,IAAI;QACpC,OAAO,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,EAAU,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACxG,CAAC,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/e2b-desktop-session.d.ts

@@ -1,7 +0,0 @@
-import { type OwnedDesktopAllocation } from "./desktop-session.js";
-import { type E2BDesktopCreateOptions, type E2BDesktopModule, type E2BDesktopSandbox, type TransientRetryHooks } from "./e2b-desktop-launch.js";
-/** Provider-specific provisioning stays in the hosted adapter; the actor consumes an executor. */
-export declare function allocateE2BDesktopSession(module: E2BDesktopModule, options: E2BDesktopCreateOptions, template?: string, retry?: TransientRetryHooks): Promise<{
-    desktop: E2BDesktopSandbox;
-    allocation: OwnedDesktopAllocation;
-}>;

package/dist/e2b-desktop-session.js

@@ -1,29 +0,0 @@
-import { ownDesktopAllocation } from "./desktop-session.js";
-import { createDesktopSandbox } from "./e2b-desktop-launch.js";
-/** Provider-specific provisioning stays in the hosted adapter; the actor consumes an executor. */
-export async function allocateE2BDesktopSession(module, options, template, retry) {
-    const desktop = await createDesktopSandbox(module, options, template, retry);
-    // The mutable SDK handle is passed to provisioning hooks. Capture its acquired identity
-    // and the provider method now, before any hook can change either one.
-    const resourceId = desktop.sandboxId;
-    const kill = typeof module.Sandbox.kill === "function"
-        ? module.Sandbox.kill.bind(module.Sandbox)
-        : undefined;
-    const allocation = ownDesktopAllocation({
-        resourceId,
-        release: async () => {
-            if (kill === undefined)
-                return { status: "unconfirmed", reason: "release_unavailable" };
-            const result = await kill(resourceId, { requestTimeoutMs: 60_000 });
-            // SDK false means 404/already absent, not an unconfirmed request. Anything else is
-            // an incompatible response and cannot prove release. Never list the account.
-            if (result === true)
-                return { status: "released", reason: "terminated" };
-            if (result === false)
-                return { status: "released", reason: "already_gone" };
-            return { status: "unconfirmed", reason: "invalid_result" };
-        }
-    });
-    return { desktop, allocation };
-}
-//# sourceMappingURL=e2b-desktop-session.js.map

package/dist/e2b-desktop-session.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"e2b-desktop-session.js","sourceRoot":"","sources":["../src/e2b-desktop-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAA+B,MAAM,sBAAsB,CAAC;AACzF,OAAO,EACL,oBAAoB,EAKrB,MAAM,yBAAyB,CAAC;AAEjC,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAwB,EACxB,OAAgC,EAChC,QAAiB,EACjB,KAA2B;IAE3B,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7E,wFAAwF;IACxF,sEAAsE;IACtE,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU;QACpD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,UAAU,GAAG,oBAAoB,CAAC;QACtC,UAAU;QACV,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;YACxF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,mFAAmF;YACnF,6EAA6E;YAC7E,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;YACzE,IAAI,MAAM,KAAK,KAAK;gBAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;YAC5E,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QAC7D,CAAC;KACF,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC"}

package/dist/e2b-detached.d.ts

@@ -1,53 +0,0 @@
-import type { E2BDesktopSandbox } from "./e2b-desktop-launch.js";
-export interface DetachedTimers {
-    /** Injected clock (ms) for tests. */
-    now?: () => number;
-    /** Injected sleep for tests. */
-    sleep?: (ms: number) => Promise<void>;
-}
-export interface DetachedStepOptions extends DetachedTimers {
-    /** Short [a-z0-9-] label; names the script/status/log files under /tmp. */
-    name: string;
-    /** The shell command to run (the lab author's own command — package.json-script trust). */
-    command: string;
-    cwd?: string;
-    /** Wall-clock budget for the step. */
-    timeoutMs: number;
-    pollIntervalMs?: number;
-    requestTimeoutMs?: number;
-}
-export interface DetachedStepResult {
-    ok: boolean;
-    exitCode?: number;
-    timedOut: boolean;
-    /** Capped, UNREDACTED log tail — redact before persisting. */
-    logTail: string;
-}
-/** Read the capped log tail for a step (raw — caller redacts). */
-export declare function readDetachedLog(desktop: E2BDesktopSandbox, name: string, requestTimeoutMs?: number): Promise<string>;
-/**
- * Run a BOUNDED step (install/build) detached, polling its atomic status file until it
- * exits or the budget runs out. On timeout the process group is killed and the log tail is
- * still captured so failures stay diagnosable.
- */
-export declare function runDetachedStep(desktop: E2BDesktopSandbox, options: DetachedStepOptions): Promise<DetachedStepResult>;
-/**
- * Launch a LONG-LIVED process (the subject's server) fully detached and return immediately.
- * No status polling: liveness is the caller's readiness probe, and reclamation belongs to
- * the sandbox lifecycle (create with kill-on-timeout).
- */
-export declare function startDetachedProcess(desktop: E2BDesktopSandbox, options: {
-    name: string;
-    command: string;
-    cwd?: string;
-    requestTimeoutMs?: number;
-}): Promise<void>;
-/**
- * Poll a URL from INSIDE the sandbox until it answers 2xx/3xx or the budget runs out.
- * Returns true when the subject is ready.
- */
-export declare function probeUrl(desktop: E2BDesktopSandbox, url: string, options: {
-    timeoutMs: number;
-    intervalMs?: number;
-    requestTimeoutMs?: number;
-} & DetachedTimers): Promise<boolean>;

package/dist/e2b-detached.js

@@ -1,130 +0,0 @@
-// Detached process management for E2B sandboxes — the substrate primitive behind serving a
-// subject app in-sandbox. E2B's foreground `commands.run` deadlines on long-running work, so
-// every consumer of the pattern has historically re-implemented the same workaround. This
-// module lands it once:
-//
-// - Scripts are written via `files.write`, never heredocs — which eliminates the
-//   sentinel-collision bug class (a command line that equals the heredoc terminator) by
-//   construction.
-// - Bounded steps (install/build) run detached with an ATOMICALLY-written status file
-//   (write tmp + mv), polled by short foreground commands; a timeout kills the process
-//   group and surfaces a capped log tail for the caller to redact and persist.
-// - Long-lived steps (a dev/prod server) launch fully detached via `setsid -f`; the sandbox
-//   lifecycle (kill-on-timeout) owns their reclamation.
-// - Readiness is an explicit curl probe against the declared URL.
-//
-// Log tails are returned RAW; callers must pass them through redaction before persisting
-// (build output can echo env values and paths).
-const WORK_ROOT = "/tmp/humanish-subject";
-const DEFAULT_POLL_INTERVAL_MS = 3000;
-const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
-const LOG_TAIL_BYTES = 8192;
-const NAME_PATTERN = /^[a-z0-9-]+$/;
-function assertName(name) {
-    if (!NAME_PATTERN.test(name)) {
-        throw new Error(`Detached step name must match ${NAME_PATTERN} (got "${name}").`);
-    }
-}
-/** Single-quote a value for safe interpolation into a shell script. */
-function shq(value) {
-    return `'${value.replaceAll("'", "'\\''")}'`;
-}
-function stepDir(name) {
-    return `${WORK_ROOT}/${name}`;
-}
-// The wrapper script: runs the command from its own session (setsid launch makes the script
-// the process-group leader, so `kill -- -PID` reclaims the whole tree), logs everything, and
-// writes the exit code atomically so a poller can never read a half-written status.
-function wrapperScript(name, command, cwd) {
-    const dir = stepDir(name);
-    return [
-        "#!/bin/bash",
-        `mkdir -p ${shq(dir)}`,
-        `echo $$ > ${shq(`${dir}/pid`)}`,
-        cwd === undefined ? ": # no cwd override" : `cd ${shq(cwd)} || { echo 127 > ${shq(`${dir}/status.tmp`)}; mv ${shq(`${dir}/status.tmp`)} ${shq(`${dir}/status`)}; exit 127; }`,
-        `( ${command} ) > ${shq(`${dir}/log.txt`)} 2>&1`,
-        "code=$?",
-        `echo $code > ${shq(`${dir}/status.tmp`)}`,
-        `mv ${shq(`${dir}/status.tmp`)} ${shq(`${dir}/status`)}`,
-        "exit $code",
-        ""
-    ].join("\n");
-}
-async function writeAndLaunch(desktop, name, command, cwd, requestTimeoutMs) {
-    assertName(name);
-    const dir = stepDir(name);
-    const scriptPath = `${dir}/run.sh`;
-    await desktop.commands.run(`mkdir -p ${shq(dir)}`, { requestTimeoutMs });
-    await desktop.files.write(scriptPath, wrapperScript(name, command, cwd));
-    await desktop.commands.run(`chmod +x ${shq(scriptPath)} && setsid -f ${shq(scriptPath)} < /dev/null > /dev/null 2>&1`, { requestTimeoutMs });
-}
-/** Read the capped log tail for a step (raw — caller redacts). */
-export async function readDetachedLog(desktop, name, requestTimeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
-    assertName(name);
-    const result = await desktop.commands.run(`tail -c ${LOG_TAIL_BYTES} ${shq(`${stepDir(name)}/log.txt`)} 2>/dev/null || true`, { requestTimeoutMs });
-    return result.stdout ?? "";
-}
-/**
- * Run a BOUNDED step (install/build) detached, polling its atomic status file until it
- * exits or the budget runs out. On timeout the process group is killed and the log tail is
- * still captured so failures stay diagnosable.
- */
-export async function runDetachedStep(desktop, options) {
-    const requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
-    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
-    const now = options.now ?? Date.now;
-    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
-    const dir = stepDir(options.name);
-    await writeAndLaunch(desktop, options.name, options.command, options.cwd, requestTimeoutMs);
-    const deadline = now() + options.timeoutMs;
-    for (;;) {
-        const status = await desktop.commands.run(`cat ${shq(`${dir}/status`)} 2>/dev/null || true`, { requestTimeoutMs });
-        const text = (status.stdout ?? "").trim();
-        if (text.length > 0) {
-            const exitCode = Number.parseInt(text, 10);
-            const logTail = await readDetachedLog(desktop, options.name, requestTimeoutMs);
-            return { ok: exitCode === 0, exitCode, timedOut: false, logTail };
-        }
-        if (now() >= deadline) {
-            // Kill the whole process group (the script is its own session leader via setsid).
-            await desktop.commands
-                .run(`kill -- -$(cat ${shq(`${dir}/pid`)} 2>/dev/null) 2>/dev/null || true`, { requestTimeoutMs })
-                .catch(() => undefined);
-            const logTail = await readDetachedLog(desktop, options.name, requestTimeoutMs);
-            return { ok: false, timedOut: true, logTail };
-        }
-        await sleep(pollIntervalMs);
-    }
-}
-/**
- * Launch a LONG-LIVED process (the subject's server) fully detached and return immediately.
- * No status polling: liveness is the caller's readiness probe, and reclamation belongs to
- * the sandbox lifecycle (create with kill-on-timeout).
- */
-export async function startDetachedProcess(desktop, options) {
-    await writeAndLaunch(desktop, options.name, options.command, options.cwd, options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);
-}
-/**
- * Poll a URL from INSIDE the sandbox until it answers 2xx/3xx or the budget runs out.
- * Returns true when the subject is ready.
- */
-export async function probeUrl(desktop, url, options) {
-    const requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
-    const intervalMs = options.intervalMs ?? 1500;
-    const now = options.now ?? Date.now;
-    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
-    const deadline = now() + options.timeoutMs;
-    for (;;) {
-        const result = await desktop.commands
-            .run(`curl -sf -o /dev/null --max-time 5 ${shq(url)} && echo READY || echo WAIT`, { requestTimeoutMs })
-            .catch(() => ({ stdout: "WAIT" }));
-        if ((result.stdout ?? "").includes("READY")) {
-            return true;
-        }
-        if (now() >= deadline) {
-            return false;
-        }
-        await sleep(intervalMs);
-    }
-}
-//# sourceMappingURL=e2b-detached.js.map

package/dist/e2b-detached.js.map

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