// Gateway plugin bootstrap helpers.

// Applies activation config, installs runtime bindings, loads and pins plugins.

import { primeConfiguredBindingRegistry } from "../channels/plugins/binding-registry.js";

import { applyPluginAutoEnable } from "../config/plugin-auto-enable.js";

import type { OpenClawConfig } from "../config/types.openclaw.js";

// Gateway startup runtime-config resolver.

// Normalizes bind/auth/HTTP/Tailscale/hook settings before server construction.

import type {

GatewayAuthConfig,

GatewayBindMode,

// Gateway mutable runtime handles.

// Provides stop-safe defaults for timers, sidecars, subscriptions, and services.

import type { OpenClawConfig } from "../config/types.openclaw.js";

import type { HeartbeatRunner } from "../infra/heartbeat-runner.js";

import type { ChannelHealthMonitor } from "./channel-health-monitor.js";

/** Creates gateway mutable state with inert handles that are safe to stop before startup finishes. */

export function createGatewayServerMutableState(): GatewayServerMutableState {

const noopInterval = () => {

// Dummy unref'd timers give shutdown code a concrete handle to clear even

// when startup exits before real maintenance intervals are installed.

const timer = setInterval(() => {}, 1 << 30);

timer.unref?.();

return timer;

// Gateway post-ready runtime services.

// Starts delayed maintenance, cron, heartbeat, recovery, and pricing refresh work.

import type { OpenClawConfig } from "../config/types.openclaw.js";

import { isVitestRuntimeEnv } from "../infra/env.js";

import { startHeartbeatRunner, type HeartbeatRunner } from "../infra/heartbeat-runner.js";

if (!maintenance) {

return;

}

// Maintenance startup can race shutdown. Clear every interval handle here so

// callers can discard partially-created maintenance safely.

clearInterval(maintenance.tickInterval);

clearInterval(maintenance.healthInterval);

clearInterval(maintenance.dedupeCleanup);

// Gateway startup-time runtime services.

// Starts mode-dependent background monitors with inert handles for disabled paths.

import type { OpenClawConfig } from "../config/types.openclaw.js";

import type { ChannelHealthMonitor } from "./channel-health-monitor.js";

import { startChannelHealthMonitor } from "./channel-health-monitor.js";

// Gateway HTTP/WebSocket runtime state factory.

// Builds one server runtime with pinned plugin registries and lazy route handlers.

import type { IncomingMessage, Server as HttpServer, ServerResponse } from "node:http";

import type { Duplex } from "node:stream";

import { WebSocketServer } from "ws";

// Gateway early-startup runtime helpers.

// Starts discovery, remote skills, task maintenance, and delayed maintenance setup.

import type { GatewayTailscaleMode } from "../config/types.gateway.js";

import type { OpenClawConfig } from "../config/types.openclaw.js";

import { resolveCronJobsStorePath } from "../cron/store.js";

// Gateway post-attach startup sidecars.

// Schedules warmups, sentinels, update checks, memory backend, and plugin services.

import fs from "node:fs";

import os from "node:os";

import path from "node:path";