fix(plugin-sdk): isolate provider entry surfaces

src/plugin-sdk/plugin-entry.ts

@@ -0,0 +1,94 @@
+import { emptyPluginConfigSchema } from "../plugins/config-schema.js";
+import type {
+  OpenClawPluginApi,
+  OpenClawPluginCommandDefinition,
+  OpenClawPluginConfigSchema,
+  OpenClawPluginDefinition,
+  PluginInteractiveTelegramHandlerContext,
+} from "../plugins/types.js";
+
+export type {
+  AnyAgentTool,
+  MediaUnderstandingProviderPlugin,
+  OpenClawPluginApi,
+  OpenClawPluginConfigSchema,
+  ProviderDiscoveryContext,
+  ProviderCatalogContext,
+  ProviderCatalogResult,
+  ProviderAugmentModelCatalogContext,
+  ProviderBuiltInModelSuppressionContext,
+  ProviderBuiltInModelSuppressionResult,
+  ProviderBuildMissingAuthMessageContext,
+  ProviderCacheTtlEligibilityContext,
+  ProviderDefaultThinkingPolicyContext,
+  ProviderFetchUsageSnapshotContext,
+  ProviderModernModelPolicyContext,
+  ProviderPreparedRuntimeAuth,
+  ProviderResolvedUsageAuth,
+  ProviderPrepareExtraParamsContext,
+  ProviderPrepareDynamicModelContext,
+  ProviderPrepareRuntimeAuthContext,
+  ProviderResolveUsageAuthContext,
+  ProviderResolveDynamicModelContext,
+  ProviderNormalizeResolvedModelContext,
+  ProviderRuntimeModel,
+  SpeechProviderPlugin,
+  ProviderThinkingPolicyContext,
+  ProviderWrapStreamFnContext,
+  OpenClawPluginService,
+  OpenClawPluginServiceContext,
+  ProviderAuthContext,
+  ProviderAuthDoctorHintContext,
+  ProviderAuthMethodNonInteractiveContext,
+  ProviderAuthMethod,
+  ProviderAuthResult,
+  OpenClawPluginCommandDefinition,
+  OpenClawPluginDefinition,
+  PluginLogger,
+  PluginInteractiveTelegramHandlerContext,
+} from "../plugins/types.js";
+export type { OpenClawConfig } from "../config/config.js";
+
+export { emptyPluginConfigSchema } from "../plugins/config-schema.js";
+
+type DefinePluginEntryOptions = {
+  id: string;
+  name: string;
+  description: string;
+  kind?: OpenClawPluginDefinition["kind"];
+  configSchema?: OpenClawPluginConfigSchema | (() => OpenClawPluginConfigSchema);
+  register: (api: OpenClawPluginApi) => void;
+};
+
+type DefinedPluginEntry = {
+  id: string;
+  name: string;
+  description: string;
+  configSchema: OpenClawPluginConfigSchema;
+  register: NonNullable<OpenClawPluginDefinition["register"]>;
+} & Pick<OpenClawPluginDefinition, "kind">;
+
+function resolvePluginConfigSchema(
+  configSchema: DefinePluginEntryOptions["configSchema"] = emptyPluginConfigSchema,
+): OpenClawPluginConfigSchema {
+  return typeof configSchema === "function" ? configSchema() : configSchema;
+}
+
+// Small entry surface for provider and command plugins that do not need channel helpers.
+export function definePluginEntry({
+  id,
+  name,
+  description,
+  kind,
+  configSchema = emptyPluginConfigSchema,
+  register,
+}: DefinePluginEntryOptions): DefinedPluginEntry {
+  return {
+    id,
+    name,
+    description,
+    ...(kind ? { kind } : {}),
+    configSchema: resolvePluginConfigSchema(configSchema),
+    register,
+  };
+}