@1mcp/agent 0.38.2 → 0.39.0-beta.0

package/build/core/server/runtimeDrain.js

@@ -0,0 +1,248 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { z } from 'zod';
+export const admissionSnapshotSchema = z.object({
+    closed: z.boolean(),
+    active: z.number().int().nonnegative(),
+    committed: z.boolean(),
+});
+function isDrained(snapshot) {
+    if (!snapshot?.closed)
+        return false;
+    return snapshot.active === 0;
+}
+export class RuntimeDrainingError extends Error {
+    code = -32004;
+    data = { retryable: true, reason: 'runtime_draining' };
+    constructor() {
+        super('Runtime is draining for replacement; retry after it resumes or the replacement activates.');
+    }
+}
+/** Admission and increment are synchronous. Nested dispatch retains its root until all work settles. */
+export class RuntimeAdmission {
+    closed = false;
+    committed = false;
+    active = 0;
+    context = new AsyncLocalStorage();
+    listeners = new Set();
+    snapshot() {
+        return { closed: this.closed, active: this.active, committed: this.committed };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    changed() {
+        for (const listener of this.listeners)
+            listener(this.snapshot());
+    }
+    begin() {
+        if (this.closed)
+            throw new RuntimeDrainingError();
+        this.active++;
+        this.changed();
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            this.active--;
+            this.changed();
+        };
+    }
+    /** Retain only an existing admitted root; transport observers never admit background work. */
+    retain() {
+        const root = this.context.getStore();
+        if (!root)
+            return undefined;
+        if (root.pending === 0)
+            return undefined;
+        root.pending++;
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            root.pending--;
+            if (root.pending === 0)
+                root.release();
+        };
+    }
+    async run(work) {
+        const inherited = this.context.getStore();
+        const root = inherited && inherited.pending > 0 ? inherited : { pending: 0, release: this.begin() };
+        root.pending++;
+        try {
+            return await this.context.run(root, work);
+        }
+        finally {
+            root.pending--;
+            if (root.pending === 0)
+                root.release();
+        }
+    }
+    close() {
+        this.closed = true;
+        this.changed();
+        return this.snapshot();
+    }
+    resume() {
+        if (this.committed)
+            throw new Error('Committed admission cannot resume');
+        this.closed = false;
+        this.changed();
+    }
+    commit() {
+        if (!isDrained(this.snapshot()))
+            throw new Error('Runtime is not drained');
+        this.committed = true;
+        this.changed();
+        return this.snapshot();
+    }
+}
+export const runtimeAdmission = new RuntimeAdmission();
+export function withRuntimeAdmission(work) {
+    return (...args) => runtimeAdmission.run(() => work(...args));
+}
+/** The supervisor owns this state; worker acknowledgements are supplied over its private IPC channel. */
+export class RuntimeReplacementDrain {
+    ports;
+    operation;
+    history = new Map();
+    timer;
+    snapshot;
+    resuming;
+    closing;
+    commitment;
+    constructor(ports) {
+        this.ports = ports;
+    }
+    async prepare(operationId, digest, timeoutMs = 30_000) {
+        if (!operationId || !digest || !Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
+            throw new Error('Invalid replacement preparation');
+        }
+        if (this.history.has(operationId)) {
+            this.match(operationId, digest);
+            return this.status(operationId);
+        }
+        if (this.operation && this.operation.state !== 'aborted')
+            throw new Error('Replacement already in progress');
+        if (this.closing)
+            await this.closing.catch(() => undefined);
+        if (this.resuming)
+            await this.resuming;
+        // Recheck after awaiting a previous resume: a competing prepare may have won.
+        if (this.operation && this.operation.state !== 'aborted')
+            throw new Error('Replacement already in progress');
+        if (this.history.size >= 128)
+            throw new Error('Replacement operation capacity reached; restart the runtime');
+        const operation = {
+            operationId,
+            digest,
+            state: 'preparing',
+            deadlineUnixMs: Date.now() + timeoutMs,
+            active: 0,
+        };
+        this.operation = operation;
+        this.history.set(operationId, operation);
+        this.snapshot = undefined;
+        this.timer = setTimeout(() => this.abort(operation), timeoutMs);
+        this.timer.unref?.();
+        try {
+            this.closing = this.ports.close();
+            const snapshot = await this.closing;
+            if (operation.state === 'aborted' || Date.now() >= operation.deadlineUnixMs) {
+                this.abort(operation);
+                // A late close acknowledgement may arrive after the deadline's resume.
+                this.resuming = this.ports.resume();
+                await this.resuming;
+                return { ...operation };
+            }
+            this.update(snapshot);
+        }
+        catch (error) {
+            this.abort(operation);
+            throw error;
+        }
+        return { ...operation };
+    }
+    /** Called only after observing the particular worker exit, before allowing a respawn. */
+    workerExited() {
+        this.snapshot = undefined;
+        const operation = this.operation;
+        if (!operation)
+            return false;
+        if (operation.state === 'committing')
+            return true;
+        this.abort(operation);
+        return false;
+    }
+    update(snapshot) {
+        this.snapshot = admissionSnapshotSchema.parse(snapshot);
+        const operation = this.operation;
+        if (!operation)
+            return;
+        if (operation.state === 'aborted')
+            return;
+        if (operation.state === 'committing')
+            return;
+        if (Date.now() >= operation.deadlineUnixMs) {
+            this.abort(operation);
+            return;
+        }
+        operation.active = snapshot.active;
+        operation.state = isDrained(snapshot) ? 'drained' : 'draining';
+    }
+    status(operationId) {
+        const operation = this.match(operationId);
+        if (operation.state === 'committing')
+            return { ...operation };
+        if (Date.now() >= operation.deadlineUnixMs)
+            this.abort(operation);
+        return { ...operation };
+    }
+    async commit(operationId, digest) {
+        const operation = this.match(operationId, digest);
+        if (operation.state === 'committing') {
+            await this.commitment;
+            return { ...operation };
+        }
+        this.status(operationId);
+        if (operation.state !== 'drained' || !isDrained(this.snapshot)) {
+            throw new Error('Replacement operation is not drained');
+        }
+        // The irreversible decision and expiry exclusion happen in one synchronous turn.
+        operation.state = 'committing';
+        clearTimeout(this.timer);
+        this.commitment = this.ports.commit().then((snapshot) => {
+            const confirmed = admissionSnapshotSchema.parse(snapshot);
+            if (!confirmed.closed || !confirmed.committed || confirmed.active !== 0) {
+                throw new Error('Worker did not confirm replacement commit; ownership must be retained');
+            }
+            return confirmed;
+        });
+        await this.commitment;
+        return { ...operation };
+    }
+    match(operationId, digest) {
+        const operation = this.history.get(operationId);
+        if (!operation)
+            throw new Error('Unknown replacement operation');
+        if (digest !== undefined && operation.digest !== digest)
+            throw new Error('Replacement digest mismatch');
+        return operation;
+    }
+    abort(operation) {
+        if (this.operation !== operation)
+            return;
+        if (operation.state === 'committing')
+            return;
+        if (operation.state === 'aborted')
+            return;
+        operation.state = 'aborted';
+        clearTimeout(this.timer);
+        // Keep a failed resume as a rejected barrier; a new prepare must not hide loss of worker control.
+        this.resuming = this.ports.resume();
+        void this.resuming.catch(() => undefined);
+    }
+}
+//# sourceMappingURL=runtimeDrain.js.map

package/build/core/server/runtimeDrain.js.map

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

package/build/core/server/runtimeLaunchIpc.d.ts

@@ -0,0 +1,285 @@
+import { type ChildProcess } from 'node:child_process';
+import { z } from 'zod';
+export declare const launchBootstrapSchema: z.ZodObject<{
+    type: z.ZodLiteral<"runtime-bootstrap">;
+    nonce: z.ZodString;
+    claimId: z.ZodOptional<z.ZodString>;
+    digest: z.ZodString;
+    snapshot: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        runtimeScope: z.ZodString;
+        configFilePath: z.ZodString;
+        mcpConfig: z.ZodObject<{
+            version: z.ZodOptional<z.ZodString>;
+            serverDefaults: z.ZodOptional<z.ZodObject<{
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                env: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodArray<z.ZodString>]>>;
+                inheritParentEnv: z.ZodOptional<z.ZodBoolean>;
+                envFilter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                restartOnExit: z.ZodOptional<z.ZodBoolean>;
+                maxRestarts: z.ZodOptional<z.ZodNumber>;
+                restartDelay: z.ZodOptional<z.ZodNumber>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                connectionTimeout: z.ZodOptional<z.ZodNumber>;
+                requestTimeout: z.ZodOptional<z.ZodNumber>;
+                oauth: z.ZodOptional<z.ZodObject<{
+                    clientId: z.ZodOptional<z.ZodString>;
+                    clientSecret: z.ZodOptional<z.ZodString>;
+                    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    autoRegister: z.ZodOptional<z.ZodBoolean>;
+                    redirectUrl: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            mcpServers: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodOptional<z.ZodEnum<{
+                    stdio: "stdio";
+                    http: "http";
+                    sse: "sse";
+                    streamableHttp: "streamableHttp";
+                }>>;
+                protocolVersion: z.ZodOptional<z.ZodEnum<{
+                    legacy: "legacy";
+                    auto: "auto";
+                    "2026-07-28": "2026-07-28";
+                }>>;
+                disabled: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+                disabledTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                instructionOverride: z.ZodOptional<z.ZodString>;
+                toolDescriptionOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                connectionTimeout: z.ZodOptional<z.ZodNumber>;
+                requestTimeout: z.ZodOptional<z.ZodNumber>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                oauth: z.ZodOptional<z.ZodObject<{
+                    clientId: z.ZodOptional<z.ZodString>;
+                    clientSecret: z.ZodOptional<z.ZodString>;
+                    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    autoRegister: z.ZodOptional<z.ZodBoolean>;
+                    redirectUrl: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                url: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                command: z.ZodOptional<z.ZodString>;
+                args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                stderr: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                    pipe: "pipe";
+                    overlapped: "overlapped";
+                    ignore: "ignore";
+                    inherit: "inherit";
+                }>, z.ZodNumber]>>;
+                cwd: z.ZodOptional<z.ZodString>;
+                env: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodArray<z.ZodString>]>>;
+                inheritParentEnv: z.ZodOptional<z.ZodBoolean>;
+                envFilter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                restartOnExit: z.ZodOptional<z.ZodBoolean>;
+                maxRestarts: z.ZodOptional<z.ZodNumber>;
+                restartDelay: z.ZodOptional<z.ZodNumber>;
+                template: z.ZodOptional<z.ZodObject<{
+                    shareable: z.ZodOptional<z.ZodBoolean>;
+                    maxInstances: z.ZodOptional<z.ZodNumber>;
+                    idleTimeout: z.ZodOptional<z.ZodNumber>;
+                    perClient: z.ZodOptional<z.ZodBoolean>;
+                    extractionOptions: z.ZodOptional<z.ZodObject<{
+                        includeOptional: z.ZodOptional<z.ZodBoolean>;
+                        includeEnvironment: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            mcpTemplates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodOptional<z.ZodEnum<{
+                    stdio: "stdio";
+                    http: "http";
+                    sse: "sse";
+                    streamableHttp: "streamableHttp";
+                }>>;
+                protocolVersion: z.ZodOptional<z.ZodEnum<{
+                    legacy: "legacy";
+                    auto: "auto";
+                    "2026-07-28": "2026-07-28";
+                }>>;
+                disabled: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+                disabledTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                instructionOverride: z.ZodOptional<z.ZodString>;
+                toolDescriptionOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                connectionTimeout: z.ZodOptional<z.ZodNumber>;
+                requestTimeout: z.ZodOptional<z.ZodNumber>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                oauth: z.ZodOptional<z.ZodObject<{
+                    clientId: z.ZodOptional<z.ZodString>;
+                    clientSecret: z.ZodOptional<z.ZodString>;
+                    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    autoRegister: z.ZodOptional<z.ZodBoolean>;
+                    redirectUrl: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                url: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                command: z.ZodOptional<z.ZodString>;
+                args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                stderr: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                    pipe: "pipe";
+                    overlapped: "overlapped";
+                    ignore: "ignore";
+                    inherit: "inherit";
+                }>, z.ZodNumber]>>;
+                cwd: z.ZodOptional<z.ZodString>;
+                env: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodArray<z.ZodString>]>>;
+                inheritParentEnv: z.ZodOptional<z.ZodBoolean>;
+                envFilter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                restartOnExit: z.ZodOptional<z.ZodBoolean>;
+                maxRestarts: z.ZodOptional<z.ZodNumber>;
+                restartDelay: z.ZodOptional<z.ZodNumber>;
+                template: z.ZodOptional<z.ZodObject<{
+                    shareable: z.ZodOptional<z.ZodBoolean>;
+                    maxInstances: z.ZodOptional<z.ZodNumber>;
+                    idleTimeout: z.ZodOptional<z.ZodNumber>;
+                    perClient: z.ZodOptional<z.ZodBoolean>;
+                    extractionOptions: z.ZodOptional<z.ZodObject<{
+                        includeOptional: z.ZodOptional<z.ZodBoolean>;
+                        includeEnvironment: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            templateSettings: z.ZodOptional<z.ZodObject<{
+                validateOnReload: z.ZodOptional<z.ZodBoolean>;
+                failureMode: z.ZodOptional<z.ZodEnum<{
+                    strict: "strict";
+                    graceful: "graceful";
+                }>>;
+                cacheContext: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            instructionTemplates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                initialization: z.ZodString;
+                cli: z.ZodString;
+            }, z.core.$strip>>>;
+            publishedInstructionTemplates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                initialization: z.ZodString;
+                cli: z.ZodString;
+            }, z.core.$strip>>>;
+            activeInstructionTemplate: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        appConfig: z.ZodObject<{
+            transport: z.ZodOptional<z.ZodEnum<{
+                stdio: "stdio";
+                http: "http";
+                sse: "sse";
+            }>>;
+            port: z.ZodOptional<z.ZodNumber>;
+            host: z.ZodOptional<z.ZodString>;
+            logLevel: z.ZodOptional<z.ZodEnum<{
+                error: "error";
+                debug: "debug";
+                info: "info";
+                warn: "warn";
+            }>>;
+            logFile: z.ZodOptional<z.ZodString>;
+            logging: z.ZodOptional<z.ZodObject<{
+                file: z.ZodOptional<z.ZodString>;
+                level: z.ZodOptional<z.ZodEnum<{
+                    error: "error";
+                    debug: "debug";
+                    info: "info";
+                    warn: "warn";
+                }>>;
+                maxSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+                maxFiles: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            auth: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                sessionTtl: z.ZodOptional<z.ZodNumber>;
+                rateLimitWindow: z.ZodOptional<z.ZodNumber>;
+                rateLimitMax: z.ZodOptional<z.ZodNumber>;
+                trustProxy: z.ZodOptional<z.ZodString>;
+                enableScopeValidation: z.ZodOptional<z.ZodBoolean>;
+                enableEnhancedSecurity: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            asyncLoading: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                minServers: z.ZodOptional<z.ZodNumber>;
+                timeout: z.ZodOptional<z.ZodNumber>;
+                batchNotifications: z.ZodOptional<z.ZodBoolean>;
+                batchDelay: z.ZodOptional<z.ZodNumber>;
+                maxConcurrentLoads: z.ZodOptional<z.ZodNumber>;
+                maxRetries: z.ZodOptional<z.ZodNumber>;
+                retryDelay: z.ZodOptional<z.ZodNumber>;
+                backgroundRetry: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    interval: z.ZodOptional<z.ZodNumber>;
+                    maxServersPerCycle: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            lazyLoading: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                mode: z.ZodOptional<z.ZodEnum<{
+                    full: "full";
+                    metatool: "metatool";
+                    hybrid: "hybrid";
+                }>>;
+                cacheMaxEntries: z.ZodOptional<z.ZodNumber>;
+                inlineCatalog: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            configReload: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                debounce: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            admin: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                rateLimit: z.ZodOptional<z.ZodObject<{
+                    login: z.ZodOptional<z.ZodObject<{
+                        windowSeconds: z.ZodOptional<z.ZodNumber>;
+                        maxRequests: z.ZodOptional<z.ZodNumber>;
+                        maxFailedAttempts: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strict>>;
+                    status: z.ZodOptional<z.ZodObject<{
+                        windowSeconds: z.ZodOptional<z.ZodNumber>;
+                        maxRequests: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strict>>;
+                    sensitive: z.ZodOptional<z.ZodObject<{
+                        windowSeconds: z.ZodOptional<z.ZodNumber>;
+                        maxRequests: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
+                audit: z.ZodOptional<z.ZodObject<{
+                    retentionDays: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            health: z.ZodOptional<z.ZodObject<{
+                rateLimit: z.ZodOptional<z.ZodObject<{
+                    windowSeconds: z.ZodOptional<z.ZodNumber>;
+                    maxRequests: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            templateSettings: z.ZodOptional<z.ZodObject<{
+                pool: z.ZodOptional<z.ZodObject<{
+                    maxInstancesPerTemplate: z.ZodOptional<z.ZodNumber>;
+                    maxTotalInstances: z.ZodOptional<z.ZodNumber>;
+                    idleTimeout: z.ZodOptional<z.ZodNumber>;
+                    cleanupInterval: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            templateContext: z.ZodOptional<z.ZodObject<{
+                trust: z.ZodOptional<z.ZodEnum<{
+                    legacy: "legacy";
+                    verified: "verified";
+                    disabled: "disabled";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        runtimeEnvironment: z.ZodRecord<z.ZodString, z.ZodString>;
+        parentEnvironment: z.ZodRecord<z.ZodString, z.ZodString>;
+        explicitInputs: z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            values: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type RuntimeLaunchBootstrap = z.infer<typeof launchBootstrapSchema>;
+/** The IPC descriptor belongs to the child we spawned, never a PID discovered on disk. */
+export declare function sendChild(child: ChildProcess, message: unknown): void;
+/** Losing a coordinator must not crash a healthy supervisor or worker through an unhandled IPC error. */
+export declare function sendRuntimeParent(message: object): void;
+export declare function receiveRuntimeBootstrap(): Promise<RuntimeLaunchBootstrap>;
+export declare function waitForChildActivation(child: ChildProcess, bootstrap: RuntimeLaunchBootstrap): Promise<unknown>;
+export declare function requestWorker(child: ChildProcess, action: 'close' | 'resume' | 'commit'): Promise<unknown>;
+//# sourceMappingURL=runtimeLaunchIpc.d.ts.map

package/build/core/server/runtimeLaunchIpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeLaunchIpc.d.ts","sourceRoot":"","sources":["../../../src/core/server/runtimeLaunchIpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBASvB,CAAC;AACZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE3E,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAKrE;AAED,yGAAyG;AACzG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAOvD;AAED,wBAAgB,uBAAuB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAwBzE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CA8C/G;AAQD,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB1G"}