From f5417f626c052dfb9372a1173a09c360493f1613 Mon Sep 17 00:00:00 2001
From: Shakker <shakkerdroid@gmail.com>
Date: Mon, 27 Apr 2026 12:20:13 +0100
Subject: [PATCH] refactor: add model list source plan

---
 src/commands/models/list.source-plan.ts | 96 +++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 src/commands/models/list.source-plan.ts

diff --git a/src/commands/models/list.source-plan.ts b/src/commands/models/list.source-plan.ts
new file mode 100644
index 00000000000..d4baac67917
--- /dev/null
+++ b/src/commands/models/list.source-plan.ts
@@ -0,0 +1,96 @@
+import type { OpenClawConfig } from "../../config/types.openclaw.js";
+import type { NormalizedModelCatalogRow } from "../../model-catalog/index.js";
+
+export type ModelListSourcePlanKind =
+  | "registry"
+  | "manifest"
+  | "provider-index"
+  | "provider-runtime-static"
+  | "provider-runtime-scoped";
+
+export type ModelListSourcePlan = {
+  kind: ModelListSourcePlanKind;
+  manifestCatalogRows: readonly NormalizedModelCatalogRow[];
+  providerIndexCatalogRows: readonly NormalizedModelCatalogRow[];
+  requiresInitialRegistry: boolean;
+  skipRuntimeModelSuppression: boolean;
+  fallbackToRegistryWhenEmpty: boolean;
+};
+
+function createSourcePlan(params: {
+  kind: ModelListSourcePlanKind;
+  manifestCatalogRows?: readonly NormalizedModelCatalogRow[];
+  providerIndexCatalogRows?: readonly NormalizedModelCatalogRow[];
+  requiresInitialRegistry?: boolean;
+  skipRuntimeModelSuppression?: boolean;
+  fallbackToRegistryWhenEmpty?: boolean;
+}): ModelListSourcePlan {
+  return {
+    kind: params.kind,
+    manifestCatalogRows: params.manifestCatalogRows ?? [],
+    providerIndexCatalogRows: params.providerIndexCatalogRows ?? [],
+    requiresInitialRegistry: params.requiresInitialRegistry ?? false,
+    skipRuntimeModelSuppression: params.skipRuntimeModelSuppression ?? false,
+    fallbackToRegistryWhenEmpty: params.fallbackToRegistryWhenEmpty ?? false,
+  };
+}
+
+export function createRegistryModelListSourcePlan(): ModelListSourcePlan {
+  return createSourcePlan({
+    kind: "registry",
+    requiresInitialRegistry: true,
+  });
+}
+
+export async function planAllModelListSources(params: {
+  all?: boolean;
+  providerFilter?: string;
+  cfg: OpenClawConfig;
+}): Promise<ModelListSourcePlan> {
+  if (!params.all || !params.providerFilter) {
+    return createRegistryModelListSourcePlan();
+  }
+
+  const { loadStaticManifestCatalogRowsForList } = await import("./list.manifest-catalog.js");
+  const manifestCatalogRows = loadStaticManifestCatalogRowsForList({
+    cfg: params.cfg,
+    providerFilter: params.providerFilter,
+  });
+  if (manifestCatalogRows.length > 0) {
+    return createSourcePlan({
+      kind: "manifest",
+      manifestCatalogRows,
+      skipRuntimeModelSuppression: true,
+    });
+  }
+
+  const { loadProviderIndexCatalogRowsForList } = await import("./list.provider-index-catalog.js");
+  const providerIndexCatalogRows = loadProviderIndexCatalogRowsForList({
+    cfg: params.cfg,
+    providerFilter: params.providerFilter,
+  });
+  if (providerIndexCatalogRows.length > 0) {
+    return createSourcePlan({
+      kind: "provider-index",
+      providerIndexCatalogRows,
+      skipRuntimeModelSuppression: true,
+    });
+  }
+
+  const { hasProviderStaticCatalogForFilter } = await import("./list.provider-catalog.js");
+  const hasProviderStaticCatalog = await hasProviderStaticCatalogForFilter({
+    cfg: params.cfg,
+    providerFilter: params.providerFilter,
+  });
+  if (hasProviderStaticCatalog) {
+    return createSourcePlan({
+      kind: "provider-runtime-static",
+      skipRuntimeModelSuppression: true,
+      fallbackToRegistryWhenEmpty: true,
+    });
+  }
+
+  return createSourcePlan({
+    kind: "provider-runtime-scoped",
+  });
+}