@evermore.work/server 2026.509.0-canary.0

package/dist/services/plugin-dev-watcher.js

@@ -0,0 +1,241 @@
+/**
+ * PluginDevWatcher — watches local-path plugin directories for file changes
+ * and triggers worker restarts so plugin authors get a fast rebuild-and-reload
+ * cycle without manually restarting the server.
+ *
+ * Only plugins installed from a local path (i.e. those with a non-null
+ * `packagePath` in the DB) are watched. File changes in the plugin's package
+ * directory trigger a debounced worker restart via the lifecycle manager.
+ *
+ * Uses chokidar rather than raw fs.watch so we get a production-grade watcher
+ * backend across platforms and avoid exhausting file descriptors as quickly in
+ * large dev workspaces.
+ *
+ * @see PLUGIN_SPEC.md §27.2 — Local Development Workflow
+ */
+import chokidar from "chokidar";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import path from "node:path";
+import { logger } from "../middleware/logger.js";
+const log = logger.child({ service: "plugin-dev-watcher" });
+/** Debounce interval for file changes (ms). */
+const DEBOUNCE_MS = 500;
+function shouldIgnorePath(filename) {
+    if (!filename)
+        return false;
+    const normalized = filename.replace(/\\/g, "/");
+    const segments = normalized.split("/").filter(Boolean);
+    return segments.some((segment) => segment === "node_modules" ||
+        segment === ".git" ||
+        segment === ".vite" ||
+        segment === ".evermore-sdk" ||
+        segment.startsWith("."));
+}
+export function resolvePluginWatchTargets(packagePath, fsDeps) {
+    const fileExists = fsDeps?.existsSync ?? existsSync;
+    const readFile = fsDeps?.readFileSync ?? readFileSync;
+    const readDir = fsDeps?.readdirSync ?? readdirSync;
+    const statFile = fsDeps?.statSync ?? statSync;
+    const absPath = path.resolve(packagePath);
+    const targets = new Map();
+    function addWatchTarget(targetPath, recursive, kind) {
+        const resolved = path.resolve(targetPath);
+        if (!fileExists(resolved))
+            return;
+        const inferredKind = kind ?? (statFile(resolved).isDirectory() ? "dir" : "file");
+        const existing = targets.get(resolved);
+        if (existing) {
+            existing.recursive = existing.recursive || recursive;
+            return;
+        }
+        targets.set(resolved, { path: resolved, recursive, kind: inferredKind });
+    }
+    function addRuntimeFilesFromDir(dirPath) {
+        if (!fileExists(dirPath))
+            return;
+        for (const entry of readDir(dirPath, { withFileTypes: true })) {
+            const entryPath = path.join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                addRuntimeFilesFromDir(entryPath);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (!entry.name.endsWith(".js") && !entry.name.endsWith(".css"))
+                continue;
+            addWatchTarget(entryPath, false, "file");
+        }
+    }
+    const packageJsonPath = path.join(absPath, "package.json");
+    addWatchTarget(packageJsonPath, false, "file");
+    if (!fileExists(packageJsonPath)) {
+        return [...targets.values()];
+    }
+    let packageJson = null;
+    try {
+        packageJson = JSON.parse(readFile(packageJsonPath, "utf8"));
+    }
+    catch {
+        packageJson = null;
+    }
+    const entrypointPaths = [
+        packageJson?.evermorePlugin?.manifest,
+        packageJson?.evermorePlugin?.worker,
+        packageJson?.evermorePlugin?.ui,
+    ].filter((value) => typeof value === "string" && value.length > 0);
+    if (entrypointPaths.length === 0) {
+        addRuntimeFilesFromDir(path.join(absPath, "dist"));
+        return [...targets.values()];
+    }
+    for (const relativeEntrypoint of entrypointPaths) {
+        const resolvedEntrypoint = path.resolve(absPath, relativeEntrypoint);
+        if (!fileExists(resolvedEntrypoint))
+            continue;
+        const stat = statFile(resolvedEntrypoint);
+        if (stat.isDirectory()) {
+            addRuntimeFilesFromDir(resolvedEntrypoint);
+        }
+        else {
+            addWatchTarget(resolvedEntrypoint, false, "file");
+        }
+    }
+    return [...targets.values()].sort((a, b) => a.path.localeCompare(b.path));
+}
+/**
+ * Create a PluginDevWatcher that monitors local plugin directories and
+ * restarts workers on file changes.
+ */
+export function createPluginDevWatcher(lifecycle, resolvePluginPackagePath, fsDeps) {
+    const watchers = new Map();
+    const debounceTimers = new Map();
+    const fileExists = fsDeps?.existsSync ?? existsSync;
+    function watchPlugin(pluginId, packagePath) {
+        // Don't double-watch
+        if (watchers.has(pluginId))
+            return;
+        const absPath = path.resolve(packagePath);
+        if (!fileExists(absPath)) {
+            log.warn({ pluginId, packagePath: absPath }, "plugin-dev-watcher: package path does not exist, skipping watch");
+            return;
+        }
+        try {
+            const watcherTargets = resolvePluginWatchTargets(absPath, fsDeps);
+            if (watcherTargets.length === 0) {
+                log.warn({ pluginId, packagePath: absPath }, "plugin-dev-watcher: no valid watch targets found, skipping watch");
+                return;
+            }
+            const watcher = chokidar.watch(watcherTargets.map((target) => target.path), {
+                ignoreInitial: true,
+                awaitWriteFinish: {
+                    stabilityThreshold: 200,
+                    pollInterval: 100,
+                },
+                ignored: (watchedPath) => {
+                    const relativePath = path.relative(absPath, watchedPath);
+                    return shouldIgnorePath(relativePath);
+                },
+            });
+            watcher.on("all", (_eventName, changedPath) => {
+                const relativePath = path.relative(absPath, changedPath);
+                if (shouldIgnorePath(relativePath))
+                    return;
+                const existing = debounceTimers.get(pluginId);
+                if (existing)
+                    clearTimeout(existing);
+                debounceTimers.set(pluginId, setTimeout(() => {
+                    debounceTimers.delete(pluginId);
+                    log.info({ pluginId, changedFile: relativePath || path.basename(changedPath) }, "plugin-dev-watcher: file change detected, restarting worker");
+                    lifecycle.restartWorker(pluginId).catch((err) => {
+                        log.warn({
+                            pluginId,
+                            err: err instanceof Error ? err.message : String(err),
+                        }, "plugin-dev-watcher: failed to restart worker after file change");
+                    });
+                }, DEBOUNCE_MS));
+            });
+            watcher.on("error", (err) => {
+                log.warn({
+                    pluginId,
+                    packagePath: absPath,
+                    err: err instanceof Error ? err.message : String(err),
+                }, "plugin-dev-watcher: watcher error, stopping watch for this plugin");
+                unwatchPlugin(pluginId);
+            });
+            watchers.set(pluginId, watcher);
+            log.info({
+                pluginId,
+                packagePath: absPath,
+                watchTargets: watcherTargets.map((target) => ({
+                    path: target.path,
+                    kind: target.kind,
+                })),
+            }, "plugin-dev-watcher: watching local plugin for changes");
+        }
+        catch (err) {
+            log.warn({
+                pluginId,
+                packagePath: absPath,
+                err: err instanceof Error ? err.message : String(err),
+            }, "plugin-dev-watcher: failed to start file watcher");
+        }
+    }
+    function unwatchPlugin(pluginId) {
+        const pluginWatcher = watchers.get(pluginId);
+        if (pluginWatcher) {
+            void pluginWatcher.close();
+            watchers.delete(pluginId);
+        }
+        const timer = debounceTimers.get(pluginId);
+        if (timer) {
+            clearTimeout(timer);
+            debounceTimers.delete(pluginId);
+        }
+    }
+    function close() {
+        lifecycle.off("plugin.loaded", handlePluginLoaded);
+        lifecycle.off("plugin.enabled", handlePluginEnabled);
+        lifecycle.off("plugin.disabled", handlePluginDisabled);
+        lifecycle.off("plugin.unloaded", handlePluginUnloaded);
+        for (const [pluginId] of watchers) {
+            unwatchPlugin(pluginId);
+        }
+    }
+    async function watchLocalPluginById(pluginId) {
+        if (!resolvePluginPackagePath)
+            return;
+        try {
+            const packagePath = await resolvePluginPackagePath(pluginId);
+            if (!packagePath)
+                return;
+            watchPlugin(pluginId, packagePath);
+        }
+        catch (err) {
+            log.warn({
+                pluginId,
+                err: err instanceof Error ? err.message : String(err),
+            }, "plugin-dev-watcher: failed to resolve plugin package path");
+        }
+    }
+    function handlePluginLoaded(payload) {
+        void watchLocalPluginById(payload.pluginId);
+    }
+    function handlePluginEnabled(payload) {
+        void watchLocalPluginById(payload.pluginId);
+    }
+    function handlePluginDisabled(payload) {
+        unwatchPlugin(payload.pluginId);
+    }
+    function handlePluginUnloaded(payload) {
+        unwatchPlugin(payload.pluginId);
+    }
+    lifecycle.on("plugin.loaded", handlePluginLoaded);
+    lifecycle.on("plugin.enabled", handlePluginEnabled);
+    lifecycle.on("plugin.disabled", handlePluginDisabled);
+    lifecycle.on("plugin.unloaded", handlePluginUnloaded);
+    return {
+        watch: watchPlugin,
+        unwatch: unwatchPlugin,
+        close,
+    };
+}
+//# sourceMappingURL=plugin-dev-watcher.js.map

package/dist/services/plugin-dev-watcher.js.map

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

package/dist/services/plugin-environment-driver.d.ts

@@ -0,0 +1,124 @@
+import type { Db } from "@evermore.work/db";
+import type { EnvironmentProbeResult, PluginEnvironmentConfig, PluginEnvironmentDriverDeclaration } from "@evermore.work/shared";
+import type { PluginEnvironmentExecuteParams, PluginEnvironmentExecuteResult, PluginEnvironmentLease, PluginEnvironmentRealizeWorkspaceParams, PluginEnvironmentRealizeWorkspaceResult } from "@evermore.work/plugin-sdk";
+import { pluginRegistryService } from "./plugin-registry.js";
+import type { PluginWorkerManager } from "./plugin-worker-manager.js";
+export declare function pluginDriverProviderKey(config: Pick<PluginEnvironmentConfig, "pluginKey" | "driverKey">): string;
+export declare function resolvePluginEnvironmentDriver(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    config: PluginEnvironmentConfig;
+}): Promise<{
+    plugin: {
+        id: string;
+        status: "error" | "installed" | "ready" | "disabled" | "upgrade_pending" | "uninstalled";
+        updatedAt: Date;
+        lastError: string | null;
+        version: string;
+        pluginKey: string;
+        apiVersion: number;
+        categories: ("automation" | "connector" | "workspace" | "ui")[];
+        packageName: string;
+        packagePath: string | null;
+        manifestJson: import("@evermore.work/shared").EvermorePluginManifestV1;
+        installOrder: number | null;
+        installedAt: Date;
+    };
+    driver: PluginEnvironmentDriverDeclaration;
+}>;
+export declare function resolvePluginEnvironmentDriverByKey(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    driverKey: string;
+}): Promise<{
+    plugin: Awaited<ReturnType<ReturnType<typeof pluginRegistryService>["list"]>>[number];
+    driver: PluginEnvironmentDriverDeclaration;
+} | null>;
+export declare function resolvePluginSandboxProviderDriverByKey(input: {
+    db: Db;
+    driverKey: string;
+    workerManager?: PluginWorkerManager;
+    requireRunning?: boolean;
+}): Promise<{
+    plugin: Awaited<ReturnType<ReturnType<typeof pluginRegistryService>["list"]>>[number];
+    driver: PluginEnvironmentDriverDeclaration;
+} | null>;
+export declare function listReadyPluginEnvironmentDrivers(input: {
+    db: Db;
+    workerManager?: PluginWorkerManager;
+}): Promise<{
+    pluginId: string;
+    pluginKey: string;
+    driverKey: string;
+    displayName: string;
+    description: string | undefined;
+    configSchema: import("@evermore.work/shared").JsonSchema;
+}[]>;
+export declare function validatePluginSandboxProviderConfig(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    provider: string;
+    config: Record<string, unknown>;
+}): Promise<{
+    normalizedConfig: Record<string, unknown>;
+    pluginId: string;
+    pluginKey: string;
+    driver: PluginEnvironmentDriverDeclaration;
+}>;
+export declare function validatePluginEnvironmentDriverConfig(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    config: PluginEnvironmentConfig;
+}): Promise<PluginEnvironmentConfig>;
+export declare function probePluginEnvironmentDriver(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    companyId: string;
+    environmentId: string;
+    config: PluginEnvironmentConfig;
+}): Promise<EnvironmentProbeResult>;
+export declare function probePluginSandboxProviderDriver(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    companyId: string;
+    environmentId: string;
+    provider: string;
+    config: Record<string, unknown>;
+}): Promise<EnvironmentProbeResult>;
+export declare function resumePluginEnvironmentLease(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    companyId: string;
+    environmentId: string;
+    config: PluginEnvironmentConfig;
+    providerLeaseId: string;
+    leaseMetadata?: Record<string, unknown>;
+}): Promise<PluginEnvironmentLease>;
+export declare function destroyPluginEnvironmentLease(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    companyId: string;
+    environmentId: string;
+    config: PluginEnvironmentConfig;
+    providerLeaseId: string | null;
+    leaseMetadata?: Record<string, unknown>;
+}): Promise<void>;
+export declare function realizePluginEnvironmentWorkspace(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    pluginId?: string | null;
+    params: PluginEnvironmentRealizeWorkspaceParams;
+    config: PluginEnvironmentConfig;
+}): Promise<PluginEnvironmentRealizeWorkspaceResult>;
+export declare function executePluginEnvironmentCommand(input: {
+    db: Db;
+    workerManager: PluginWorkerManager;
+    pluginId?: string | null;
+    params: PluginEnvironmentExecuteParams;
+    config: PluginEnvironmentConfig;
+}): Promise<PluginEnvironmentExecuteResult>;
+export declare function resolvePluginExecuteRpcTimeoutMs(input: {
+    requestedTimeoutMs?: number;
+    config: Record<string, unknown>;
+}): number | undefined;
+//# sourceMappingURL=plugin-environment-driver.d.ts.map

package/dist/services/plugin-environment-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-environment-driver.d.ts","sourceRoot":"","sources":["../../src/services/plugin-environment-driver.ts"],"names":[],"mappings":"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"}

package/dist/services/plugin-environment-driver.js

@@ -0,0 +1,224 @@
+import { unprocessable } from "../errors.js";
+import { pluginRegistryService } from "./plugin-registry.js";
+export function pluginDriverProviderKey(config) {
+    return `${config.pluginKey}:${config.driverKey}`;
+}
+export async function resolvePluginEnvironmentDriver(input) {
+    const pluginRegistry = pluginRegistryService(input.db);
+    const plugin = await pluginRegistry.getByKey(input.config.pluginKey);
+    if (!plugin || plugin.status !== "ready") {
+        throw new Error(`Plugin environment driver "${pluginDriverProviderKey(input.config)}" is not ready.`);
+    }
+    const driver = plugin.manifestJson.environmentDrivers?.find((candidate) => candidate.driverKey === input.config.driverKey);
+    if (!driver) {
+        throw new Error(`Plugin "${input.config.pluginKey}" does not declare environment driver "${input.config.driverKey}".`);
+    }
+    if (!input.workerManager.isRunning(plugin.id)) {
+        throw new Error(`Plugin environment driver "${pluginDriverProviderKey(input.config)}" has no running worker.`);
+    }
+    return { plugin, driver };
+}
+export async function resolvePluginEnvironmentDriverByKey(input) {
+    return await resolvePluginSandboxProviderDriverByKey({
+        db: input.db,
+        driverKey: input.driverKey,
+        workerManager: input.workerManager,
+        requireRunning: true,
+    });
+}
+export async function resolvePluginSandboxProviderDriverByKey(input) {
+    const pluginRegistry = pluginRegistryService(input.db);
+    const plugins = await pluginRegistry.list();
+    for (const plugin of plugins) {
+        const driver = plugin.manifestJson.environmentDrivers?.find((candidate) => candidate.driverKey === input.driverKey && candidate.kind === "sandbox_provider");
+        if (!driver)
+            continue;
+        if (input.requireRunning) {
+            if (plugin.status !== "ready")
+                continue;
+            if (!input.workerManager?.isRunning(plugin.id))
+                continue;
+        }
+        return { plugin, driver };
+    }
+    return null;
+}
+export async function listReadyPluginEnvironmentDrivers(input) {
+    if (!input.workerManager)
+        return [];
+    const pluginRegistry = pluginRegistryService(input.db);
+    const plugins = await pluginRegistry.list();
+    return plugins.flatMap((plugin) => {
+        if (plugin.status !== "ready" || !input.workerManager?.isRunning(plugin.id))
+            return [];
+        return (plugin.manifestJson.environmentDrivers ?? [])
+            .filter((driver) => driver.kind === "sandbox_provider")
+            .map((driver) => ({
+            pluginId: plugin.id,
+            pluginKey: plugin.pluginKey,
+            driverKey: driver.driverKey,
+            displayName: driver.displayName,
+            description: driver.description,
+            configSchema: driver.configSchema,
+        }));
+    });
+}
+export async function validatePluginSandboxProviderConfig(input) {
+    const resolved = await resolvePluginSandboxProviderDriverByKey({
+        db: input.db,
+        driverKey: input.provider,
+        workerManager: input.workerManager,
+        requireRunning: true,
+    });
+    if (!resolved) {
+        throw unprocessable(`Sandbox provider "${input.provider}" is not installed or its plugin worker is not running.`);
+    }
+    const result = await input.workerManager.call(resolved.plugin.id, "environmentValidateConfig", {
+        driverKey: input.provider,
+        config: input.config,
+    });
+    if (!result.ok) {
+        throw unprocessable(result.errors?.[0] ?? `Sandbox provider "${input.provider}" rejected its config.`, {
+            errors: result.errors ?? [],
+            warnings: result.warnings ?? [],
+        });
+    }
+    return {
+        normalizedConfig: result.normalizedConfig ?? input.config,
+        pluginId: resolved.plugin.id,
+        pluginKey: resolved.plugin.pluginKey,
+        driver: resolved.driver,
+    };
+}
+export async function validatePluginEnvironmentDriverConfig(input) {
+    const { plugin } = await resolvePluginEnvironmentDriver(input);
+    const result = await input.workerManager.call(plugin.id, "environmentValidateConfig", {
+        driverKey: input.config.driverKey,
+        config: input.config.driverConfig,
+    });
+    if (!result.ok) {
+        throw unprocessable(result.errors?.[0] ?? `Plugin environment driver "${pluginDriverProviderKey(input.config)}" rejected its config.`, {
+            errors: result.errors ?? [],
+            warnings: result.warnings ?? [],
+        });
+    }
+    return {
+        ...input.config,
+        driverConfig: result.normalizedConfig ?? input.config.driverConfig,
+    };
+}
+export async function probePluginEnvironmentDriver(input) {
+    const { plugin } = await resolvePluginEnvironmentDriver(input);
+    const result = await input.workerManager.call(plugin.id, "environmentProbe", {
+        driverKey: input.config.driverKey,
+        companyId: input.companyId,
+        environmentId: input.environmentId,
+        config: input.config.driverConfig,
+    });
+    return {
+        ok: result.ok,
+        driver: "plugin",
+        summary: result.summary ?? `Plugin environment driver "${pluginDriverProviderKey(input.config)}" probe ${result.ok ? "passed" : "failed"}.`,
+        details: {
+            pluginKey: input.config.pluginKey,
+            driverKey: input.config.driverKey,
+            diagnostics: result.diagnostics ?? [],
+            metadata: result.metadata ?? {},
+        },
+    };
+}
+export async function probePluginSandboxProviderDriver(input) {
+    const resolved = await resolvePluginEnvironmentDriverByKey({
+        db: input.db,
+        workerManager: input.workerManager,
+        driverKey: input.provider,
+    });
+    if (!resolved) {
+        return {
+            ok: false,
+            driver: "sandbox",
+            summary: `Sandbox provider "${input.provider}" is not installed or its plugin worker is not running.`,
+            details: {
+                provider: input.provider,
+            },
+        };
+    }
+    const { provider: _provider, ...driverConfig } = input.config;
+    const result = await input.workerManager.call(resolved.plugin.id, "environmentProbe", {
+        driverKey: input.provider,
+        companyId: input.companyId,
+        environmentId: input.environmentId,
+        config: driverConfig,
+    });
+    return {
+        ok: result.ok,
+        driver: "sandbox",
+        summary: result.summary ?? `Sandbox provider "${input.provider}" probe ${result.ok ? "passed" : "failed"}.`,
+        details: {
+            provider: input.provider,
+            pluginKey: resolved.plugin.pluginKey,
+            diagnostics: result.diagnostics ?? [],
+            metadata: result.metadata ?? {},
+        },
+    };
+}
+export async function resumePluginEnvironmentLease(input) {
+    const { plugin } = await resolvePluginEnvironmentDriver(input);
+    return await input.workerManager.call(plugin.id, "environmentResumeLease", {
+        driverKey: input.config.driverKey,
+        companyId: input.companyId,
+        environmentId: input.environmentId,
+        config: input.config.driverConfig,
+        providerLeaseId: input.providerLeaseId,
+        leaseMetadata: input.leaseMetadata,
+    });
+}
+export async function destroyPluginEnvironmentLease(input) {
+    const { plugin } = await resolvePluginEnvironmentDriver(input);
+    await input.workerManager.call(plugin.id, "environmentDestroyLease", {
+        driverKey: input.config.driverKey,
+        companyId: input.companyId,
+        environmentId: input.environmentId,
+        config: input.config.driverConfig,
+        providerLeaseId: input.providerLeaseId,
+        leaseMetadata: input.leaseMetadata,
+    });
+}
+export async function realizePluginEnvironmentWorkspace(input) {
+    const { plugin } = input.pluginId
+        ? { plugin: { id: input.pluginId } }
+        : await resolvePluginEnvironmentDriver({
+            db: input.db,
+            workerManager: input.workerManager,
+            config: input.config,
+        });
+    return await input.workerManager.call(plugin.id, "environmentRealizeWorkspace", input.params);
+}
+export async function executePluginEnvironmentCommand(input) {
+    const { plugin } = input.pluginId
+        ? { plugin: { id: input.pluginId } }
+        : await resolvePluginEnvironmentDriver({
+            db: input.db,
+            workerManager: input.workerManager,
+            config: input.config,
+        });
+    return await input.workerManager.call(plugin.id, "environmentExecute", input.params, resolvePluginExecuteRpcTimeoutMs({
+        requestedTimeoutMs: input.params.timeoutMs,
+        config: input.config.driverConfig,
+    }));
+}
+const RPC_OVERHEAD_BUFFER_MS = 30_000;
+export function resolvePluginExecuteRpcTimeoutMs(input) {
+    let baseMs;
+    if (Number.isFinite(input.requestedTimeoutMs) && (input.requestedTimeoutMs ?? 0) > 0) {
+        baseMs = Math.trunc(input.requestedTimeoutMs);
+    }
+    else {
+        const configTimeoutMs = typeof input.config.timeoutMs === "number" ? input.config.timeoutMs : null;
+        if (configTimeoutMs && Number.isFinite(configTimeoutMs) && configTimeoutMs > 0) {
+            baseMs = Math.trunc(configTimeoutMs);
+        }
+    }
+    return baseMs != null ? baseMs + RPC_OVERHEAD_BUFFER_MS : undefined;
+}
+//# sourceMappingURL=plugin-environment-driver.js.map

package/dist/services/plugin-environment-driver.js.map

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