@1mcp/agent 0.35.0-beta.1 → 0.35.0-beta.3

package/build/core/protocol/toolRequestHandlers.js

@@ -9,25 +9,21 @@ import logger, { infoIf } from '../../logger/logger.js';
 import { withErrorHandling } from '../../utils/core/errorHandling.js';
 import { buildUri, parseUri } from '../../utils/core/parsing.js';
 import { getRequestTimeout } from '../../utils/core/timeoutUtils.js';
-import { createCapabilityCatalogFromConnections, filterConnectionsForSession, getRequestSession, resolveOutboundConnection, } from './requestHandlerUtils.js';
+import { createCapabilityCatalogFromConnections, filterConnectionsForSession, getRequestSession, resolveLazyCapabilityVisibility, resolveOutboundConnection, } from './requestHandlerUtils.js';
 export function registerToolHandlers(outboundConns, inboundConn, lazyLoadingOrchestrator) {
     const sessionId = getRequestSession(inboundConn);
     const lazyLoadingEnabled = lazyLoadingOrchestrator?.isEnabled();
     const getServerConfigs = () => McpConfigManager.getInstance().getTransportConfig();
     inboundConn.server.setRequestHandler(ListToolsRequestSchema, withErrorHandling(async (request) => {
         if (lazyLoadingEnabled && lazyLoadingOrchestrator) {
-            const sessionFilteredConns = filterConnectionsForSession(outboundConns, sessionId);
-            const capabilityFilteredClients = byCapabilities({ tools: {} })(sessionFilteredConns);
-            const filteredClients = FilteringService.getFilteredConnections(capabilityFilteredClients, inboundConn);
-            const filteredServerNames = new Set(Array.from(filteredClients.values()).map((conn) => conn.name));
+            const visibility = resolveLazyCapabilityVisibility(outboundConns, inboundConn, sessionId);
+            const visibleServerNames = Array.from(new Set(visibility.serverCandidates.values()));
             infoIf(() => ({
                 message: 'Lazy loading: filtered servers',
                 meta: {
                     totalOutbound: outboundConns.size,
-                    sessionFiltered: sessionFilteredConns.size,
-                    capabilityFiltered: capabilityFilteredClients.size,
-                    finalFiltered: filteredClients.size,
-                    filteredServerNames: Array.from(filteredServerNames),
+                    finalFiltered: visibility.serverCandidates.size,
+                    visibleServerNames,
                     inboundConfig: {
                         tagFilterMode: inboundConn.tagFilterMode,
                         tags: inboundConn.tags,
@@ -35,7 +31,7 @@ export function registerToolHandlers(outboundConns, inboundConn, lazyLoadingOrch
                     },
                 },
             }));
-            const capabilities = await lazyLoadingOrchestrator.getCapabilitiesForFilteredServers(filteredServerNames, sessionId);
+            const capabilities = await lazyLoadingOrchestrator.getCapabilitiesForVisibility(visibility);
             const internalProvider = InternalCapabilitiesProvider.getInstance();
             await internalProvider.initialize();
             const internalTools = internalProvider.getAvailableTools();
@@ -53,7 +49,7 @@ export function registerToolHandlers(outboundConns, inboundConn, lazyLoadingOrch
         const capabilityFilteredClients = byCapabilities({ tools: {} })(sessionFilteredConns);
         const filteredClients = FilteringService.getFilteredConnections(capabilityFilteredClients, inboundConn);
         const catalog = await createCapabilityCatalogFromConnections(filteredClients, getServerConfigs);
-        const result = await catalog.listVisibleTools(request.params || {}, sessionId);
+        const result = await catalog.listVisibleTools(request.params || {});
         const internalProvider = InternalCapabilitiesProvider.getInstance();
         await internalProvider.initialize();
         const internalTools = internalProvider.getAvailableTools();
@@ -77,7 +73,8 @@ export function registerToolHandlers(outboundConns, inboundConn, lazyLoadingOrch
         if (isUnprefixedMetaTool && lazyLoadingOrchestrator) {
             let result;
             try {
-                result = await lazyLoadingOrchestrator.callMetaTool(toolName, request.params.arguments, sessionId);
+                const visibility = resolveLazyCapabilityVisibility(outboundConns, inboundConn, sessionId);
+                result = await lazyLoadingOrchestrator.callMetaTool(toolName, request.params.arguments, visibility);
             }
             catch (metaToolError) {
                 logger.error(`Meta-tool ${toolName} execution failed: ${metaToolError}`);
@@ -97,7 +94,10 @@ export function registerToolHandlers(outboundConns, inboundConn, lazyLoadingOrch
         if (clientName === '1mcp') {
             const internalProvider = InternalCapabilitiesProvider.getInstance();
             await internalProvider.initialize();
-            const result = await internalProvider.executeTool(extractedToolName, request.params.arguments, sessionId);
+            const visibility = lazyLoadingEnabled
+                ? resolveLazyCapabilityVisibility(outboundConns, inboundConn, sessionId)
+                : undefined;
+            const result = await internalProvider.executeTool(extractedToolName, request.params.arguments, visibility);
             return structuredToolResult(result);
         }
         const outboundConn = resolveOutboundConnection(clientName, sessionId, outboundConns, inboundConn);

package/build/core/protocol/toolRequestHandlers.js.map

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

package/build/core/runtime/runtimeIdentityService.d.ts

@@ -21,6 +21,7 @@ export declare class RuntimeIdentityService {
     private readonly now;
     constructor(options?: RuntimeIdentityServiceOptions);
     getRuntimeIdentity(input: RuntimeIdentityInput): RuntimeIdentity;
+    getRuntimeScopeId(): string;
     private getOrCreateRuntimeScopeId;
     private readPersistedIdentity;
     private writePersistedIdentity;

package/build/core/runtime/runtimeIdentityService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeIdentityService.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/runtimeIdentityService.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,uBAAuB,EAAE,GAAG,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,UAAU,6BAA6B;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,UAAU,oBAAoB;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAID,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAErB,OAAO,GAAE,6BAAkC;IAMvD,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe;IAgBhE,OAAO,CAAC,yBAAyB;IAWjC,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,mBAAmB;CAG5B"}
+{"version":3,"file":"runtimeIdentityService.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/runtimeIdentityService.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,uBAAuB,EAAE,GAAG,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,UAAU,6BAA6B;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,UAAU,oBAAoB;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAID,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAErB,OAAO,GAAE,6BAAkC;IAMvD,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe;IAgBhE,iBAAiB,IAAI,MAAM;IAI3B,OAAO,CAAC,yBAAyB;IAWjC,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,mBAAmB;CAG5B"}

package/build/core/runtime/runtimeIdentityService.js

@@ -13,7 +13,7 @@ export class RuntimeIdentityService {
         this.now = options.now ?? (() => new Date());
     }
     getRuntimeIdentity(input) {
-        const runtimeScopeId = this.getOrCreateRuntimeScopeId();
+        const runtimeScopeId = this.getRuntimeScopeId();
         const identity = {
             identityProtocolVersion: '1',
             runtimeScopeId,
@@ -25,6 +25,9 @@ export class RuntimeIdentityService {
         }
         return identity;
     }
+    getRuntimeScopeId() {
+        return this.getOrCreateRuntimeScopeId();
+    }
     getOrCreateRuntimeScopeId() {
         const existing = this.readPersistedIdentity();
         if (existing?.runtimeScopeId) {

package/build/core/runtime/runtimeIdentityService.js.map

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

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

@@ -0,0 +1,73 @@
+export type BackendSupervisionState = 'connected' | 'restarting' | 'crash-loop' | 'stopped';
+export interface BackendSupervisionPolicy {
+    restartOnExit: boolean;
+    maxRestarts?: number;
+    restartDelay?: number;
+}
+export interface BackendExitFacts {
+    code: number | null;
+    signal: string | null;
+    pid?: number | null;
+    at?: Date;
+}
+export interface BackendSupervisionSnapshot {
+    backendId: string;
+    state: BackendSupervisionState;
+    attempt: number;
+    limit: number | null;
+    nextRetryAt: Date | null;
+    lastExit: (Required<Omit<BackendExitFacts, 'pid' | 'at'>> & {
+        pid: number | null;
+        at: Date;
+    }) | null;
+    lastError: Error | null;
+    currentPid: number | null;
+}
+export interface BackendRecoveryResult {
+    pid?: number | null;
+    activate?: () => void;
+    dispose?: () => void | Promise<void>;
+}
+export interface BackendStdioSupervisorOptions {
+    backendId: string;
+    policy: BackendSupervisionPolicy;
+    recover: (signal: AbortSignal) => Promise<BackendRecoveryResult>;
+    onStateChange?: (snapshot: BackendSupervisionSnapshot) => void;
+    stablePeriodMs?: number;
+    initialPid?: number | null;
+    now?: () => Date;
+}
+export declare class BackendStdioSupervisor {
+    private readonly backendId;
+    private readonly policy;
+    private readonly recover;
+    private readonly onStateChange?;
+    private readonly stablePeriodMs;
+    private readonly now;
+    private readonly limit;
+    private state;
+    private attempt;
+    private nextRetryAt;
+    private lastExit;
+    private lastError;
+    private currentPid;
+    private retryTimer;
+    private stableTimer;
+    private recoveryController;
+    private activeRecoveries;
+    private generation;
+    constructor(options: BackendStdioSupervisorOptions);
+    snapshot(): BackendSupervisionSnapshot;
+    handleUnexpectedExit(exit: BackendExitFacts): void;
+    restartNow(): Promise<void>;
+    stop(): Promise<void>;
+    private beginNewOperation;
+    private scheduleNextAttempt;
+    private startRecovery;
+    private runRecovery;
+    private scheduleStableReset;
+    private isRecoveryStale;
+    private clearTimer;
+    private publish;
+}
+//# sourceMappingURL=backendStdioSupervisor.d.ts.map

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

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

package/build/core/server/backendStdioSupervisor.js

@@ -0,0 +1,191 @@
+const DEFAULT_MAX_RESTARTS = 5;
+const DEFAULT_RESTART_DELAY_MS = 1_000;
+const DEFAULT_STABLE_PERIOD_MS = 5 * 60 * 1_000;
+export class BackendStdioSupervisor {
+    backendId;
+    policy;
+    recover;
+    onStateChange;
+    stablePeriodMs;
+    now;
+    limit;
+    state = 'connected';
+    attempt = 0;
+    nextRetryAt = null;
+    lastExit = null;
+    lastError = null;
+    currentPid;
+    retryTimer = null;
+    stableTimer = null;
+    recoveryController = null;
+    activeRecoveries = new Set();
+    generation = 0;
+    constructor(options) {
+        this.backendId = options.backendId;
+        this.policy = options.policy;
+        this.recover = options.recover;
+        this.onStateChange = options.onStateChange;
+        this.stablePeriodMs = options.stablePeriodMs ?? DEFAULT_STABLE_PERIOD_MS;
+        this.now = options.now ?? (() => new Date());
+        this.limit = options.policy.maxRestarts === 0 ? null : (options.policy.maxRestarts ?? DEFAULT_MAX_RESTARTS);
+        this.currentPid = options.initialPid ?? null;
+    }
+    snapshot() {
+        return {
+            backendId: this.backendId,
+            state: this.state,
+            attempt: this.attempt,
+            limit: this.limit,
+            nextRetryAt: this.nextRetryAt ? new Date(this.nextRetryAt) : null,
+            lastExit: this.lastExit ? { ...this.lastExit, at: new Date(this.lastExit.at) } : null,
+            lastError: this.lastError,
+            currentPid: this.currentPid,
+        };
+    }
+    handleUnexpectedExit(exit) {
+        if (this.state === 'stopped' || !this.policy.restartOnExit) {
+            return;
+        }
+        const generation = this.beginNewOperation();
+        this.currentPid = null;
+        this.lastExit = {
+            code: exit.code,
+            signal: exit.signal,
+            pid: exit.pid ?? null,
+            at: exit.at ? new Date(exit.at) : this.now(),
+        };
+        this.lastError = null;
+        this.scheduleNextAttempt(generation);
+    }
+    async restartNow() {
+        if (this.state === 'stopped') {
+            throw new Error(`Backend ${this.backendId} is stopped`);
+        }
+        const generation = this.beginNewOperation();
+        this.attempt = 0;
+        this.currentPid = null;
+        this.lastError = null;
+        this.state = 'restarting';
+        this.nextRetryAt = this.now();
+        this.publish();
+        await this.startRecovery(generation, true);
+    }
+    async stop() {
+        this.beginNewOperation();
+        this.state = 'stopped';
+        this.currentPid = null;
+        this.nextRetryAt = null;
+        this.publish();
+        await Promise.allSettled(Array.from(this.activeRecoveries));
+    }
+    beginNewOperation() {
+        this.generation += 1;
+        this.clearTimer('retry');
+        this.clearTimer('stable');
+        this.recoveryController?.abort();
+        this.recoveryController = null;
+        return this.generation;
+    }
+    scheduleNextAttempt(generation) {
+        if (generation !== this.generation || this.state === 'stopped') {
+            return;
+        }
+        const nextAttempt = this.attempt + 1;
+        if (this.limit !== null && nextAttempt > this.limit) {
+            this.state = 'crash-loop';
+            this.nextRetryAt = null;
+            this.publish();
+            return;
+        }
+        this.attempt = nextAttempt;
+        const initialDelay = this.policy.restartDelay ?? DEFAULT_RESTART_DELAY_MS;
+        const delay = initialDelay * 2 ** Math.min(nextAttempt - 1, 4);
+        this.state = 'restarting';
+        this.nextRetryAt = new Date(this.now().getTime() + delay);
+        this.publish();
+        this.retryTimer = setTimeout(() => {
+            this.retryTimer = null;
+            void this.startRecovery(generation, false);
+        }, delay);
+        this.retryTimer.unref?.();
+    }
+    startRecovery(generation, manual) {
+        const recovery = this.runRecovery(generation, manual);
+        this.activeRecoveries.add(recovery);
+        void recovery.then(() => this.activeRecoveries.delete(recovery), () => this.activeRecoveries.delete(recovery));
+        return recovery;
+    }
+    async runRecovery(generation, manual) {
+        if (generation !== this.generation || this.state === 'stopped') {
+            return;
+        }
+        const controller = new AbortController();
+        this.recoveryController = controller;
+        this.nextRetryAt = null;
+        this.publish();
+        try {
+            const result = await this.recover(controller.signal);
+            if (this.isRecoveryStale(generation, controller)) {
+                await result.dispose?.();
+                return;
+            }
+            result.activate?.();
+            if (this.isRecoveryStale(generation, controller)) {
+                await result.dispose?.();
+                return;
+            }
+            this.recoveryController = null;
+            this.state = 'connected';
+            this.currentPid = result.pid ?? null;
+            this.lastError = null;
+            if (manual) {
+                this.attempt = 0;
+            }
+            this.publish();
+            this.scheduleStableReset(generation);
+        }
+        catch (error) {
+            if (this.isRecoveryStale(generation, controller)) {
+                return;
+            }
+            this.recoveryController = null;
+            const recoveryError = error instanceof Error ? error : new Error(String(error));
+            this.lastError = recoveryError;
+            this.scheduleNextAttempt(generation);
+            if (manual) {
+                throw recoveryError;
+            }
+        }
+    }
+    scheduleStableReset(generation) {
+        this.clearTimer('stable');
+        this.stableTimer = setTimeout(() => {
+            this.stableTimer = null;
+            if (generation !== this.generation || this.state !== 'connected') {
+                return;
+            }
+            this.attempt = 0;
+            this.publish();
+        }, this.stablePeriodMs);
+        this.stableTimer.unref?.();
+    }
+    isRecoveryStale(generation, controller) {
+        return generation !== this.generation || controller.signal.aborted || this.state === 'stopped';
+    }
+    clearTimer(kind) {
+        const timer = kind === 'retry' ? this.retryTimer : this.stableTimer;
+        if (timer) {
+            clearTimeout(timer);
+            if (kind === 'retry') {
+                this.retryTimer = null;
+            }
+            else {
+                this.stableTimer = null;
+            }
+        }
+    }
+    publish() {
+        this.onStateChange?.(this.snapshot());
+    }
+}
+//# sourceMappingURL=backendStdioSupervisor.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { type ApplicationConfig } from '../../core/types/transport.js';
+export interface BackgroundLaunchConfig {
+    version: 1;
+    claimId: string;
+    appConfig: ApplicationConfig;
+}
+export declare const BACKGROUND_LAUNCH_CONFIG_FILE = "background-launch.json";
+export declare function getBackgroundLaunchConfigPath(configDir: string): string;
+export declare function backgroundLaunchConfigExists(configDir: string): boolean;
+export declare function writeBackgroundLaunchConfig(configDir: string, claimId: string, appConfig: ApplicationConfig): string;
+export declare function readBackgroundLaunchConfig(filePath: string): BackgroundLaunchConfig;
+export declare function cleanupBackgroundLaunchConfig(configDir: string, expectedClaimId: string, options?: {
+    removeStaleGeneration?: boolean;
+}): boolean;
+//# sourceMappingURL=backgroundLaunchConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundLaunchConfig.d.ts","sourceRoot":"","sources":["../../../src/core/server/backgroundLaunchConfig.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,iBAAiB,EAA2B,MAAM,8BAA8B,CAAC;AAI/F,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AAQtE,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAOpH;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAEnF;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EAGvB,OAAO,GAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GAChD,OAAO,CAWT"}

package/build/core/server/backgroundLaunchConfig.js

@@ -0,0 +1,46 @@
+import fs from 'fs';
+import path from 'path';
+import { applicationConfigSchema } from '../../core/types/transport.js';
+import { z } from 'zod';
+export const BACKGROUND_LAUNCH_CONFIG_FILE = 'background-launch.json';
+const backgroundLaunchConfigSchema = z.object({
+    version: z.literal(1),
+    claimId: z.string().min(1),
+    appConfig: applicationConfigSchema,
+});
+export function getBackgroundLaunchConfigPath(configDir) {
+    return path.join(configDir, BACKGROUND_LAUNCH_CONFIG_FILE);
+}
+export function backgroundLaunchConfigExists(configDir) {
+    return fs.existsSync(getBackgroundLaunchConfigPath(configDir));
+}
+export function writeBackgroundLaunchConfig(configDir, claimId, appConfig) {
+    const filePath = getBackgroundLaunchConfigPath(configDir);
+    const value = backgroundLaunchConfigSchema.parse({ version: 1, claimId, appConfig });
+    const temporaryPath = `${filePath}.${process.pid}.tmp`;
+    fs.writeFileSync(temporaryPath, `${JSON.stringify(value)}\n`, { mode: 0o600 });
+    fs.renameSync(temporaryPath, filePath);
+    return filePath;
+}
+export function readBackgroundLaunchConfig(filePath) {
+    return backgroundLaunchConfigSchema.parse(JSON.parse(fs.readFileSync(filePath, 'utf8')));
+}
+export function cleanupBackgroundLaunchConfig(configDir, expectedClaimId, 
+// Stale-generation removal is safe only while the caller has verified and
+// retained the Runtime Scope's exclusive owner.
+options = {}) {
+    const filePath = getBackgroundLaunchConfigPath(configDir);
+    try {
+        const current = readBackgroundLaunchConfig(filePath);
+        if (current.claimId !== expectedClaimId && !options.removeStaleGeneration)
+            return false;
+        fs.unlinkSync(filePath);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return true;
+        throw error;
+    }
+}
+//# sourceMappingURL=backgroundLaunchConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundLaunchConfig.js","sourceRoot":"","sources":["../../../src/core/server/backgroundLaunchConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAA0B,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE/F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,MAAM,CAAC,MAAM,6BAA6B,GAAG,wBAAwB,CAAC;AAEtE,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,uBAAuB;CACnC,CAA6C,CAAC;AAE/C,MAAM,UAAU,6BAA6B,CAAC,SAAiB;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,SAAiB;IAC5D,OAAO,EAAE,CAAC,UAAU,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,SAAiB,EAAE,OAAe,EAAE,SAA4B;IAC1G,MAAM,QAAQ,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,4BAA4B,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IACrF,MAAM,aAAa,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IACvD,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,OAAO,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,SAAiB,EACjB,eAAuB;AACvB,0EAA0E;AAC1E,gDAAgD;AAChD,UAA+C,EAAE;IAEjD,MAAM,QAAQ,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,OAAO,KAAK,eAAe,IAAI,CAAC,OAAO,CAAC,qBAAqB;YAAE,OAAO,KAAK,CAAC;QACxF,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,44 @@
+import { type SpawnOptions } from 'child_process';
+import { type BackgroundRuntimeExit, type BackgroundRuntimeSignal, type BackgroundSupervisorState } from '../../core/server/backgroundRuntimeSupervisorState.js';
+export * from '../../core/server/backgroundRuntimeSupervisorState.js';
+export declare const BACKGROUND_RESTART_DELAYS_MS: readonly [1000, 2000, 4000, 8000, 16000];
+export declare const BACKGROUND_STABLE_RESET_MS: number;
+export interface SupervisedRuntimeWorker {
+    readonly pid?: number;
+    on(event: 'error', listener: (error: Error) => void): this | void;
+    once(event: 'close', listener: (code: number | null, signal: BackgroundRuntimeSignal | null) => void): this | void;
+    kill(signal?: BackgroundRuntimeSignal): unknown;
+}
+export interface BackgroundSupervisorEvent {
+    at: string;
+    event: 'runtime-spawned' | 'runtime-ready' | 'runtime-unreachable' | 'runtime-exit' | 'restart-scheduled' | 'restart-counter-reset' | 'runtime-recovered' | 'retry-exhausted' | 'supervisor-stopping';
+    supervisorPid: number;
+    runtimePid?: number;
+    restartAttempt?: number;
+    delayMs?: number;
+    exit?: BackgroundRuntimeExit;
+}
+export interface BackgroundSupervisorOptions {
+    configDir: string;
+    workerCommand: string;
+    /** Immutable effective invocation reused verbatim for every replacement. */
+    workerArgs: readonly string[];
+    supervisorPid?: number;
+}
+export interface BackgroundSupervisorDependencies {
+    spawnWorker?: (command: string, args: readonly string[], options: SpawnOptions) => SupervisedRuntimeWorker;
+    waitForReady: (worker: SupervisedRuntimeWorker) => Promise<boolean>;
+    writeState?: (state: BackgroundSupervisorState) => void;
+    appendEvent?: (event: BackgroundSupervisorEvent) => void;
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+    waitBeforeReadinessRetry?: (ms: number, signal?: AbortSignal) => Promise<void>;
+    now?: () => Date;
+    waitForStop?: () => Promise<void>;
+}
+/**
+ * Run one persistent Background Runtime Supervisor until deliberate stop.
+ * The worker is never restarted because of readiness alone; only an observed
+ * process exit consumes an attempt.
+ */
+export declare function runBackgroundRuntimeSupervisor(options: BackgroundSupervisorOptions, dependencies: BackgroundSupervisorDependencies): Promise<void>;
+//# sourceMappingURL=backgroundRuntimeSupervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundRuntimeSupervisor.d.ts","sourceRoot":"","sources":["../../../src/core/server/backgroundRuntimeSupervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAE/B,MAAM,sDAAsD,CAAC;AAE9D,cAAc,sDAAsD,CAAC;AAErE,eAAO,MAAM,4BAA4B,0CAAgD,CAAC;AAC1F,eAAO,MAAM,0BAA0B,QAAiB,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,uBAAuB,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACnH,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC;CACjD;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EACD,iBAAiB,GACjB,eAAe,GACf,qBAAqB,GACrB,cAAc,GACd,mBAAmB,GACnB,uBAAuB,GACvB,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gCAAgC;IAC/C,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,KAAK,uBAAuB,CAAC;IAC3G,YAAY,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACxD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACzD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,wBAAwB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAmED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,2BAA2B,EACpC,YAAY,EAAE,gCAAgC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAyMf"}