/** Shared helpers for model commands that read or mutate model config. */

import { listAgentIds } from "../../agents/agent-scope.js";

import { DEFAULT_MODEL, DEFAULT_PROVIDER } from "../../agents/defaults.js";

import {

}

};

/** Formats token counts as compact K-suffixed labels. */

export const formatTokenK = (value?: number | null) => {

if (!value || !Number.isFinite(value)) {

return "-";

return `${Math.round(value / 1024)}k`;

};

/** Formats millisecond durations for model command output. */

export const formatMs = (value?: number | null) => {

if (value === null || value === undefined) {

return "-";

return `${Math.round(value / 100) / 10}s`;

};

/** Loads config from disk and throws a formatted error when validation fails. */

export async function loadValidConfigOrThrow(): Promise<OpenClawConfig> {

const snapshot = await readConfigFileSnapshot();

if (!snapshot.valid) {

return snapshot.runtimeConfig ?? snapshot.config;

}

/** Runtime config snapshot supplied to model config mutators. */

export type UpdateConfigContext = {

runtimeConfig: OpenClawConfig;

};

/** Reads source config, applies a mutator, and writes only the source-form config. */

export async function updateConfig(

mutator: (cfg: OpenClawConfig, context: UpdateConfigContext) => OpenClawConfig,

): Promise<OpenClawConfig> {

}

const sourceConfig = structuredClone(snapshot.sourceConfig ?? snapshot.config);

const runtimeConfig = structuredClone(snapshot.runtimeConfig ?? snapshot.config);

// Mutate source config so SecretRefs and unresolved placeholders do not get

// overwritten by runtime-resolved secret values.

const next = mutator(sourceConfig, { runtimeConfig });

await replaceConfigFile({

nextConfig: next,

return next;

}

/** Resolves a CLI model reference through aliases and catalog provider aliases. */

export function resolveModelTarget(params: { raw: string; cfg: OpenClawConfig }): {

provider: string;

model: string;

return resolved?.alias ? resolved.ref : undefined;

}

/** Resolves model reference strings to canonical provider/model keys. */

export function resolveModelKeysFromEntries(params: {

cfg: OpenClawConfig;

entries: readonly string[];

.map((entry) => modelKey(entry.ref.provider, entry.ref.model));

}

/** Builds the configured model allowlist from agents.defaults.models keys. */

export function buildAllowlistSet(cfg: OpenClawConfig): Set<string> {

const allowed = new Set<string>();

const models = cfg.agents?.defaults?.models ?? {};

return allowed;

}

/** Validates an optional agent id against configured agents. */

export function resolveKnownAgentId(params: {

cfg: OpenClawConfig;

rawAgentId?: string | null;

return agentId;

}

/** Normalized primary/fallback config shape used by text and image defaults. */

export type PrimaryFallbackConfig = { primary?: string; fallbacks?: string[] };

/** Upserts the canonical model entry and folds legacy key metadata into it. */

export function upsertCanonicalModelConfigEntry(

models: Record<string, AgentModelEntryConfig>,

params: { provider: string; model: string },

}

if (legacyEntry) {

// Preserve legacy per-model params while moving the entry to provider/model.

models[key] = {

...legacyEntry,

...models[key],

return key;

}

/** Merges primary/fallback patches while normalizing refs for config storage. */

export function mergePrimaryFallbackConfig(

existing: PrimaryFallbackConfig | undefined,

patch: { primary?: string; fallbacks?: string[] },

return next;

}

/** Applies a default text/image primary-model update and ensures the model entry exists. */

export function applyDefaultModelPrimaryUpdate(params: {

cfg: OpenClawConfig;

resolveCfg?: OpenClawConfig;