import type { Api, Model } from "@mariozechner/pi-ai" ;
import type { ModelRegistry } from "@mariozechner/pi-coding-agent" ;
import type { AuthProfileStore } from "../../agents/auth-profiles/types.js" ;
import { DEFAULT_CONTEXT_TOKENS } from "../../agents/defaults.js" ;
import { shouldSuppressBuiltInModel } from "../../agents/model-suppression.js" ;
import { normalizeProviderId } from "../../agents/provider-id.js" ;
import type { ModelDefinitionConfig, ModelProviderConfig } from "../../config/types.models.js" ;
import type { OpenClawConfig } from "../../config/types.openclaw.js" ;
import type { ListRowModel } from "./list.model-row.js" ;
import { toModelRow } from "./list.registry.js" ;
import {
loadModelCatalog,
loadProviderCatalogModelsForList,
resolveModelWithRegistry,
} from "./list.runtime.js" ;
import type { ConfiguredEntry, ModelRow } from "./list.types.js" ;
import { isLocalBaseUrl, modelKey } from "./shared.js" ;
type ConfiguredByKey = Map<string, ConfiguredEntry>;
type RowFilter = {
provider?: string;
local?: boolean ;
};
export type RowBuilderContext = {
cfg: OpenClawConfig;
agentDir: string;
authStore: AuthProfileStore;
availableKeys?: Set<string>;
configuredByKey: ConfiguredByKey;
discoveredKeys: Set<string>;
filter: RowFilter;
skipRuntimeModelSuppression?: boolean ;
};
function matchesRowFilter(filter: RowFilter, model: { provider: string; baseUrl?: string }) {
if (filter.provider && normalizeProviderId(model.provider) !== filter.provider) {
return false ;
}
if (filter.local && !isLocalBaseUrl(model.baseUrl ?? "" )) {
return false ;
}
return true ;
}
function buildRow(params: {
model: ListRowModel;
key: string;
context: RowBuilderContext;
allowProviderAvailabilityFallback?: boolean ;
}): ModelRow {
const configured = params.context.configuredByKey.get(params.key);
return toModelRow({
model: params.model,
key: params.key,
tags: configured ? Array.from(configured.tags) : [],
aliases: configured?.aliases ?? [],
availableKeys: params.context.availableKeys,
cfg: params.context.cfg,
authStore: params.context.authStore,
allowProviderAvailabilityFallback: params.allowProviderAvailabilityFallback ?? false ,
});
}
function shouldSuppressListModel(params: {
model: { provider: string; id: string; baseUrl?: string };
context: RowBuilderContext;
}): boolean {
if (params.context.skipRuntimeModelSuppression) {
return false ;
}
return shouldSuppressBuiltInModel({
provider: params.model.provider,
id: params.model.id,
baseUrl: params.model.baseUrl,
config: params.context.cfg,
});
}
function appendVisibleRow(params: {
rows: ModelRow[];
model: ListRowModel;
key: string;
context: RowBuilderContext;
seenKeys?: Set<string>;
allowProviderAvailabilityFallback?: boolean ;
}): boolean {
if (params.seenKeys?.has(params.key)) {
return false ;
}
if (!matchesRowFilter(params.context.filter, params.model)) {
return false ;
}
if (shouldSuppressListModel({ model: params.model, context: params.context })) {
return false ;
}
params.rows.push(
buildRow({
model: params.model,
key: params.key,
context: params.context,
allowProviderAvailabilityFallback: params.allowProviderAvailabilityFallback,
}),
);
params.seenKeys?.add(params.key);
return true ;
}
function resolveConfiguredModelInput(params: {
model: Partial<ModelDefinitionConfig>;
}): Array<"text" | "image" > {
const input = Array.isArray(params.model.input)
? params.model.input.filter(
(item): item is "text" | "image" => item === "text" || item === "image" ,
)
: [];
return input.length > 0 ? input : ["text" ];
}
function toConfiguredProviderListModel(params: {
provider: string;
providerConfig: Partial<ModelProviderConfig>;
model: Partial<ModelDefinitionConfig> & Pick<ModelDefinitionConfig, "id" >;
}): ListRowModel {
return {
provider: params.provider,
id: params.model.id,
name: params.model.name ?? params.model.id,
baseUrl: params.model.baseUrl ?? params.providerConfig.baseUrl,
input: resolveConfiguredModelInput({ model: params.model }),
contextWindow: params.model.contextWindow ?? DEFAULT_CONTEXT_TOKENS,
contextTokens: params.model.contextTokens,
};
}
function shouldListConfiguredProviderModel(params: {
providerConfig: Partial<ModelProviderConfig>;
model: Partial<ModelDefinitionConfig>;
}): boolean {
return params.providerConfig.api !== undefined || params.model.api !== undefined;
}
export function appendDiscoveredRows(params: {
rows: ModelRow[];
models: Model<Api>[];
modelRegistry?: ModelRegistry;
context: RowBuilderContext;
}): Set<string> {
const seenKeys = new Set<string>();
const sorted = [...params.models].toSorted((a, b) => {
const providerCompare = a.provider.localeCompare(b.provider);
if (providerCompare !== 0 ) {
return providerCompare;
}
return a.id.localeCompare(b.id);
});
for (const model of sorted) {
const key = modelKey(model.provider, model.id);
const resolvedModel = params.modelRegistry
? resolveModelWithRegistry({
provider: model.provider,
modelId: model.id,
modelRegistry: params.modelRegistry,
cfg: params.context.cfg,
agentDir: params.context.agentDir,
})
: undefined;
const rowModel =
resolvedModel && modelKey(resolvedModel.provider, resolvedModel.id) === key
? resolvedModel
: model;
appendVisibleRow({
rows: params.rows,
model: rowModel,
key,
context: params.context,
seenKeys,
});
}
return seenKeys;
}
export function appendConfiguredProviderRows(params: {
rows: ModelRow[];
context: RowBuilderContext;
seenKeys: Set<string>;
}): void {
for (const [provider, providerConfig] of Object.entries(
params.context.cfg.models?.providers ?? {},
)) {
for (const configuredModel of providerConfig.models ?? []) {
if (!shouldListConfiguredProviderModel({ providerConfig, model: configuredModel })) {
continue ;
}
const key = modelKey(provider, configuredModel.id);
const model = toConfiguredProviderListModel({
provider,
providerConfig,
model: configuredModel,
});
appendVisibleRow({
rows: params.rows,
model,
key,
context: params.context,
seenKeys: params.seenKeys,
allowProviderAvailabilityFallback: !params.context.discoveredKeys.has(key),
});
}
}
}
export async function appendCatalogSupplementRows(params: {
rows: ModelRow[];
modelRegistry: ModelRegistry;
context: RowBuilderContext;
seenKeys: Set<string>;
}): Promise<void > {
const catalog = await loadModelCatalog({ config: params.context.cfg, readOnly: true });
for (const entry of catalog) {
if (
params.context.filter.provider &&
normalizeProviderId(entry.provider) !== params.context.filter.provider
) {
continue ;
}
const key = modelKey(entry.provider, entry.id);
const model = resolveModelWithRegistry({
provider: entry.provider,
modelId: entry.id,
modelRegistry: params.modelRegistry,
cfg: params.context.cfg,
});
if (!model) {
continue ;
}
appendVisibleRow({
rows: params.rows,
model,
key,
context: params.context,
seenKeys: params.seenKeys,
allowProviderAvailabilityFallback: !params.context.discoveredKeys.has(key),
});
}
if (params.context.filter.local) {
return ;
}
await appendProviderCatalogRows({
rows: params.rows,
context: params.context,
seenKeys: params.seenKeys,
});
}
export async function appendProviderCatalogRows(params: {
rows: ModelRow[];
context: RowBuilderContext;
seenKeys: Set<string>;
staticOnly?: boolean ;
}): Promise<number> {
let appended = 0 ;
for (const model of await loadProviderCatalogModelsForList({
cfg: params.context.cfg,
agentDir: params.context.agentDir,
providerFilter: params.context.filter.provider,
staticOnly: params.staticOnly,
})) {
const key = modelKey(model.provider, model.id);
if (
appendVisibleRow({
rows: params.rows,
model,
key,
context: params.context,
seenKeys: params.seenKeys,
allowProviderAvailabilityFallback: !params.context.discoveredKeys.has(key),
})
) {
appended += 1 ;
}
}
return appended;
}
export function appendConfiguredRows(params: {
rows: ModelRow[];
entries: ConfiguredEntry[];
modelRegistry: ModelRegistry;
context: RowBuilderContext;
}) {
for (const entry of params.entries) {
if (
params.context.filter.provider &&
normalizeProviderId(entry.ref.provider) !== params.context.filter.provider
) {
continue ;
}
const model = resolveModelWithRegistry({
provider: entry.ref.provider,
modelId: entry.ref.model,
modelRegistry: params.modelRegistry,
cfg: params.context.cfg,
});
if (params.context.filter.local && model && !isLocalBaseUrl(model.baseUrl ?? "" )) {
continue ;
}
if (params.context.filter.local && !model) {
continue ;
}
if (model && shouldSuppressListModel({ model, context: params.context })) {
continue ;
}
params.rows.push(
toModelRow({
model,
key: entry.key,
tags: Array.from(entry.tags),
aliases: entry.aliases,
availableKeys: params.context.availableKeys,
cfg: params.context.cfg,
authStore: params.context.authStore,
allowProviderAvailabilityFallback: model
? !params.context.discoveredKeys.has(modelKey(model.provider, model.id))
: false ,
}),
);
}
}
Messung V0.5 in Prozent C=100 H=93 G=96
¤ Dauer der Verarbeitung: 0.3 Sekunden
¤
*© Formatika GbR, Deutschland