openclaw/src/plugins/runtime-channel-state.ts

import type { ActivePluginChannelRegistry } from "./channel-registry-state.types.js";

export const PLUGIN_REGISTRY_STATE = Symbol.for("openclaw.pluginRegistryState");

type GlobalChannelRegistryState = typeof globalThis & {
  [PLUGIN_REGISTRY_STATE]?: {
    activeVersion?: number;
    activeRegistry?: ActivePluginChannelRegistry | null;
    channel?: {
      registry: ActivePluginChannelRegistry | null;
      version?: number;
    };
  };
};

function countChannels(registry: ActivePluginChannelRegistry | null | undefined): number {
  return registry?.channels?.length ?? 0;
}

export function getActivePluginChannelRegistryFromState(): ActivePluginChannelRegistry | null {
  const state = (globalThis as GlobalChannelRegistryState)[PLUGIN_REGISTRY_STATE];
  const pinnedRegistry = state?.channel?.registry ?? null;
  if (countChannels(pinnedRegistry) > 0) {
    return pinnedRegistry;
  }
  const activeRegistry = state?.activeRegistry ?? null;
  if (countChannels(activeRegistry) > 0) {
    return activeRegistry;
  }
  return pinnedRegistry ?? activeRegistry;
}

export function getActivePluginChannelRegistryVersionFromState(): number {
  const state = (globalThis as GlobalChannelRegistryState)[PLUGIN_REGISTRY_STATE];
  return state?.channel?.registry ? (state.channel.version ?? 0) : (state?.activeVersion ?? 0);
}