@openclaw/discord 2026.3.13 → 2026.5.1-beta.1

package/src/monitor/message-utils.ts

@@ -0,0 +1,32 @@
+export {
+  __resetDiscordChannelInfoCacheForTest,
+  resolveDiscordChannelInfo,
+  resolveDiscordMessageChannelId,
+  type DiscordChannelInfo,
+  type DiscordChannelInfoClient,
+} from "./message-channel-info.js";
+export {
+  hasDiscordMessageStickers,
+  normalizeDiscordMessageSnapshots,
+  normalizeDiscordStickerItems,
+  resolveDiscordMessageSnapshots,
+  resolveDiscordMessageStickers,
+  resolveDiscordReferencedForwardMessage,
+  resolveDiscordSnapshotStickers,
+  type DiscordMessageSnapshot,
+  type DiscordSnapshotAuthor,
+  type DiscordSnapshotMessage,
+} from "./message-forwarded.js";
+export {
+  buildDiscordMediaPayload,
+  buildDiscordMediaPlaceholder,
+  resolveForwardedMediaList,
+  resolveMediaList,
+  type DiscordMediaInfo,
+  type DiscordMediaResolveOptions,
+} from "./message-media.js";
+export {
+  resolveDiscordEmbedText,
+  resolveDiscordForwardedMessagesTextFromSnapshots,
+  resolveDiscordMessageText,
+} from "./message-text.js";

package/src/monitor/model-picker-preferences.test.ts

@@ -0,0 +1,67 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import {
+  readDiscordModelPickerRecentModels,
+  recordDiscordModelPickerRecentModel,
+} from "./model-picker-preferences.js";
+
+const tempDirs: string[] = [];
+
+async function createStateEnv(): Promise<NodeJS.ProcessEnv> {
+  const dir = await fs.mkdtemp(path.join(os.tmpdir(), "openclaw-model-picker-"));
+  tempDirs.push(dir);
+  return { ...process.env, OPENCLAW_STATE_DIR: dir };
+}
+
+afterEach(async () => {
+  await Promise.all(
+    tempDirs.splice(0).map(async (dir) => {
+      await fs.rm(dir, { recursive: true, force: true });
+    }),
+  );
+});
+
+describe("discord model picker preferences", () => {
+  it("records recent models in recency order without duplicates", async () => {
+    const env = await createStateEnv();
+    const scope = { userId: "123" };
+
+    await recordDiscordModelPickerRecentModel({ env, scope, modelRef: "openai/gpt-4o" });
+    await recordDiscordModelPickerRecentModel({ env, scope, modelRef: "openai/gpt-4.1" });
+    await recordDiscordModelPickerRecentModel({ env, scope, modelRef: "openai/gpt-4o" });
+
+    const recent = await readDiscordModelPickerRecentModels({ env, scope });
+    expect(recent).toEqual(["openai/gpt-4o", "openai/gpt-4.1"]);
+  });
+
+  it("filters recent models using an allowlist", async () => {
+    const env = await createStateEnv();
+    const scope = { userId: "456" };
+
+    await recordDiscordModelPickerRecentModel({ env, scope, modelRef: "openai/gpt-4o" });
+    await recordDiscordModelPickerRecentModel({ env, scope, modelRef: "openai/gpt-4.1" });
+
+    const recent = await readDiscordModelPickerRecentModels({
+      env,
+      scope,
+      allowedModelRefs: new Set(["openai/gpt-4.1"]),
+    });
+    expect(recent).toEqual(["openai/gpt-4.1"]);
+  });
+
+  it("falls back to an empty store when the file is corrupt", async () => {
+    const env = await createStateEnv();
+    const stateDir = env.OPENCLAW_STATE_DIR as string;
+    const filePath = path.join(stateDir, "discord", "model-picker-preferences.json");
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, "{not-json", "utf-8");
+
+    const recent = await readDiscordModelPickerRecentModels({
+      env,
+      scope: { userId: "789" },
+    });
+    expect(recent).toEqual([]);
+  });
+});

package/src/monitor/model-picker-preferences.ts

@@ -0,0 +1,184 @@
+import os from "node:os";
+import path from "node:path";
+import { normalizeAccountId as normalizeSharedAccountId } from "openclaw/plugin-sdk/account-id";
+import { withFileLock } from "openclaw/plugin-sdk/file-lock";
+import { readJsonFileWithFallback, writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
+import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared";
+import { resolveStateDir } from "openclaw/plugin-sdk/state-paths";
+import { normalizeOptionalString } from "openclaw/plugin-sdk/text-runtime";
+
+const MODEL_PICKER_PREFERENCES_LOCK_OPTIONS = {
+  retries: {
+    retries: 8,
+    factor: 2,
+    minTimeout: 50,
+    maxTimeout: 5_000,
+    randomize: true,
+  },
+  stale: 15_000,
+} as const;
+
+const DEFAULT_RECENT_LIMIT = 5;
+
+type ModelPickerPreferencesEntry = {
+  recent: string[];
+  updatedAt: string;
+};
+
+type ModelPickerPreferencesStore = {
+  version: 1;
+  entries: Record<string, ModelPickerPreferencesEntry>;
+};
+
+function sanitizePreferenceEntries(entries: unknown): Record<string, ModelPickerPreferencesEntry> {
+  if (!entries || typeof entries !== "object") {
+    return {};
+  }
+  const normalizedEntries: Record<string, ModelPickerPreferencesEntry> = {};
+  for (const [key, value] of Object.entries(entries)) {
+    if (!value || typeof value !== "object") {
+      continue;
+    }
+    const typedValue = value as {
+      recent?: unknown;
+      updatedAt?: unknown;
+    };
+    const recent = Array.isArray(typedValue.recent)
+      ? typedValue.recent.filter((item: unknown): item is string => typeof item === "string")
+      : [];
+    const updatedAt = typeof typedValue.updatedAt === "string" ? typedValue.updatedAt : "";
+    normalizedEntries[key] = { recent, updatedAt };
+  }
+  return normalizedEntries;
+}
+
+export type DiscordModelPickerPreferenceScope = {
+  accountId?: string;
+  guildId?: string;
+  userId: string;
+};
+
+function resolvePreferencesStorePath(env: NodeJS.ProcessEnv = process.env): string {
+  const stateDir = resolveStateDir(env, os.homedir);
+  return path.join(stateDir, "discord", "model-picker-preferences.json");
+}
+
+function normalizeId(value?: string): string {
+  return normalizeOptionalString(value) ?? "";
+}
+
+export function buildDiscordModelPickerPreferenceKey(
+  scope: DiscordModelPickerPreferenceScope,
+): string | null {
+  const userId = normalizeId(scope.userId);
+  if (!userId) {
+    return null;
+  }
+  const accountId = normalizeSharedAccountId(scope.accountId);
+  const guildId = normalizeId(scope.guildId);
+  if (guildId) {
+    return `discord:${accountId}:guild:${guildId}:user:${userId}`;
+  }
+  return `discord:${accountId}:dm:user:${userId}`;
+}
+
+function normalizeModelRef(raw?: string): string | null {
+  const value = raw?.trim();
+  if (!value) {
+    return null;
+  }
+  const slashIndex = value.indexOf("/");
+  if (slashIndex <= 0 || slashIndex >= value.length - 1) {
+    return null;
+  }
+  const provider = normalizeProviderId(value.slice(0, slashIndex));
+  const model = value.slice(slashIndex + 1).trim();
+  if (!provider || !model) {
+    return null;
+  }
+  return `${provider}/${model}`;
+}
+
+function sanitizeRecentModels(models: string[] | undefined, limit: number): string[] {
+  const deduped: string[] = [];
+  const seen = new Set<string>();
+  for (const item of models ?? []) {
+    const normalized = normalizeModelRef(item);
+    if (!normalized || seen.has(normalized)) {
+      continue;
+    }
+    seen.add(normalized);
+    deduped.push(normalized);
+    if (deduped.length >= limit) {
+      break;
+    }
+  }
+  return deduped;
+}
+
+async function readPreferencesStore(filePath: string): Promise<ModelPickerPreferencesStore> {
+  const { value } = await readJsonFileWithFallback(filePath, {
+    version: 1,
+    entries: {} as Record<string, ModelPickerPreferencesEntry>,
+  });
+  if (!value || typeof value !== "object" || value.version !== 1) {
+    return { version: 1, entries: {} };
+  }
+  return {
+    version: 1,
+    entries: sanitizePreferenceEntries(value.entries),
+  };
+}
+
+export async function readDiscordModelPickerRecentModels(params: {
+  scope: DiscordModelPickerPreferenceScope;
+  limit?: number;
+  allowedModelRefs?: Set<string>;
+  env?: NodeJS.ProcessEnv;
+}): Promise<string[]> {
+  const key = buildDiscordModelPickerPreferenceKey(params.scope);
+  if (!key) {
+    return [];
+  }
+  const limit = Math.max(1, Math.min(params.limit ?? DEFAULT_RECENT_LIMIT, 10));
+  const filePath = resolvePreferencesStorePath(params.env);
+  const store = await readPreferencesStore(filePath);
+  const entry = store.entries[key];
+  const recent = sanitizeRecentModels(entry?.recent, limit);
+  if (!params.allowedModelRefs || params.allowedModelRefs.size === 0) {
+    return recent;
+  }
+  return recent.filter((modelRef) => params.allowedModelRefs?.has(modelRef));
+}
+
+export async function recordDiscordModelPickerRecentModel(params: {
+  scope: DiscordModelPickerPreferenceScope;
+  modelRef: string;
+  limit?: number;
+  env?: NodeJS.ProcessEnv;
+}): Promise<void> {
+  const key = buildDiscordModelPickerPreferenceKey(params.scope);
+  const normalizedModelRef = normalizeModelRef(params.modelRef);
+  if (!key || !normalizedModelRef) {
+    return;
+  }
+
+  const limit = Math.max(1, Math.min(params.limit ?? DEFAULT_RECENT_LIMIT, 10));
+  const filePath = resolvePreferencesStorePath(params.env);
+
+  await withFileLock(filePath, MODEL_PICKER_PREFERENCES_LOCK_OPTIONS, async () => {
+    const store = await readPreferencesStore(filePath);
+    const existing = sanitizeRecentModels(store.entries[key]?.recent, limit);
+    const next = [
+      normalizedModelRef,
+      ...existing.filter((entry) => entry !== normalizedModelRef),
+    ].slice(0, limit);
+
+    store.entries[key] = {
+      recent: next,
+      updatedAt: new Date().toISOString(),
+    };
+
+    await writeJsonFileAtomically(filePath, store);
+  });
+}

package/src/monitor/model-picker.state.ts

@@ -0,0 +1,364 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";
+import type { ModelsProviderData } from "openclaw/plugin-sdk/models-provider-runtime";
+import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared";
+import type { ComponentData } from "../internal/discord.js";
+
+export const DISCORD_MODEL_PICKER_CUSTOM_ID_KEY = "mdlpk";
+export const DISCORD_CUSTOM_ID_MAX_CHARS = 100;
+
+export const DISCORD_COMPONENT_MAX_ROWS = 5;
+export const DISCORD_COMPONENT_MAX_BUTTONS_PER_ROW = 5;
+export const DISCORD_COMPONENT_MAX_SELECT_OPTIONS = 25;
+
+export const DISCORD_MODEL_PICKER_PROVIDER_PAGE_SIZE =
+  DISCORD_COMPONENT_MAX_BUTTONS_PER_ROW * (DISCORD_COMPONENT_MAX_ROWS - 1);
+export const DISCORD_MODEL_PICKER_PROVIDER_SINGLE_PAGE_MAX =
+  DISCORD_COMPONENT_MAX_BUTTONS_PER_ROW * DISCORD_COMPONENT_MAX_ROWS;
+export const DISCORD_MODEL_PICKER_MODEL_PAGE_SIZE = DISCORD_COMPONENT_MAX_SELECT_OPTIONS;
+
+const COMMAND_CONTEXTS = ["model", "models"] as const;
+const PICKER_ACTIONS = [
+  "open",
+  "provider",
+  "model",
+  "runtime",
+  "submit",
+  "quick",
+  "back",
+  "reset",
+  "cancel",
+  "recents",
+] as const;
+const PICKER_VIEWS = ["providers", "models", "recents"] as const;
+
+export type DiscordModelPickerCommandContext = (typeof COMMAND_CONTEXTS)[number];
+export type DiscordModelPickerAction = (typeof PICKER_ACTIONS)[number];
+export type DiscordModelPickerView = (typeof PICKER_VIEWS)[number];
+export type DiscordModelPickerLayout = "v2" | "classic";
+
+export type DiscordModelPickerState = {
+  command: DiscordModelPickerCommandContext;
+  action: DiscordModelPickerAction;
+  view: DiscordModelPickerView;
+  userId: string;
+  provider?: string;
+  runtime?: string;
+  page: number;
+  providerPage?: number;
+  modelIndex?: number;
+  recentSlot?: number;
+};
+
+export type DiscordModelPickerProviderItem = {
+  id: string;
+  count: number;
+};
+
+export type DiscordModelPickerPage<T> = {
+  items: T[];
+  page: number;
+  pageSize: number;
+  totalPages: number;
+  totalItems: number;
+  hasPrev: boolean;
+  hasNext: boolean;
+};
+
+export type DiscordModelPickerModelPage = DiscordModelPickerPage<string> & {
+  provider: string;
+};
+
+let modelsProviderRuntimePromise:
+  | Promise<typeof import("openclaw/plugin-sdk/models-provider-runtime")>
+  | undefined;
+
+async function loadModelsProviderRuntime() {
+  modelsProviderRuntimePromise ??= import("openclaw/plugin-sdk/models-provider-runtime");
+  return await modelsProviderRuntimePromise;
+}
+
+function encodeCustomIdValue(value: string): string {
+  return encodeURIComponent(value);
+}
+
+function decodeCustomIdValue(value: string): string {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+
+function isValidCommandContext(value: string): value is DiscordModelPickerCommandContext {
+  return (COMMAND_CONTEXTS as readonly string[]).includes(value);
+}
+
+function isValidPickerAction(value: string): value is DiscordModelPickerAction {
+  return (PICKER_ACTIONS as readonly string[]).includes(value);
+}
+
+function isValidPickerView(value: string): value is DiscordModelPickerView {
+  return (PICKER_VIEWS as readonly string[]).includes(value);
+}
+
+export function normalizeModelPickerPage(value: number | undefined): number {
+  const numeric = typeof value === "number" ? value : Number.NaN;
+  if (!Number.isFinite(numeric)) {
+    return 1;
+  }
+  return Math.max(1, Math.floor(numeric));
+}
+
+function parseRawPage(value: unknown): number {
+  if (typeof value === "number") {
+    return normalizeModelPickerPage(value);
+  }
+  if (typeof value === "string" && value.trim()) {
+    const parsed = Number.parseInt(value, 10);
+    if (Number.isFinite(parsed)) {
+      return normalizeModelPickerPage(parsed);
+    }
+  }
+  return 1;
+}
+
+function parseRawPositiveInt(value: unknown): number | undefined {
+  if (typeof value !== "string" && typeof value !== "number") {
+    return undefined;
+  }
+  const parsed = Number.parseInt(String(value), 10);
+  if (!Number.isFinite(parsed) || parsed < 1) {
+    return undefined;
+  }
+  return Math.floor(parsed);
+}
+
+function coerceString(value: unknown): string {
+  return typeof value === "string" || typeof value === "number" ? String(value) : "";
+}
+
+function clampPageSize(rawPageSize: number | undefined, max: number, fallback: number): number {
+  if (!Number.isFinite(rawPageSize)) {
+    return fallback;
+  }
+  return Math.min(max, Math.max(1, Math.floor(rawPageSize ?? fallback)));
+}
+
+function paginateItems<T>(params: {
+  items: T[];
+  page: number;
+  pageSize: number;
+}): DiscordModelPickerPage<T> {
+  const totalItems = params.items.length;
+  const totalPages = Math.max(1, Math.ceil(totalItems / params.pageSize));
+  const page = Math.max(1, Math.min(params.page, totalPages));
+  const startIndex = (page - 1) * params.pageSize;
+  const endIndexExclusive = Math.min(totalItems, startIndex + params.pageSize);
+
+  return {
+    items: params.items.slice(startIndex, endIndexExclusive),
+    page,
+    pageSize: params.pageSize,
+    totalPages,
+    totalItems,
+    hasPrev: page > 1,
+    hasNext: page < totalPages,
+  };
+}
+
+export async function loadDiscordModelPickerData(
+  cfg: OpenClawConfig,
+  agentId?: string,
+): Promise<ModelsProviderData> {
+  const { buildModelsProviderData } = await loadModelsProviderRuntime();
+  return buildModelsProviderData(cfg, agentId);
+}
+
+export function buildDiscordModelPickerCustomId(params: {
+  command: DiscordModelPickerCommandContext;
+  action: DiscordModelPickerAction;
+  view: DiscordModelPickerView;
+  userId: string;
+  provider?: string;
+  runtime?: string;
+  page?: number;
+  providerPage?: number;
+  modelIndex?: number;
+  recentSlot?: number;
+}): string {
+  const userId = params.userId.trim();
+  if (!userId) {
+    throw new Error("Discord model picker custom_id requires userId");
+  }
+
+  const page = normalizeModelPickerPage(params.page);
+  const providerPage =
+    typeof params.providerPage === "number" && Number.isFinite(params.providerPage)
+      ? Math.max(1, Math.floor(params.providerPage))
+      : undefined;
+  const normalizedProvider = params.provider ? normalizeProviderId(params.provider) : undefined;
+  const modelIndex =
+    typeof params.modelIndex === "number" && Number.isFinite(params.modelIndex)
+      ? Math.max(1, Math.floor(params.modelIndex))
+      : undefined;
+  const recentSlot =
+    typeof params.recentSlot === "number" && Number.isFinite(params.recentSlot)
+      ? Math.max(1, Math.floor(params.recentSlot))
+      : undefined;
+
+  const parts = [
+    `${DISCORD_MODEL_PICKER_CUSTOM_ID_KEY}:c=${encodeCustomIdValue(params.command)}`,
+    `a=${encodeCustomIdValue(params.action)}`,
+    `v=${encodeCustomIdValue(params.view)}`,
+    `u=${encodeCustomIdValue(userId)}`,
+    `g=${String(page)}`,
+  ];
+  if (normalizedProvider) {
+    parts.push(`p=${encodeCustomIdValue(normalizedProvider)}`);
+  }
+  const runtime = params.runtime?.trim();
+  if (runtime) {
+    parts.push(`r=${encodeCustomIdValue(runtime)}`);
+  }
+  if (providerPage) {
+    parts.push(`pp=${String(providerPage)}`);
+  }
+  if (modelIndex) {
+    parts.push(`mi=${String(modelIndex)}`);
+  }
+  if (recentSlot) {
+    parts.push(`rs=${String(recentSlot)}`);
+  }
+
+  const customId = parts.join(";");
+  if (customId.length > DISCORD_CUSTOM_ID_MAX_CHARS) {
+    throw new Error(
+      `Discord model picker custom_id exceeds ${DISCORD_CUSTOM_ID_MAX_CHARS} chars (${customId.length})`,
+    );
+  }
+  return customId;
+}
+
+export function parseDiscordModelPickerCustomId(customId: string): DiscordModelPickerState | null {
+  const trimmed = customId.trim();
+  if (!trimmed.startsWith(`${DISCORD_MODEL_PICKER_CUSTOM_ID_KEY}:`)) {
+    return null;
+  }
+
+  const rawParts = trimmed.split(";");
+  const data: Record<string, string> = {};
+  for (const part of rawParts) {
+    const equalsIndex = part.indexOf("=");
+    if (equalsIndex <= 0) {
+      continue;
+    }
+    const rawKey = part.slice(0, equalsIndex);
+    const rawValue = part.slice(equalsIndex + 1);
+    const key = rawKey.includes(":") ? rawKey.split(":").slice(1).join(":") : rawKey;
+    if (!key) {
+      continue;
+    }
+    data[key] = rawValue;
+  }
+
+  return parseDiscordModelPickerData(data);
+}
+
+export function parseDiscordModelPickerData(data: ComponentData): DiscordModelPickerState | null {
+  if (!data || typeof data !== "object") {
+    return null;
+  }
+
+  const command = decodeCustomIdValue(coerceString(data.c ?? data.cmd));
+  const action = decodeCustomIdValue(coerceString(data.a ?? data.act));
+  const view = decodeCustomIdValue(coerceString(data.v ?? data.view));
+  const userId = decodeCustomIdValue(coerceString(data.u));
+  const providerRaw = decodeCustomIdValue(coerceString(data.p));
+  const runtimeRaw = decodeCustomIdValue(coerceString(data.r));
+  const page = parseRawPage(data.g ?? data.pg);
+  const providerPage = parseRawPositiveInt(data.pp);
+  const modelIndex = parseRawPositiveInt(data.mi);
+  const recentSlot = parseRawPositiveInt(data.rs);
+
+  if (!isValidCommandContext(command) || !isValidPickerAction(action) || !isValidPickerView(view)) {
+    return null;
+  }
+
+  const trimmedUserId = userId.trim();
+  if (!trimmedUserId) {
+    return null;
+  }
+
+  const provider = providerRaw ? normalizeProviderId(providerRaw) : undefined;
+  const runtime = runtimeRaw.trim() || undefined;
+
+  return {
+    command,
+    action,
+    view,
+    userId: trimmedUserId,
+    provider,
+    runtime,
+    page,
+    ...(typeof providerPage === "number" ? { providerPage } : {}),
+    ...(typeof modelIndex === "number" ? { modelIndex } : {}),
+    ...(typeof recentSlot === "number" ? { recentSlot } : {}),
+  };
+}
+
+export function buildDiscordModelPickerProviderItems(
+  data: ModelsProviderData,
+): DiscordModelPickerProviderItem[] {
+  return data.providers.map((provider) => ({
+    id: provider,
+    count: data.byProvider.get(provider)?.size ?? 0,
+  }));
+}
+
+export function getDiscordModelPickerProviderPage(params: {
+  data: ModelsProviderData;
+  page?: number;
+  pageSize?: number;
+}): DiscordModelPickerPage<DiscordModelPickerProviderItem> {
+  const items = buildDiscordModelPickerProviderItems(params.data);
+  const canFitSinglePage = items.length <= DISCORD_MODEL_PICKER_PROVIDER_SINGLE_PAGE_MAX;
+  const maxPageSize = canFitSinglePage
+    ? DISCORD_MODEL_PICKER_PROVIDER_SINGLE_PAGE_MAX
+    : DISCORD_MODEL_PICKER_PROVIDER_PAGE_SIZE;
+  const pageSize = clampPageSize(params.pageSize, maxPageSize, maxPageSize);
+  return paginateItems({
+    items,
+    page: normalizeModelPickerPage(params.page),
+    pageSize,
+  });
+}
+
+export function getDiscordModelPickerModelPage(params: {
+  data: ModelsProviderData;
+  provider: string;
+  page?: number;
+  pageSize?: number;
+}): DiscordModelPickerModelPage | null {
+  const provider = normalizeProviderId(params.provider);
+  const modelSet = params.data.byProvider.get(provider);
+  if (!modelSet) {
+    return null;
+  }
+
+  const pageSize = clampPageSize(
+    params.pageSize,
+    DISCORD_MODEL_PICKER_MODEL_PAGE_SIZE,
+    DISCORD_MODEL_PICKER_MODEL_PAGE_SIZE,
+  );
+  const models = [...modelSet].toSorted();
+  const page = paginateItems({
+    items: models,
+    page: normalizeModelPickerPage(params.page),
+    pageSize,
+  });
+
+  return {
+    ...page,
+    provider,
+  };
+}

package/src/monitor/model-picker.test-utils.ts

@@ -0,0 +1,26 @@
+import type { ModelsProviderData } from "openclaw/plugin-sdk/models-provider-runtime";
+
+export function createModelsProviderData(
+  entries: Record<string, string[]>,
+  opts?: { defaultProviderOrder?: "insertion" | "sorted" },
+): ModelsProviderData {
+  const byProvider = new Map<string, Set<string>>();
+  for (const [provider, models] of Object.entries(entries)) {
+    byProvider.set(provider, new Set(models));
+  }
+  const providers = Object.keys(entries).toSorted();
+  const insertionProvider = Object.keys(entries)[0];
+  const defaultProvider =
+    opts?.defaultProviderOrder === "sorted"
+      ? (providers[0] ?? "openai")
+      : (insertionProvider ?? "openai");
+  return {
+    byProvider,
+    providers,
+    resolvedDefault: {
+      provider: defaultProvider,
+      model: entries[defaultProvider]?.[0] ?? "gpt-4o",
+    },
+    modelNames: new Map<string, string>(),
+  };
+}