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

package/dist/runtime-plugin-host/source-watcher.consumer.js

@@ -0,0 +1,383 @@
+/**
+ * Source Watcher
+ *
+ * Watches the source files that were compiled into a tracked plugin's current
+ * generation and reports changes. Sibling of `storage-watcher` and
+ * `config-watcher`: same construct/start/stop/watch/unwatch shape, injected
+ * logger, and no ownership of what a change *means*.
+ *
+ * Directories are watched rather than individual files, because editors and
+ * formatters replace files by atomic rename — a per-file watch goes deaf the
+ * first time a save happens that way. Events for files outside the tracked set
+ * are dropped.
+ *
+ * ## ENOENT re-arm
+ *
+ * A directory can be absent when `watch()` is called, or can be REMOVED and
+ * recreated underneath a live watcher — `bun install` rebuilds a member's
+ * `node_modules` symlink farm exactly this way, `git checkout` of a branch that
+ * does not contain a directory does it, and so does any tool that writes a tree
+ * by "rename the old one away, move the new one in". Both cases used to end the
+ * same way: one `warn` line and a permanently deaf watcher, so HMR silently
+ * stopped reloading and the body drifted while claiming to be hot. Silence is
+ * the worst possible failure mode for a freshness mechanism.
+ *
+ * So a missing directory is not a terminal state. `armMissing` retries on a
+ * bounded interval until the directory exists (or the watch set changes), and a
+ * live watcher that errors is torn down and put back into the same retry queue.
+ * The timer is `unref`'d, so it never holds a process open.
+ *
+ * Platforms disagree on how a replaced directory looks to a live watcher:
+ * macOS FSEvents reports an error, while Linux inotify keeps following the
+ * moved-away inode and only reports a `rename`. So each armed directory
+ * records its identity (device + inode); a `rename` event, `watch()` and
+ * `rearm()` all compare it with the path's current identity, and a missing or
+ * replaced directory is torn down and re-armed like an errored one.
+ *
+ * `fs.watch` can drop a write that lands while the watch is arming. Arm and
+ * rearm stat each tracked file and report a change when its device, inode or
+ * mtime differs from the stamp already recorded. The first observation only
+ * records the stamp.
+ */
+import { watch, existsSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { getLogger } from '@vibesdotdev/logging';
+import { CaughtFailureSchema, isCapabilityError, settle, settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
+import z from 'zod/v4';
+function isRepeatStopped(error) {
+    return isCapabilityError(error) && (error.reason === 'wait-aborted' || error.reason === 'runtime-disposed');
+}
+/** Same cadence as the feature's lifecycle repeat. This host copy does not import the feature package. */
+function startLifecycleRepeat(runtime, lifecycle, ms, tick) {
+    const started = settleNow(() => lifecycle.interval(tick, ms));
+    if (started.ok)
+        return started.value;
+    if (!(isCapabilityError(started.cause) && started.cause.reason === 'lifecycle-interval-finite'))
+        throw started.cause;
+    const abort = new AbortController();
+    const loop = (async () => {
+        while (!abort.signal.aborted) {
+            const waited = await settle(() => lifecycle.delay(ms, abort.signal));
+            if (!waited.ok) {
+                if (isRepeatStopped(waited.cause))
+                    return;
+                throw waited.cause;
+            }
+            if (abort.signal.aborted)
+                return;
+            tick();
+        }
+    })();
+    void settle(() => loop).then((settled) => {
+        if (settled.ok || isRepeatStopped(settled.cause))
+            return;
+        const logger = getLogger('runtime-plugin.lifecycle-repeat', runtime);
+        logger.error('lifecycle.delay repeat failed', { error: valueFreeFailure(settled.cause) });
+    });
+    return () => {
+        abort.abort();
+    };
+}
+const DEFAULT_REARM_INTERVAL_MS = 2_000;
+/**
+ * Device + inode of a directory, or null when nothing (or a non-directory)
+ * is at the path. Other stat failures (EACCES, EMFILE…) propagate.
+ */
+function directoryIdentity(directory) {
+    const stat = statSync(directory, { throwIfNoEntry: false });
+    return stat?.isDirectory() ? `${stat.dev}:${stat.ino}` : null;
+}
+export class SourceWatcher {
+    watchers = new Map();
+    tracked = new Map();
+    onChange = null;
+    log;
+    /** Directories that should be watched but currently are not (ENOENT, EMFILE…). */
+    pending = new Set();
+    /** Last device, inode and mtime stat recorded for a tracked file. */
+    stamps = new Map();
+    rearmTimer = null;
+    rearmIntervalMs;
+    runtime;
+    constructor(options) {
+        this.log = options.logger ?? createNoopLogger('source-watcher');
+        this.rearmIntervalMs = options.rearmIntervalMs ?? DEFAULT_REARM_INTERVAL_MS;
+        this.runtime = options.runtime;
+    }
+    /** Directories currently waiting to be (re-)armed. Diagnostic. */
+    getPending() {
+        return new Set(this.pending);
+    }
+    /** Try once to arm every pending directory. Exposed so tests need no timer. */
+    rearm() {
+        for (const directory of Array.from(this.watchers.keys()))
+            this.verifyArmed(directory);
+        if (this.pending.size > 0) {
+            for (const directory of Array.from(this.pending)) {
+                if (!existsSync(directory))
+                    continue;
+                if (this.armDirectory(directory)) {
+                    this.log.info('re-armed source watch after the directory reappeared', { directory });
+                }
+            }
+        }
+        for (const directory of this.watchers.keys())
+            this.syncTracked(directory);
+        if (this.pending.size === 0)
+            this.stopRearmTimer();
+    }
+    startRearmTimer() {
+        if (this.rearmTimer || this.pending.size === 0)
+            return;
+        this.rearmTimer = startLifecycleRepeat(this.runtime, this.runtime.lifecycle, this.rearmIntervalMs, () => this.rearm());
+    }
+    stopRearmTimer() {
+        if (!this.rearmTimer)
+            return;
+        this.rearmTimer();
+        this.rearmTimer = null;
+    }
+    /** Close one armed watcher and, if the directory is still wanted, queue it for re-arm. */
+    disarm(directory) {
+        const armed = this.watchers.get(directory);
+        if (!armed)
+            return;
+        armed.watcher.close();
+        this.watchers.delete(directory);
+        if (this.wantedDirectories().has(directory)) {
+            this.pending.add(directory);
+            this.startRearmTimer();
+        }
+    }
+    /**
+     * Re-arm an armed directory whose path no longer names the directory the
+     * watcher was opened on (removed, or replaced by rename). Returns true when
+     * the existing watcher is still valid.
+     */
+    verifyArmed(directory) {
+        const armed = this.watchers.get(directory);
+        if (!armed)
+            return false;
+        const inspected = settleNow(() => directoryIdentity(directory));
+        if (!inspected.ok) {
+            this.log.warn('cannot inspect watched directory — requeueing for re-arm', {
+                directory,
+                error: valueFreeFailure(inspected.cause)
+            });
+            this.disarm(directory);
+            return false;
+        }
+        const identity = inspected.value;
+        if (identity === armed.identity)
+            return true;
+        this.log.info('watched directory was replaced — re-arming', { directory });
+        this.disarm(directory);
+        if (existsSync(directory))
+            this.armDirectory(directory);
+        return false;
+    }
+    /**
+     * Arm one directory. Returns true when a watcher is now installed; false
+     * leaves the directory in `pending` for the re-arm loop.
+     */
+    armDirectory(directory) {
+        if (this.watchers.has(directory) && this.verifyArmed(directory)) {
+            this.pending.delete(directory);
+            return true;
+        }
+        if (this.watchers.has(directory))
+            return true;
+        const armed = settleNow(() => {
+            const identity = directoryIdentity(directory);
+            if (identity === null) {
+                this.pending.add(directory);
+                this.startRearmTimer();
+                return false;
+            }
+            const watcher = watch(directory, (event, filename) => {
+                if (event === 'rename')
+                    this.verifyArmed(directory);
+                if (!filename)
+                    return;
+                const absolute = join(directory, filename.toString());
+                if (!this.tracked.get(directory)?.has(absolute))
+                    return;
+                this.remember(absolute);
+                this.onChange?.(absolute);
+            });
+            watcher.on('error', (cause) => {
+                // A live watcher whose directory was replaced (rename-in) reports
+                // here and then never fires again. Tear it down and requeue rather
+                // than logging once and going deaf.
+                this.log.warn('watch error — requeueing directory for re-arm', {
+                    directory,
+                    error: valueFreeFailure(cause)
+                });
+                this.disarm(directory);
+                return cause;
+            });
+            if ('unref' in watcher)
+                watcher.unref();
+            this.watchers.set(directory, { watcher, identity });
+            this.pending.delete(directory);
+            this.syncTracked(directory);
+            return true;
+        });
+        if (armed.ok)
+            return armed.value;
+        this.pending.add(directory);
+        this.startRearmTimer();
+        this.log.warn('failed to watch directory — will retry', {
+            directory,
+            retryMs: this.rearmIntervalMs,
+            error: valueFreeFailure(armed.cause)
+        });
+        return false;
+    }
+    wantedDirectories() {
+        return new Set(this.tracked.keys());
+    }
+    /** Replace the tracked file set. Directories no longer needed are released. */
+    watch(files, onChange) {
+        this.onChange = onChange;
+        this.tracked.clear();
+        for (const file of files) {
+            const absolute = resolve(file);
+            const directory = dirname(absolute);
+            let sources = this.tracked.get(directory);
+            if (!sources) {
+                sources = new Set();
+                this.tracked.set(directory, sources);
+            }
+            sources.add(absolute);
+        }
+        for (const file of this.stamps.keys()) {
+            if (!this.tracked.get(dirname(file))?.has(file))
+                this.stamps.delete(file);
+        }
+        const wanted = this.wantedDirectories();
+        for (const [directory, armed] of this.watchers) {
+            if (wanted.has(directory))
+                continue;
+            armed.watcher.close();
+            this.watchers.delete(directory);
+        }
+        for (const directory of Array.from(this.pending)) {
+            if (!wanted.has(directory))
+                this.pending.delete(directory);
+        }
+        for (const directory of wanted) {
+            this.armDirectory(directory);
+        }
+        if (this.pending.size === 0)
+            this.stopRearmTimer();
+    }
+    /** Directories currently held open. */
+    getWatched() {
+        return new Set(this.watchers.keys());
+    }
+    /** Files currently eligible to raise a change. */
+    getTracked() {
+        const tracked = new Set();
+        for (const files of this.tracked.values()) {
+            for (const file of files)
+                tracked.add(file);
+        }
+        return tracked;
+    }
+    unwatchAll() {
+        for (const armed of this.watchers.values())
+            armed.watcher.close();
+        this.watchers.clear();
+        this.pending.clear();
+        this.stopRearmTimer();
+        this.tracked.clear();
+        this.stamps.clear();
+        this.onChange = null;
+    }
+    /** Stat one tracked file. A missing path is a null stamp; other stat failures propagate. */
+    readStamp(file) {
+        try {
+            const stat = statSync(file);
+            if (!stat.isFile())
+                return null;
+            return { dev: stat.dev, ino: stat.ino, mtimeMs: stat.mtimeMs };
+        }
+        catch (error) {
+            if (valueFreeFailure(CaughtFailureSchema.parse(error)).code === 'ENOENT')
+                return null;
+            throw error;
+        }
+    }
+    sameStamp(previous, next) {
+        if (previous === null || next === null)
+            return previous === next;
+        return previous.dev === next.dev && previous.ino === next.ino && previous.mtimeMs === next.mtimeMs;
+    }
+    /** Record the stamp `fs.watch` just delivered so a later rearm does not report it again. */
+    remember(file) {
+        const settled = settleNow(() => {
+            this.stamps.set(file, this.readStamp(file));
+        });
+        if (settled.ok)
+            return;
+        this.log.warn('cannot stat tracked source file', {
+            file,
+            failure: valueFreeFailure(settled.cause)
+        });
+    }
+    /**
+     * Report tracked files in `directory` whose device, inode or mtime moved
+     * since the stamp on record. The first observation only records the stamp.
+     */
+    syncTracked(directory) {
+        const files = this.tracked.get(directory);
+        if (!files)
+            return;
+        for (const file of files) {
+            const settled = settleNow(() => this.readStamp(file));
+            if (!settled.ok) {
+                this.log.warn('cannot stat tracked source file', {
+                    file,
+                    failure: valueFreeFailure(settled.cause)
+                });
+                continue;
+            }
+            const next = settled.value;
+            const previous = this.stamps.get(file);
+            if (previous === undefined) {
+                this.stamps.set(file, next);
+                continue;
+            }
+            if (this.sameStamp(previous, next))
+                continue;
+            this.stamps.set(file, next);
+            this.onChange?.(file);
+        }
+    }
+    /** Alias matching the sibling watchers' lifecycle vocabulary. */
+    stop() {
+        this.unwatchAll();
+    }
+}
+function createNoopLogger(namespace) {
+    const noop = () => { };
+    return {
+        namespace,
+        fullNamespace: namespace,
+        debug: noop,
+        info: noop,
+        warn: noop,
+        error: noop,
+        child: (opts) => {
+            const text = z.string().safeParse(opts);
+            if (text.success)
+                return createNoopLogger(`${namespace}:${text.data}`);
+            const named = z.object({ namespace: z.string().optional() }).safeParse(opts);
+            const suffix = named.success ? (named.data.namespace ?? 'child') : 'child';
+            return createNoopLogger(`${namespace}:${suffix}`);
+        },
+        withContext: () => createNoopLogger(namespace)
+    };
+}
+//# sourceMappingURL=source-watcher.consumer.js.map

package/dist/runtime-plugin-host/source-watcher.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-watcher.consumer.js","sourceRoot":"","sources":["../../src/runtime-plugin-host/source-watcher.consumer.ts"],"names":[],"mappings":"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"}

package/dist/schemas/environment.d.ts

@@ -0,0 +1,197 @@
+/** The Bun host's declarations: its environment options and the plugin options around them. */
+import * as z from 'zod/v4';
+import type { HostFileLoggingOptions } from '@vibesdotdev/logging/host-files';
+import type { PathRootsOrigin } from '@vibesdotdev/paths';
+import type { RuntimeExecutionLocalPluginOptions } from '@vibesdotdev/execution-local';
+import type { BunHostDeclaration } from '../host-channel.impl.bun.ts';
+/** What a host reads about its machine: the CPUs it reports and its total memory. */
+export interface BunSystemResourceReading {
+    readonly cpus: readonly {
+        readonly model: string;
+    }[];
+    readonly totalMemoryBytes: number;
+}
+export declare const BunScopeSchema: z.ZodObject<{
+    hardware: z.ZodEnum<{
+        consumer: "consumer";
+        cloud: "cloud";
+    }>;
+    workspace: z.ZodOptional<z.ZodObject<{
+        root: z.ZodOptional<z.ZodString>;
+        access: z.ZodOptional<z.ZodEnum<{
+            read: "read";
+            write: "write";
+        }>>;
+    }, z.core.$strict>>;
+    hosting: z.ZodObject<{
+        mode: z.ZodUnion<readonly [z.ZodEnum<{
+            local: "local";
+            hosted: "hosted";
+            "managed-cloud": "managed-cloud";
+        }>, z.ZodString]>;
+        owner: z.ZodUnion<readonly [z.ZodEnum<{
+            consumer: "consumer";
+            customer: "customer";
+            vibes: "vibes";
+        }>, z.ZodString]>;
+        venue: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            "user-device": "user-device";
+            "ipc-worker": "ipc-worker";
+            doks: "doks";
+            "cloudflare-workers": "cloudflare-workers";
+            "digitalocean-functions": "digitalocean-functions";
+        }>, z.ZodString]>>;
+        provider: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    capabilities: z.ZodOptional<z.ZodObject<{
+        requestPrincipals: z.ZodOptional<z.ZodBoolean>;
+        interactiveSession: z.ZodOptional<z.ZodBoolean>;
+        hostCredentials: z.ZodOptional<z.ZodBoolean>;
+        sharedHost: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    purpose: z.ZodEnum<{
+        agent: "agent";
+        worker: "worker";
+        mcp: "mcp";
+        direct: "direct";
+        projection: "projection";
+    }>;
+    surface: z.ZodEnum<{
+        agent: "agent";
+        browser: "browser";
+        ssr: "ssr";
+        cli: "cli";
+        tui: "tui";
+        worker: "worker";
+        mcp: "mcp";
+        bridge: "bridge";
+    }>;
+    lifecycle: z.ZodEnum<{
+        finite: "finite";
+        persistent: "persistent";
+    }>;
+    qualifiers: z.ZodOptional<z.ZodObject<{
+        dev: z.ZodOptional<z.ZodBoolean>;
+        building: z.ZodOptional<z.ZodBoolean>;
+        environmentTier: z.ZodOptional<z.ZodEnum<{
+            local: "local";
+            dev: "dev";
+            staging: "staging";
+            production: "production";
+        }>>;
+        profile: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        cef: z.ZodOptional<z.ZodBoolean>;
+        trustedOrigin: z.ZodOptional<z.ZodString>;
+        rendererGeneration: z.ZodOptional<z.ZodNumber>;
+        filesystem: z.ZodOptional<z.ZodString>;
+        browserBackend: z.ZodOptional<z.ZodString>;
+        workspaceSessionId: z.ZodOptional<z.ZodString>;
+        workspaceTarget: z.ZodOptional<z.ZodString>;
+        repositoryId: z.ZodOptional<z.ZodString>;
+        remoteHostId: z.ZodOptional<z.ZodString>;
+        connectionMode: z.ZodOptional<z.ZodString>;
+        outreachExportsDir: z.ZodOptional<z.ZodString>;
+        serve: z.ZodOptional<z.ZodString>;
+        hotReload: z.ZodOptional<z.ZodEnum<{
+            on: "on";
+            off: "off";
+        }>>;
+        loaderTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type BunScopeDeclaration = z.infer<typeof BunScopeSchema>;
+/** The facts a scope resolver is handed beside the capture: the platform this environment captured. */
+export interface BunScopeHostFacts {
+    readonly platform: string;
+}
+export type BunScopeResolver = (captured: Readonly<Record<string, string>>, host: BunScopeHostFacts) => BunScopeDeclaration;
+export interface BunPathSelection {
+    /** Explicit absolute home selected by the surface. Test isolation uses this seam. */
+    vibesHome?: string;
+    profileName?: string;
+    configDir?: string;
+    logDir?: string;
+    tempDir?: string;
+    origin?: PathRootsOrigin;
+}
+export interface BunEnvironmentOptions {
+    /** The host's file logging (`{ files: false }` opts out); this host's own logging plugin supplies it. */
+    logging?: HostFileLoggingOptions;
+    /**
+     * The host's declared scope. The environment adds only the facts it owns:
+     * `qualifiers.os` and `qualifiers.dev` (source mode is dev, a compiled
+     * executable is not), unless the declaration names them.
+     *
+     * A function receives this environment's capture and returns the
+     * declaration. It runs once, right after the capture, so a host declares
+     * facts it learns from its own environment (the CLI's `hostCredentials`
+     * capability from a live `VIBES_HOST_CREDENTIALS` manifest) without
+     * reading `process.env` itself, and the hardware the shim baked).
+     */
+    scope: unknown | BunScopeResolver;
+    /**
+     * Host facts the host declares; validated at capture. `shimChannel: true`
+     * takes R, the entry and self-spawn from the captured shim channel; any other
+     * host has no R unless it passes `root` (D1).
+     */
+    host?: BunHostDeclaration;
+    /** Filesystem selection published as the immutable paths/roots descriptor. */
+    paths?: BunPathSelection;
+    /**
+     * The host's system-resource read, called once at construction. Absent, the
+     * environment reads the machine it runs on. A declared reading is validated
+     * exactly like the native one: memory must be a positive finite number and
+     * each CPU must name a model; no CPUs publishes a null model.
+     */
+    systemResources?: () => BunSystemResourceReading;
+}
+/** A Bun host's declaration: its environment, plus what it composes around it. */
+export interface RuntimeEnvironmentBunPluginOptions extends BunEnvironmentOptions {
+    /** Physical streams and fatal source shared explicitly by composed runtimes. */
+    hostResources?: import('./host-resources.ts').BunHostResources;
+    /** Lazy, runtime-local native artifacts for explicitly requested child resource enforcement. */
+    nativeLaunch?: RuntimeExecutionLocalPluginOptions['nativeLaunch'];
+    /**
+     * The host's admission for restricted execution: the one writable base a
+     * restricted workload may write under. Declared by the host, never read
+     * from the environment, and passed to the local execution plugin. Absent,
+     * the host composes today's local execution and a restricted request
+     * refuses `restricted-base-undeclared`.
+     */
+    restrictedExecution?: {
+        writableBase: string;
+    };
+    /**
+     * The host's installed B7 held-launch artifacts: the exact absolute path of
+     * their `manifest.json` (a bundle stages the paired library, helper and
+     * manifest under `<hostRoot>/native/held-launch/manifest.json`). Declared by the host and
+     * passed to local execution; never resolved from a package tree, a
+     * directory walk or the environment.
+     */
+    heldLaunch?: {
+        manifestPath: string;
+    };
+    /**
+     * The host's budget in milliseconds for the native endpoint probe that proves a local socket file
+     * unowned before the socket service removes it. Absent, the probe's own default (5 s); a host on a
+     * loaded machine declares more, because the tool walks every process.
+     */
+    socketProbeTimeoutMs?: number;
+    /**
+     * The host's budget in milliseconds for each process-table probe (`ps`, `lsof`) the runtime process
+     * service runs to read a process's identity. Absent, the probe's own default; a host on a loaded
+     * machine declares more. Forwarded to the node process service, which refuses a value that is not
+     * a positive integer (`process-probe-timeout-invalid`).
+     */
+    processProbeTimeoutMs?: number;
+    /**
+     * Whether this environment registers the `filesystem/adapter` kind with
+     * this host's adapter (default `true`). A host that composes its own filesystem
+     * provider, or none (a probe that must fail closed without one), declares
+     * `false`; LocalDB then refuses `localdb-filesystem-unavailable` unless the
+     * composition supplies a provider.
+     */
+    hostFileSystem?: boolean;
+}
+//# sourceMappingURL=environment.d.ts.map

package/dist/schemas/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/schemas/environment.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,8BAA8B,CAAC;AAEvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,qFAAqF;AACrF,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEzB,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACjE,uGAAuG;AACvG,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,KAAK,mBAAmB,CAAC;AAE5H,MAAM,WAAW,gBAAgB;IAChC,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACrC,yGAAyG;IACzG,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC;;;;;;;;;;OAUG;IACH,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,wBAAwB,CAAC;CACjD;AAED,kFAAkF;AAClF,MAAM,WAAW,kCAAmC,SAAQ,qBAAqB;IAChF,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,qBAAqB,EAAE,gBAAgB,CAAC;IAC/D,gGAAgG;IAChG,YAAY,CAAC,EAAE,kCAAkC,CAAC,cAAc,CAAC,CAAC;IAClE;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;;;;OAMG;IACH,UAAU,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/schemas/environment.js

@@ -0,0 +1,7 @@
+/** The Bun host's declarations: its environment options and the plugin options around them. */
+import * as z from 'zod/v4';
+import { DeclaredRuntimeScopeSchema } from '@vibesdotdev/kernel/schemas/scope';
+export const BunScopeSchema = DeclaredRuntimeScopeSchema.extend({
+    qualifiers: DeclaredRuntimeScopeSchema.shape.qualifiers.partial({ dev: true }).optional()
+});
+//# sourceMappingURL=environment.js.map

package/dist/schemas/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/schemas/environment.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAS/E,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC,MAAM,CAAC;IAC/D,UAAU,EAAE,0BAA0B,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzF,CAAC,CAAC"}