refactor: share sdk lazy config and cli test helpers

src/plugin-sdk/lazy-value.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, it, vi } from "vitest";
+import { createCachedLazyValueGetter } from "./lazy-value.js";
+
+describe("createCachedLazyValueGetter", () => {
+  it("memoizes lazy factories", () => {
+    const resolveSchema = vi.fn(() => ({ type: "object" as const }));
+    const getSchema = createCachedLazyValueGetter(resolveSchema);
+
+    expect(getSchema()).toEqual({ type: "object" });
+    expect(getSchema()).toEqual({ type: "object" });
+    expect(resolveSchema).toHaveBeenCalledTimes(1);
+  });
+
+  it("uses the fallback when the lazy value resolves nullish", () => {
+    const fallback = { type: "object" as const, properties: {} };
+    const getSchema = createCachedLazyValueGetter<typeof fallback>(() => undefined, fallback);
+
+    expect(getSchema()).toBe(fallback);
+  });
+});

src/plugin-sdk/lazy-value.ts

@@ -0,0 +1,24 @@
+type LazyValue<T> = T | (() => T);
+
+export function createCachedLazyValueGetter<T>(value: LazyValue<T>): () => T;
+export function createCachedLazyValueGetter<T>(
+  value: LazyValue<T | null | undefined>,
+  fallback: T,
+): () => T;
+export function createCachedLazyValueGetter<T>(
+  value: LazyValue<T | null | undefined>,
+  fallback?: T,
+): () => T | undefined {
+  let resolved = false;
+  let cached: T | undefined;
+
+  return () => {
+    if (!resolved) {
+      const nextValue =
+        typeof value === "function" ? (value as () => T | null | undefined)() : value;
+      cached = nextValue ?? fallback;
+      resolved = true;
+    }
+    return cached;
+  };
+}

src/plugin-sdk/plugin-entry.ts

@@ -65,6 +65,7 @@ import type {
   SpeechProviderPlugin,
   PluginCommandContext,
 } from "../plugins/types.js";
+import { createCachedLazyValueGetter } from "./lazy-value.js";
 
 export type {
   AnyAgentTool,
@@ -154,13 +155,6 @@ type DefinedPluginEntry = {
   register: NonNullable<OpenClawPluginDefinition["register"]>;
 } & Pick<OpenClawPluginDefinition, "kind">;
 
-/** Resolve either a concrete config schema or a lazy schema factory. */
-function resolvePluginConfigSchema(
-  configSchema: DefinePluginEntryOptions["configSchema"] = emptyPluginConfigSchema,
-): OpenClawPluginConfigSchema {
-  return typeof configSchema === "function" ? configSchema() : configSchema;
-}
-
 /**
  * Canonical entry helper for non-channel plugins.
  *
@@ -176,11 +170,7 @@ export function definePluginEntry({
   configSchema = emptyPluginConfigSchema,
   register,
 }: DefinePluginEntryOptions): DefinedPluginEntry {
-  let resolvedConfigSchema: OpenClawPluginConfigSchema | undefined;
-  const getConfigSchema = (): OpenClawPluginConfigSchema => {
-    resolvedConfigSchema ??= resolvePluginConfigSchema(configSchema);
-    return resolvedConfigSchema;
-  };
+  const getConfigSchema = createCachedLazyValueGetter(configSchema);
   return {
     id,
     name,