@vibesdotdev/host-bun 0.0.0-stage → 1.0.0-rc.2

package/dist/services/host-identity.impl.bun.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The Bun host's executable classification: the kernel's ONE OWNER PREDICATE
+ * (`createExecutableClassifier`, three shapes: `monolith`, `thin-host`,
+ * `source`) over this process's own facts.
+ *
+ * Bun supplies what only it knows: its executable, where this module was
+ * loaded from (`import.meta.url` is under `/$bunfs` only inside a compiled
+ * bundle, so it is the honest proxy for where the framework modules live), and
+ * which executable names are Bun itself (`bun`, `bun.exe`, `bun-debug`,
+ * `bun-profile`); anything else at `process.execPath` is a standalone build.
+ */
+import { createExecutableClassifier, type HostIdentityRuntime } from '@vibesdotdev/execution-local';
+export { isBundledModuleUrl } from '@vibesdotdev/kernel/services/host-identity';
+export type { ExecutableClassificationFacts as ExecutableHostFacts, ExecutableKind, HostEnvSnapshot, HostExecutableIdentity, HostIdentityRuntime } from '@vibesdotdev/execution-local';
+/**
+ * Native facts are supplied only here. The composition root owns the returned
+ * classifier; no identity memo is retained by this module.
+ */
+export declare function createBunExecutableClassifier(host?: Parameters<typeof createExecutableClassifier>[0]): {
+    classifyExecutable: (facts: import("@vibesdotdev/execution-local").ExecutableClassificationFacts) => import("@vibesdotdev/execution-local").HostExecutableIdentity;
+    executableIdentityFrom: (env: import("@vibesdotdev/execution-local").HostEnvSnapshot) => import("@vibesdotdev/execution-local").HostExecutableIdentity;
+    executableIdentity: (runtime: HostIdentityRuntime) => import("@vibesdotdev/execution-local").HostExecutableIdentity;
+    hostModulesOnDisk: (runtime: HostIdentityRuntime) => boolean;
+    isStandaloneExecutable: (runtime: HostIdentityRuntime) => boolean;
+    hostEntryPath: (runtime: HostIdentityRuntime) => string | null;
+    resetForTest: () => void;
+};
+export declare const classifyExecutable: ReturnType<typeof createExecutableClassifier>['classifyExecutable'];
+export declare const executableIdentityFrom: ReturnType<typeof createExecutableClassifier>['executableIdentityFrom'];
+/** Pre-boot callers must lend a retained classifier or an environment's captured identity. */
+export declare function executableIdentity(runtime: HostIdentityRuntime, classifier?: ReturnType<typeof createBunExecutableClassifier>): {
+    kind: "source" | "thin-host" | "monolith";
+    execPath: string;
+    hostEntry: string | null;
+    hostRoot: string | null;
+    reason: string;
+};
+export declare const hostModulesOnDisk: (runtime: HostIdentityRuntime, classifier?: ReturnType<typeof createBunExecutableClassifier>) => boolean;
+export declare const isStandaloneExecutable: (runtime: HostIdentityRuntime, classifier?: ReturnType<typeof createBunExecutableClassifier>) => boolean;
+export declare function hostEntryPath(runtime: HostIdentityRuntime, classifier?: ReturnType<typeof createBunExecutableClassifier>): string | null;
+/** Stateless compatibility facade; retained services belong to the host client. */
+export declare const bunExecutableClassifier: Readonly<{
+    classifyExecutable: (facts: import("@vibesdotdev/execution-local").ExecutableClassificationFacts) => import("@vibesdotdev/execution-local").HostExecutableIdentity;
+    executableIdentityFrom: (env: import("@vibesdotdev/execution-local").HostEnvSnapshot) => import("@vibesdotdev/execution-local").HostExecutableIdentity;
+    executableIdentity: typeof executableIdentity;
+    hostModulesOnDisk: (runtime: HostIdentityRuntime, classifier?: ReturnType<typeof createBunExecutableClassifier>) => boolean;
+    isStandaloneExecutable: (runtime: HostIdentityRuntime, classifier?: ReturnType<typeof createBunExecutableClassifier>) => boolean;
+    hostEntryPath: typeof hostEntryPath;
+    resetForTest: () => void;
+}>;
+/** @deprecated Tests own a fresh host resource set instead. */
+export declare const __resetExecutableIdentityCacheForTest: () => void;
+//# sourceMappingURL=host-identity.impl.bun.d.ts.map

package/dist/services/host-identity.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-identity.impl.bun.d.ts","sourceRoot":"","sources":["../../src/services/host-identity.impl.bun.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,0BAA0B,EAAE,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAMpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAChF,YAAY,EAAE,6BAA6B,IAAI,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAQvL;;;GAGG;AACH,wBAAgB,6BAA6B,CAC5C,IAAI,GAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC,CAMpD;;;;;;;;EAGD;AAQD,eAAO,MAAM,kBAAkB,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,oBAAoB,CAChC,CAAC;AACpE,eAAO,MAAM,sBAAsB,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,wBAAwB,CACxC,CAAC;AACpE,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC;;;;;;EAa7H;AACD,eAAO,MAAM,iBAAiB,GAAI,SAAS,mBAAmB,EAAE,aAAa,UAAU,CAAC,OAAO,6BAA6B,CAAC,YACjE,CAAC;AAC7D,eAAO,MAAM,sBAAsB,GAAI,SAAS,mBAAmB,EAAE,aAAa,UAAU,CAAC,OAAO,6BAA6B,CAAC,YACxE,CAAC;AAC3D,wBAAgB,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC,GAAG,MAAM,GAAG,IAAI,CAMxI;AAED,mFAAmF;AACnF,eAAO,MAAM,uBAAuB;;;;iCAbO,mBAAmB,eAAe,UAAU,CAAC,OAAO,6BAA6B,CAAC;sCAE7E,mBAAmB,eAAe,UAAU,CAAC,OAAO,6BAA6B,CAAC;;;EAehI,CAAC;AACH,+DAA+D;AAC/D,eAAO,MAAM,qCAAqC,YAAuC,CAAC"}

package/dist/services/host-identity.impl.bun.js

@@ -0,0 +1,76 @@
+/**
+ * The Bun host's executable classification: the kernel's ONE OWNER PREDICATE
+ * (`createExecutableClassifier`, three shapes: `monolith`, `thin-host`,
+ * `source`) over this process's own facts.
+ *
+ * Bun supplies what only it knows: its executable, where this module was
+ * loaded from (`import.meta.url` is under `/$bunfs` only inside a compiled
+ * bundle, so it is the honest proxy for where the framework modules live), and
+ * which executable names are Bun itself (`bun`, `bun.exe`, `bun-debug`,
+ * `bun-profile`); anything else at `process.execPath` is a standalone build.
+ */
+import { realpathSync } from 'node:fs';
+import { basename } from 'node:path';
+import { createExecutableClassifier } from '@vibesdotdev/execution-local';
+import { tryGetVibesClient } from '@vibesdotdev/kernel/client';
+import { CapabilityError, VibesRuntime } from '@vibesdotdev/kernel';
+import { ABSENT_PATH_CODES, environmentUnregistered, readOrAbsent } from '@vibesdotdev/execution-local/host-base';
+export { isBundledModuleUrl } from '@vibesdotdev/kernel/services/host-identity';
+/** `bun`, `bun.exe`, `bun-debug`, `bun-profile` are the runtime itself. */
+function isBunRuntime(execPath) {
+    const name = basename(execPath);
+    return name === 'bun' || name === 'bun.exe' || name.startsWith('bun-');
+}
+/**
+ * Native facts are supplied only here. The composition root owns the returned
+ * classifier; no identity memo is retained by this module.
+ */
+export function createBunExecutableClassifier(host = {
+    execPath: () => process.execPath,
+    moduleUrl: import.meta.url,
+    runtimeName: 'bun',
+    isRuntimeExecutable: isBunRuntime,
+    realpath: path => realpathSync(path)
+}) {
+    return createExecutableClassifier(host);
+}
+function classifierOf(runtime) {
+    return runtime instanceof VibesRuntime
+        ? tryGetVibesClient('bun-host', runtime)?.resources.classifier
+        : undefined;
+}
+export const classifyExecutable = facts => createBunExecutableClassifier().classifyExecutable(facts);
+export const executableIdentityFrom = env => createBunExecutableClassifier().executableIdentityFrom(env);
+/** Pre-boot callers must lend a retained classifier or an environment's captured identity. */
+export function executableIdentity(runtime, classifier) {
+    const environment = runtime.localEnvironment;
+    if (!environment)
+        throw environmentUnregistered();
+    const owner = classifier ?? classifierOf(runtime);
+    if (owner)
+        return owner.executableIdentity(runtime);
+    const declared = environment.hostIdentity?.call(environment);
+    if (declared)
+        return declared;
+    throw new CapabilityError('Bun identity requires an activated host or an explicitly owned classifier.', 'UNAVAILABLE', {
+        reason: 'bun-host-client-unavailable', retryable: false
+    });
+}
+export const hostModulesOnDisk = (runtime, classifier) => executableIdentity(runtime, classifier).kind !== 'monolith';
+export const isStandaloneExecutable = (runtime, classifier) => executableIdentity(runtime, classifier).kind !== 'source';
+export function hostEntryPath(runtime, classifier) {
+    const owner = classifier ?? classifierOf(runtime);
+    if (owner)
+        return owner.hostEntryPath(runtime);
+    const entry = executableIdentity(runtime).hostEntry;
+    return entry ? readOrAbsent(() => realpathSync(entry), ABSENT_PATH_CODES, entry) : null;
+}
+/** Stateless compatibility facade; retained services belong to the host client. */
+export const bunExecutableClassifier = Object.freeze({
+    classifyExecutable, executableIdentityFrom, executableIdentity,
+    hostModulesOnDisk, isStandaloneExecutable, hostEntryPath,
+    resetForTest: () => { }
+});
+/** @deprecated Tests own a fresh host resource set instead. */
+export const __resetExecutableIdentityCacheForTest = bunExecutableClassifier.resetForTest;
+//# sourceMappingURL=host-identity.impl.bun.js.map

package/dist/services/host-identity.impl.bun.js.map

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

package/dist/services/host-resources.impl.bun.d.ts

@@ -0,0 +1,49 @@
+/** Physical process resources shared explicitly by every runtime in a Bun host. */
+import { type RuntimeStdioStreams } from '@vibesdotdev/kernel';
+import { type RuntimeOutputPlaneFormatter } from '@vibesdotdev/execution-local';
+import { createBunExecutableClassifier } from './host-identity.impl.bun.ts';
+/** Construct once at the composition root; pass it to every environment in that process. */
+export declare function createBunHostResources(classification?: Parameters<typeof createBunExecutableClassifier>[0]): Readonly<{
+    classifier: {
+        classifyExecutable: (facts: import("@vibesdotdev/execution-local").ExecutableClassificationFacts) => import("@vibesdotdev/execution-local").HostExecutableIdentity;
+        executableIdentityFrom: (env: import("@vibesdotdev/execution-local").HostEnvSnapshot) => import("@vibesdotdev/execution-local").HostExecutableIdentity;
+        executableIdentity: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => import("@vibesdotdev/execution-local").HostExecutableIdentity;
+        hostModulesOnDisk: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => boolean;
+        isStandaloneExecutable: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => boolean;
+        hostEntryPath: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => string | null;
+        resetForTest: () => void;
+    };
+    executable: {
+        isCompiledExecutable: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => boolean;
+        processStartedAtMs: () => number;
+        statExecutable: (path: string) => import("@vibesdotdev/execution-local").ExecutableFileStat | null;
+        executableHostFactsOf: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => import("@vibesdotdev/execution-local").ExecutableHostFacts;
+        describeExecutable: (path: string, host: import("@vibesdotdev/execution-local").ExecutableHostFacts) => import("@vibesdotdev/execution-local").ExecutableIdentity | null;
+        captureExecutableIdentity: (host: import("@vibesdotdev/execution-local").ExecutableHostFacts) => import("@vibesdotdev/execution-local").ExecutableIdentity | null;
+        getCapturedExecutableIdentity: () => import("@vibesdotdev/execution-local").ExecutableIdentity | null;
+        judgeExecutableReplaced: (loaded: import("@vibesdotdev/execution-local").ExecutableFileStat, current: import("@vibesdotdev/execution-local").ExecutableFileStat, processStartMs: number) => boolean;
+        checkExecutableFreshness: (host: import("@vibesdotdev/execution-local").ExecutableHostFacts) => import("@vibesdotdev/execution-local").ExecutableFreshness;
+        executableReplacedSince: (path: string, processStartMs: number) => import("@vibesdotdev/execution-local").ExecutableReplacedSince;
+        resetForTest: () => void;
+    };
+    outputPlane: {
+        install: (options: import("@vibesdotdev/kernel").RuntimeStdioTrackOptions) => void;
+        isInstalled: () => boolean;
+        uninstall: () => void;
+        setFormatter: (next: RuntimeOutputPlaneFormatter) => void;
+        formatConsoleArgs: (args: readonly unknown[]) => string;
+        flush: () => Promise<void>;
+    };
+    writeOutput(channel: "stdout" | "stderr", text: string): void;
+    readonly fatal: {
+        subscribe: (listener: import("@vibesdotdev/kernel").RuntimeFatalListener) => () => void;
+        subscriberCount: () => number;
+    };
+    setFormatter(next: RuntimeOutputPlaneFormatter): void;
+    /** A per-runtime lease; the last release drains and restores physical resources. */
+    retain(): () => Promise<void>;
+    streams(): RuntimeStdioStreams;
+    /** Explicit host entry cleanup, including boot failures before a runtime retained it. */
+    dispose(): Promise<void>;
+}>;
+//# sourceMappingURL=host-resources.impl.bun.d.ts.map

package/dist/services/host-resources.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-resources.impl.bun.d.ts","sourceRoot":"","sources":["../../src/services/host-resources.impl.bun.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAsD,KAAK,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACpI,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAM5E,4FAA4F;AAC5F,wBAAgB,sBAAsB,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA6CpF,QAAQ,GAAG,QAAQ,QAAQ,MAAM,GAAG,IAAI;;;;;uBAO1C,2BAA2B,GAAG,IAAI;IAIrD,oFAAoF;cAC1E,MAAM,OAAO,CAAC,IAAI,CAAC;eAgBlB,mBAAmB;IA6B9B,yFAAyF;eACxE,OAAO,CAAC,IAAI,CAAC;GAQ/B"}

package/dist/services/host-resources.impl.bun.js

@@ -0,0 +1,144 @@
+/** Physical process resources shared explicitly by every runtime in a Bun host. */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { createRuntimeStdioStreams } from '@vibesdotdev/execution-local';
+import { createBunExecutableClassifier } from "./host-identity.impl.bun.js";
+import { createBunExecutableFreshness } from "./executable-identity.impl.bun.js";
+import { PassThrough, Readable } from 'node:stream';
+import { createBunOutputPlane } from "./output-plane.impl.bun.js";
+import { createBunFatalSignals } from "./fatal-signals.impl.bun.js";
+/** Construct once at the composition root; pass it to every environment in that process. */
+export function createBunHostResources(classification) {
+    // Share this owner across environments in one physical host. The base pins
+    // file evidence once, while its classifier retains each environment's own
+    // admitted identity and its executable captures retain each source ref.
+    const classifier = createBunExecutableClassifier(classification);
+    const executable = createBunExecutableFreshness(classifier);
+    const nativePlane = createBunOutputPlane();
+    let outputOptions = { stripSgr: false };
+    const outputPlane = Object.freeze({
+        ...nativePlane,
+        install(options) {
+            outputOptions = { ...options };
+            nativePlane.install(outputOptions);
+        }
+    });
+    let fatalSignals = createBunFatalSignals();
+    let formatter;
+    let streams;
+    let releaseInput;
+    let borrowers = 0;
+    let closing;
+    const close = () => {
+        if (closing)
+            return closing;
+        closing = Promise.resolve().then(async () => {
+            const outcomes = await Promise.allSettled([
+                Promise.resolve().then(() => fatalSignals.dispose()),
+                Promise.resolve().then(() => releaseInput?.()),
+                // An unused owner has no tracked output; flushing an ambient stream
+                // here would write into another runtime's active capture.
+                outputPlane.isInstalled() ? outputPlane.flush() : Promise.resolve()
+            ]);
+            // Uninstall even when a native drain or reader refuses. Keep every failure.
+            const restored = await Promise.allSettled([Promise.resolve().then(() => outputPlane.uninstall())]);
+            streams = undefined;
+            releaseInput = undefined;
+            fatalSignals = createBunFatalSignals();
+            if (formatter)
+                outputPlane.setFormatter(formatter);
+            const failures = [...outcomes, ...restored].flatMap(result => result.status === 'rejected' ? [result.reason] : []);
+            if (failures.length)
+                throw new AggregateError(failures, 'Bun host resources could not be finalized.');
+        });
+        return closing;
+    };
+    return Object.freeze({
+        classifier, executable,
+        outputPlane,
+        writeOutput(channel, text) {
+            // With no runtime, the executable entry owns tracking until it flushes
+            // and closes, including diagnostics written after failed-boot cleanup.
+            if (borrowers === 0 && !outputPlane.isInstalled())
+                outputPlane.install(outputOptions);
+            (channel === 'stdout' ? process.stdout : process.stderr).write(text);
+        },
+        get fatal() { return fatalSignals.fanOut; },
+        setFormatter(next) {
+            formatter = next;
+            outputPlane.setFormatter(next);
+        },
+        /** A per-runtime lease; the last release drains and restores physical resources. */
+        retain() {
+            if (closing && borrowers === 0) {
+                throw new CapabilityError('This Bun host is closing.', 'UNAVAILABLE', { reason: 'bun-host-closing', retryable: false });
+            }
+            borrowers++;
+            let released = false;
+            return async () => {
+                if (released)
+                    return;
+                released = true;
+                borrowers--;
+                if (borrowers === 0) {
+                    try {
+                        await close();
+                    }
+                    finally {
+                        closing = undefined;
+                    }
+                }
+            };
+        },
+        streams() {
+            if (streams)
+                return streams;
+            // The intermediary lets finalization detach the physical reader without
+            // destroying the process's stdin, which a later host can still borrow.
+            const native = process.stdin;
+            const input = new PassThrough();
+            const fail = input.destroy.bind(input);
+            native.on('error', fail);
+            native.pipe(input);
+            const reader = Readable.toWeb(input).getReader();
+            const source = new ReadableStream({
+                async pull(controller) {
+                    const next = await reader.read();
+                    if (next.done)
+                        controller.close();
+                    else
+                        controller.enqueue(next.value);
+                },
+                cancel: reason => reader.cancel(reason)
+            });
+            releaseInput = async () => {
+                native.unpipe(input);
+                native.off('error', fail);
+                // unpipe releases only this branch. Pausing the native stream here
+                // would stop delivery to other independently composed owners.
+                try {
+                    await reader.cancel();
+                }
+                finally {
+                    reader.releaseLock();
+                    input.destroy();
+                }
+            };
+            streams = createRuntimeStdioStreams({ stdinStream: () => source, get stdout() { return process.stdout; } });
+            return streams;
+        },
+        /** Explicit host entry cleanup, including boot failures before a runtime retained it. */
+        async dispose() {
+            if (borrowers !== 0)
+                throw new CapabilityError('Bun runtimes still own this host.', 'CONFLICT', {
+                    reason: 'bun-host-in-use', retryable: false
+                });
+            try {
+                await close();
+            }
+            finally {
+                closing = undefined;
+            }
+        }
+    });
+}
+//# sourceMappingURL=host-resources.impl.bun.js.map

package/dist/services/host-resources.impl.bun.js.map

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

package/dist/services/http-fetch.impl.bun.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The Bun host's environment `httpFetch` port: the kernel's fetch base
+ * (`createRuntimeHttpFetch`) over this host's own native HTTP/2 client.
+ * Bun implements the `node:http2` client, so its client is that API; the
+ * request, abort, header, streaming and upload policy is the kernel's.
+ */
+import { type RuntimeHttpFetch } from '@vibesdotdev/execution-local';
+/** The Bun environment's HTTP/2 fetch port. */
+export declare const bunHttpFetch: RuntimeHttpFetch;
+//# sourceMappingURL=http-fetch.impl.bun.d.ts.map

package/dist/services/http-fetch.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-fetch.impl.bun.d.ts","sourceRoot":"","sources":["../../src/services/http-fetch.impl.bun.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAA0H,KAAK,gBAAgB,EAAmC,MAAM,8BAA8B,CAAC;AA+B9N,+CAA+C;AAC/C,eAAO,MAAM,YAAY,EAAE,gBAAyD,CAAC"}

package/dist/services/http-fetch.impl.bun.js

@@ -0,0 +1,38 @@
+/**
+ * The Bun host's environment `httpFetch` port: the kernel's fetch base
+ * (`createRuntimeHttpFetch`) over this host's own native HTTP/2 client.
+ * Bun implements the `node:http2` client, so its client is that API; the
+ * request, abort, header, streaming and upload policy is the kernel's.
+ */
+import { createRuntimeHttpFetch } from '@vibesdotdev/execution-local';
+import { connect } from 'node:http2';
+/** One session per request; its stream starts paused and flows only when the base resumes it. */
+const bunHttp2Client = Object.freeze({
+    connect(origin, options, events) {
+        const session = connect(origin, { rejectUnauthorized: options.rejectUnauthorized, settings: { enablePush: false } });
+        session.on('error', events.onError);
+        session.on('close', events.onClose);
+        return {
+            request(headers, requestOptions, streamEvents) {
+                const stream = session.request(headers, { endStream: requestOptions.endStream });
+                stream.pause();
+                stream.on('error', streamEvents.onError);
+                stream.on('aborted', streamEvents.onAborted);
+                stream.on('close', streamEvents.onClose);
+                stream.on('data', (chunk) => streamEvents.onData(chunk));
+                stream.on('end', streamEvents.onEnd);
+                stream.on('response', nativeHeaders => streamEvents.onResponse(nativeHeaders));
+                return {
+                    pause: () => { stream.pause(); },
+                    resume: () => { stream.resume(); },
+                    write: (chunk, done) => { stream.write(chunk, done); },
+                    end: () => { stream.end(); }
+                };
+            },
+            destroy: () => { session.destroy(); }
+        };
+    }
+});
+/** The Bun environment's HTTP/2 fetch port. */
+export const bunHttpFetch = createRuntimeHttpFetch(bunHttp2Client);
+//# sourceMappingURL=http-fetch.impl.bun.js.map

package/dist/services/http-fetch.impl.bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-fetch.impl.bun.js","sourceRoot":"","sources":["../../src/services/http-fetch.impl.bun.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,sBAAsB,EAA0J,MAAM,8BAA8B,CAAC;AAC9N,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,iGAAiG;AACjG,MAAM,cAAc,GAA+B,MAAM,CAAC,MAAM,CAAC;IAChE,OAAO,CAAC,MAAc,EAAE,OAAiD,EAAE,MAAiC;QAC3G,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACrH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO;YACN,OAAO,CAAC,OAAmC,EAAE,cAA+C,EAAE,YAAsC;gBACnI,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC;gBACjF,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;gBAC7C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACrE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBACrC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;gBAC/E,OAAO;oBACN,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;oBAChC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBAClC,KAAK,EAAE,CAAC,KAAiB,EAAE,IAAoC,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;oBAClG,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;iBAC5B,CAAC;YACH,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;SACrC,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAqB,sBAAsB,CAAC,cAAc,CAAC,CAAC"}

package/dist/services/output-plane.impl.bun.d.ts

@@ -0,0 +1,6 @@
+/** Native Bun rendering and streams, handed to the execution-local output base. */
+import { type RuntimeOutputPlane } from '@vibesdotdev/execution-local';
+/** A composition root owns the returned plane and uninstalls it after draining. */
+export declare function createBunOutputPlane(): RuntimeOutputPlane;
+export declare const bunOutputPlane: RuntimeOutputPlane;
+//# sourceMappingURL=output-plane.impl.bun.d.ts.map

package/dist/services/output-plane.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-plane.impl.bun.d.ts","sourceRoot":"","sources":["../../src/services/output-plane.impl.bun.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGjG,mFAAmF;AACnF,wBAAgB,oBAAoB,IAAI,kBAAkB,CASzD;AAKD,eAAO,MAAM,cAAc,EAAE,kBAO3B,CAAC"}

package/dist/services/output-plane.impl.bun.js

@@ -0,0 +1,26 @@
+/** Native Bun rendering and streams, handed to the execution-local output base. */
+import { createRuntimeOutputPlane } from '@vibesdotdev/execution-local';
+import { format } from 'node:util';
+/** A composition root owns the returned plane and uninstalls it after draining. */
+export function createBunOutputPlane() {
+    return createRuntimeOutputPlane(Object.freeze({
+        get stdout() { return process.stdout; },
+        get stderr() { return process.stderr; },
+        get console() { return console; },
+        // The Bun host renders console values as Bun does; no entry installs it.
+        inspect: (...values) => values.map(value => Bun.inspect(value, { depth: 2, colors: false })).join(' '),
+        formatJson: (...values) => format('%j', ...values)
+    }));
+}
+// Compatibility callers share the explicitly captured legacy host until their
+// composition roots pass a host owner. This alias contains no independent state.
+import { compatibilityBunHost } from "./compatibility-host.impl.bun.js";
+export const bunOutputPlane = Object.freeze({
+    install: options => compatibilityBunHost.outputPlane.install(options),
+    isInstalled: () => compatibilityBunHost.outputPlane.isInstalled(),
+    uninstall: () => compatibilityBunHost.outputPlane.uninstall(),
+    setFormatter: next => compatibilityBunHost.setFormatter(next),
+    formatConsoleArgs: args => compatibilityBunHost.outputPlane.formatConsoleArgs(args),
+    flush: () => compatibilityBunHost.outputPlane.flush()
+});
+//# sourceMappingURL=output-plane.impl.bun.js.map

package/dist/services/output-plane.impl.bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-plane.impl.bun.js","sourceRoot":"","sources":["../../src/services/output-plane.impl.bun.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,wBAAwB,EAA2B,MAAM,8BAA8B,CAAC;AACjG,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,mFAAmF;AACnF,MAAM,UAAU,oBAAoB;IACnC,OAAO,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7C,IAAI,MAAM,KAAK,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACvC,IAAI,OAAO,KAAK,OAAO,OAAO,CAAC,CAAC,CAAC;QACjC,yEAAyE;QACzE,OAAO,EAAE,CAAC,GAAG,MAAiB,EAAU,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACzH,UAAU,EAAE,CAAC,GAAG,MAAiB,EAAU,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC;KACrE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,MAAM,CAAC,MAAM,cAAc,GAAuB,MAAM,CAAC,MAAM,CAAC;IAC/D,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;IACrE,WAAW,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC,WAAW,EAAE;IACjE,SAAS,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC,SAAS,EAAE;IAC7D,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,YAAY,CAAC,IAAI,CAAC;IAC7D,iBAAiB,EAAE,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC;IACnF,KAAK,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC,KAAK,EAAE;CACrD,CAAC,CAAC"}

package/dist/services/process-action-lifetime.consumer.d.ts

@@ -0,0 +1,47 @@
+import { type RuntimeHostSignals, type RuntimeLifecycle } from '@vibesdotdev/kernel';
+export interface ProcessActionLifetime {
+    /**
+     * Request cleanup and completion. The first request owns cleanup; later
+     * requests await the same result. A caller that only fires the request
+     * (`void lifetime.request(reason)`) needs no rejection handler: `wait()` is
+     * the owner's observer of a cleanup failure.
+     */
+    request(reason: string): Promise<void>;
+    /** Await cleanup completion, then detach any installed signal handlers. */
+    wait(): Promise<void>;
+    /**
+     * Route SIGINT/SIGTERM into request() without terminating the process, through the
+     * runtime's host-signals provider handed as `options.signals`. Refuses
+     * `host-signals-undeclared` when the lifetime was created without one.
+     */
+    bindProcessSignals(): void;
+}
+/**
+ * Own a long-running process action without claiming ownership of the process.
+ *
+ * Signal and transport callbacks request shutdown; the caller awaits wait().
+ * Executable hosts can therefore finish their own lifecycle only after cleanup
+ * has genuinely completed, with no library-level process.exit race.
+ */
+export interface ProcessActionLifetimeOptions {
+    /**
+     * Longest cleanup may run once requested, as the owning runtime's bounded
+     * wait (RC07): `lifecycle` is that runtime's (`runtime.lifecycle`). Past
+     * `ms`, wait() rejects `TIMEOUT wait-timeout` (details carry the reason), so
+     * a hung cleanup ends the action instead of leaving a process that only
+     * SIGKILL can stop. If the runtime itself is disposed first, wait() rejects
+     * `CANCELLED wait-aborted` and the runtime's finalization budget bounds what
+     * remains. Omit for no bound.
+     */
+    /**
+     * The owning runtime's host-signals provider (`getRuntimeHostSignals(runtime)`): the only
+     * way this lifetime listens for SIGINT/SIGTERM. Omit it and `bindProcessSignals()` refuses.
+     */
+    signals?: RuntimeHostSignals;
+    cleanupDeadline?: {
+        readonly ms: number;
+        readonly lifecycle: Pick<RuntimeLifecycle, 'wait'>;
+    };
+}
+export declare function createProcessActionLifetime(cleanup: (reason: string) => void | Promise<void>, options?: ProcessActionLifetimeOptions): ProcessActionLifetime;
+//# sourceMappingURL=process-action-lifetime.consumer.d.ts.map

package/dist/services/process-action-lifetime.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-action-lifetime.consumer.d.ts","sourceRoot":"","sources":["../../src/services/process-action-lifetime.consumer.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEtG,MAAM,WAAW,qBAAqB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,2EAA2E;IAC3E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;OAIG;IACH,kBAAkB,IAAI,IAAI,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC5C;;;;;;;;OAQG;IACH;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,eAAe,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC9F;AAED,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACjD,OAAO,GAAE,4BAAiC,GACxC,qBAAqB,CAiEvB"}

package/dist/services/process-action-lifetime.consumer.js

@@ -0,0 +1,68 @@
+import { attemptNative } from "./workspace-root-probe.impl.bun.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+export function createProcessActionLifetime(cleanup, options = {}) {
+    let requested = false;
+    const { promise: done, resolve: resolveDone, reject: rejectDone } = Promise.withResolvers();
+    /**
+     * wait()'s view of `done`: the failure is carried as a value, never dropped,
+     * and rethrown by wait(). Deriving it here gives `done` its observer from
+     * the start, so a fired request never leaves an unhandled rejection.
+     */
+    const outcome = done.then(() => null, (error) => ({ error }));
+    const subscriptions = new Map();
+    const request = (reason) => {
+        if (!requested) {
+            requested = true;
+            const run = () => Promise.resolve().then(() => cleanup(reason));
+            const deadline = options.cleanupDeadline;
+            const bounded = deadline
+                ? deadline.lifecycle.wait(run, { timeoutMs: deadline.ms, reason: `process-action-cleanup:${reason}` })
+                : run();
+            bounded.then(resolveDone, rejectDone);
+        }
+        return done;
+    };
+    /** Detach every subscription; the failures of those that would not detach, in order. */
+    const detachAll = () => {
+        const owned = [...subscriptions.values()];
+        subscriptions.clear();
+        const failures = [];
+        for (const detach of owned) {
+            const detached = attemptNative(detach);
+            if ('failure' in detached)
+                failures.push(detached.failure.cause instanceof Error ? detached.failure.cause : new Error('A signal subscription failed to detach.', { cause: detached.failure.cause }));
+        }
+        return failures;
+    };
+    return {
+        request,
+        bindProcessSignals: () => {
+            const signals = options.signals;
+            if (signals === undefined) {
+                throw new CapabilityError('This lifetime was created without a host-signals provider.', 'UNAVAILABLE', {
+                    reason: 'host-signals-undeclared', retryable: false
+                });
+            }
+            for (const signal of ['SIGINT', 'SIGTERM']) {
+                if (subscriptions.has(signal))
+                    continue;
+                // wait() is the observer of a cleanup failure.
+                subscriptions.set(signal, signals.subscribe(signal, () => { void request(signal); }));
+            }
+        },
+        wait: async () => {
+            const failure = await outcome;
+            const detachFailures = detachAll();
+            if (failure !== null && detachFailures.length > 0) {
+                throw new AggregateError([failure.error, ...detachFailures], 'Cleanup and signal detachment both failed.');
+            }
+            if (detachFailures.length > 1)
+                throw new AggregateError(detachFailures, 'Signal subscriptions failed to detach.');
+            if (detachFailures[0] !== undefined)
+                throw detachFailures[0];
+            if (failure !== null)
+                throw failure.error;
+        }
+    };
+}
+//# sourceMappingURL=process-action-lifetime.consumer.js.map

package/dist/services/process-action-lifetime.consumer.js.map

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

package/dist/services/process-view.impl.bun.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The Bun host's process views: the kernel's process-view base
+ * (`createProcessViews`, the probe each view runs and how its output parses)
+ * over this host's own synchronous probe and captured platform.
+ *
+ * The probe is this host's native spawn (`../process/process-probe.impl.bun.ts`),
+ * bounded and without a console window; the kernel turns its result into an
+ * answer (`answerProbeSync`) and a probe that could not run refuses
+ * `UNAVAILABLE` `process-table-unavailable`.
+ */
+export { parseElapsed, type ProcessViewCommands, type ProcessViewOptions } from '@vibesdotdev/execution-local';
+/** The platform this host process reported once, at load: the probe's answer for a caller that declares none. */
+export declare const bunProcessViews: {
+    readProcessStartMs: (pid: number, options: import("@vibesdotdev/execution-local").ProcessViewOptions) => number | null;
+    readProcessExecutablePath: (pid: number, options: import("@vibesdotdev/execution-local").ProcessViewOptions) => string | null;
+};
+export declare const readProcessStartMs: (pid: number, options: import("@vibesdotdev/execution-local").ProcessViewOptions) => number | null, readProcessExecutablePath: (pid: number, options: import("@vibesdotdev/execution-local").ProcessViewOptions) => string | null;
+//# sourceMappingURL=process-view.impl.bun.d.ts.map

package/dist/services/process-view.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-view.impl.bun.d.ts","sourceRoot":"","sources":["../../src/services/process-view.impl.bun.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAE/G,iHAAiH;AACjH,eAAO,MAAM,eAAe;;;CAAgE,CAAC;AAE7F,eAAO,MAAQ,kBAAkB,sGAAE,yBAAyB,oGAAoB,CAAC"}

package/dist/services/process-view.impl.bun.js

@@ -0,0 +1,17 @@
+/**
+ * The Bun host's process views: the kernel's process-view base
+ * (`createProcessViews`, the probe each view runs and how its output parses)
+ * over this host's own synchronous probe and captured platform.
+ *
+ * The probe is this host's native spawn (`../process/process-probe.impl.bun.ts`),
+ * bounded and without a console window; the kernel turns its result into an
+ * answer (`answerProbeSync`) and a probe that could not run refuses
+ * `UNAVAILABLE` `process-table-unavailable`.
+ */
+import { createProcessViews } from '@vibesdotdev/execution-local';
+import { probeSync } from "../process/process-probe.impl.bun.js";
+export { parseElapsed } from '@vibesdotdev/execution-local';
+/** The platform this host process reported once, at load: the probe's answer for a caller that declares none. */
+export const bunProcessViews = createProcessViews({ probeSync, platform: process.platform });
+export const { readProcessStartMs, readProcessExecutablePath } = bunProcessViews;
+//# sourceMappingURL=process-view.impl.bun.js.map