import { DEFAULT_MODEL, DEFAULT_MODEL_BY_PROVIDER, MODEL_SLUG_ALIASES_BY_PROVIDER, type ModelCapabilities, type ModelSelection, ProviderDriverKind, ProviderInstanceId, type ProviderOptionDescriptor, type ProviderOptionSelection, } from "@t3tools/contracts"; const DEFAULT_PROVIDER_DRIVER_KIND = ProviderDriverKind.make("codex"); export interface SelectableModelOption { slug: string; name: string; } export function createModelCapabilities(input: { optionDescriptors: ReadonlyArray; }): ModelCapabilities { return { optionDescriptors: input.optionDescriptors.map(cloneDescriptor), }; } function getRawSelectionValueById( selections: ReadonlyArray | null | undefined, id: string, ): string | boolean | undefined { const selection = selections?.find((candidate) => candidate.id === id); return selection?.value; } export function getProviderOptionSelectionValue( selections: ReadonlyArray | null | undefined, id: string, ): string | boolean | undefined { return getRawSelectionValueById(selections, id); } export function getProviderOptionStringSelectionValue( selections: ReadonlyArray | null | undefined, id: string, ): string | undefined { const value = getProviderOptionSelectionValue(selections, id); return typeof value === "string" ? value : undefined; } export function getProviderOptionBooleanSelectionValue( selections: ReadonlyArray | null | undefined, id: string, ): boolean | undefined { const value = getProviderOptionSelectionValue(selections, id); return typeof value === "boolean" ? value : undefined; } export function getModelSelectionOptionValue( modelSelection: ModelSelection | null | undefined, id: string, ): string | boolean | undefined { return getProviderOptionSelectionValue(modelSelection?.options, id); } export function getModelSelectionStringOptionValue( modelSelection: ModelSelection | null | undefined, id: string, ): string | undefined { return getProviderOptionStringSelectionValue(modelSelection?.options, id); } export function getModelSelectionBooleanOptionValue( modelSelection: ModelSelection | null | undefined, id: string, ): boolean | undefined { return getProviderOptionBooleanSelectionValue(modelSelection?.options, id); } function resolveDescriptorChoiceValue( descriptor: Extract, raw: string | null | undefined, ): string | undefined { const trimmed = trimOrNull(raw); if (!trimmed) { return descriptor.currentValue ?? descriptor.options.find((option) => option.isDefault)?.id; } if (descriptor.options.length === 0) { return trimmed; } if ( descriptor.promptInjectedValues?.includes(trimmed) && descriptor.options.some((option) => option.id === trimmed) ) { return descriptor.options.find((option) => option.isDefault)?.id; } if (descriptor.options.some((option) => option.id === trimmed)) { return trimmed; } return descriptor.currentValue ?? descriptor.options.find((option) => option.isDefault)?.id; } function cloneDescriptor(descriptor: ProviderOptionDescriptor): ProviderOptionDescriptor { return descriptor.type === "select" ? { ...descriptor, options: [...descriptor.options], ...(descriptor.promptInjectedValues ? { promptInjectedValues: [...descriptor.promptInjectedValues] } : {}), } : { ...descriptor }; } function cloneSelection(selection: ProviderOptionSelection): ProviderOptionSelection { return { ...selection }; } function withDescriptorCurrentValue( descriptor: ProviderOptionDescriptor, rawCurrentValue: string | boolean | undefined, ): ProviderOptionDescriptor { if (descriptor.type === "boolean") { if (typeof rawCurrentValue === "boolean") { return { ...descriptor, currentValue: rawCurrentValue, }; } return descriptor; } const currentValue = typeof rawCurrentValue === "string" ? resolveDescriptorChoiceValue(descriptor, rawCurrentValue) : resolveDescriptorChoiceValue(descriptor, descriptor.currentValue); if (!currentValue) { const { currentValue: _unusedCurrentValue, ...rest } = descriptor; return rest; } return { ...descriptor, currentValue, }; } export function getProviderOptionDescriptors(input: { caps: ModelCapabilities; selections?: ReadonlyArray | null | undefined; }): ReadonlyArray { const { caps, selections } = input; const baseDescriptors = (caps.optionDescriptors ?? []).map(cloneDescriptor); return baseDescriptors.map((descriptor) => withDescriptorCurrentValue( descriptor, getRawSelectionValueById(selections, descriptor.id) ?? descriptor.currentValue, ), ); } export function getProviderOptionCurrentValue( descriptor: ProviderOptionDescriptor | null | undefined, ): string | boolean | undefined { if (!descriptor) { return undefined; } if (descriptor.type === "boolean") { return descriptor.currentValue; } if (descriptor.currentValue) { return descriptor.currentValue; } return descriptor.options.find((option) => option.isDefault)?.id; } export function getProviderOptionCurrentLabel( descriptor: ProviderOptionDescriptor | null | undefined, ): string | undefined { if (!descriptor) { return undefined; } if (descriptor.type === "boolean") { return typeof descriptor.currentValue === "boolean" ? descriptor.currentValue ? "On" : "Off" : undefined; } const currentValue = getProviderOptionCurrentValue(descriptor); if (typeof currentValue !== "string") { return undefined; } return descriptor.options.find((option) => option.id === currentValue)?.label; } export function buildProviderOptionSelectionsFromDescriptors( descriptors: ReadonlyArray | null | undefined, ): Array | undefined { if (!descriptors || descriptors.length === 0) { return undefined; } const nextSelections: Array = []; for (const descriptor of descriptors) { const value = getProviderOptionCurrentValue(descriptor); if (typeof value === "string" || typeof value === "boolean") { nextSelections.push({ id: descriptor.id, value }); } } return nextSelections.length > 0 ? nextSelections : undefined; } export function getModelSelectionOptionDescriptors( modelSelection: ModelSelection | null | undefined, caps?: ModelCapabilities | null | undefined, ): ReadonlyArray { if (!modelSelection) { return []; } if (!caps) { return []; } return getProviderOptionDescriptors({ caps, selections: modelSelection.options, }); } export function isClaudeUltrathinkPrompt(text: string | null | undefined): boolean { return typeof text === "string" && /\bultrathink\b/i.test(text); } export function normalizeModelSlug( model: string | null | undefined, provider: ProviderDriverKind = DEFAULT_PROVIDER_DRIVER_KIND, ): string | null { const trimmed = normalizeCustomModelSlug(model); if (!trimmed) { return null; } const aliases = MODEL_SLUG_ALIASES_BY_PROVIDER[provider] ?? {}; const aliased = Object.prototype.hasOwnProperty.call(aliases, trimmed) ? aliases[trimmed] : undefined; return typeof aliased === "string" ? aliased : trimmed; } /** Custom model identifiers are provider-owned, so only trim them; never expand aliases. */ export function normalizeCustomModelSlug(model: string | null | undefined): string | null { if (typeof model !== "string") { return null; } return model.trim() || null; } export function resolveSelectableModel( provider: ProviderDriverKind, value: string | null | undefined, options: ReadonlyArray, ): string | null { if (typeof value !== "string") { return null; } const trimmed = value.trim(); if (!trimmed) { return null; } const direct = options.find((option) => option.slug === trimmed); if (direct) { return direct.slug; } const byName = options.find((option) => option.name.toLowerCase() === trimmed.toLowerCase()); if (byName) { return byName.slug; } const normalized = normalizeModelSlug(trimmed, provider); if (!normalized) { return null; } const resolved = options.find((option) => option.slug === normalized); return resolved ? resolved.slug : null; } function resolveModelSlug(model: string | null | undefined, provider: ProviderDriverKind): string { const normalized = normalizeModelSlug(model, provider); if (!normalized) { return DEFAULT_MODEL_BY_PROVIDER[provider] ?? DEFAULT_MODEL; } return normalized; } export function resolveModelSlugForProvider( provider: ProviderDriverKind, model: string | null | undefined, ): string { return resolveModelSlug(model, provider); } /** Trim a string, returning null for empty/missing values. */ export function trimOrNull(value: T | null | undefined): T | null { if (typeof value !== "string") return null; const trimmed = value.trim() as T; return trimmed || null; } function cloneSelections( selections: ReadonlyArray, ): Array { return selections.map(cloneSelection); } export function createModelSelection( instanceId: ProviderInstanceId, model: string, options?: ReadonlyArray | null, ): ModelSelection { const selections = options ? cloneSelections(options) : []; const base: ModelSelection = { instanceId, model, }; return selections.length > 0 ? { ...base, options: selections } : base; } /** * Returns the effort value if it is a prompt-injected value according to * any select descriptor in the given capabilities, or null otherwise. * * Unlike a single `find`, this checks every descriptor so that the * correct descriptor's `promptInjectedValues` list is consulted even when * multiple select descriptors exist. */ export function resolvePromptInjectedEffort( caps: ModelCapabilities, rawEffort: string | null | undefined, ): string | null { const trimmed = trimOrNull(rawEffort); if (!trimmed) return null; const descriptors = getProviderOptionDescriptors({ caps }); for (const descriptor of descriptors) { if (descriptor.type === "select" && descriptor.promptInjectedValues?.includes(trimmed)) { return trimmed; } } return null; } export function applyClaudePromptEffortPrefix( text: string, effort: string | null | undefined, ): string { const trimmed = text.trim(); if (!trimmed) { return trimmed; } if (effort !== "ultrathink") { return trimmed; } if (trimmed.startsWith("Ultrathink:")) { return trimmed; } return `Ultrathink:\n${trimmed}`; }