Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
import {
DEFAULT_MODEL,
DEFAULT_MODEL_BY_PROVIDER,
defaultInstanceIdForDriver,
ProviderDriverKind,
type ModelCapabilities,
type ProviderInstanceId,
type ServerProvider,
type ServerProviderModel,
} from "@akeru/contracts";
import { createModelCapabilities, normalizeModelSlug } from "@akeru/shared/model";
const EMPTY_CAPABILITIES: ModelCapabilities = createModelCapabilities({
optionDescriptors: [],
});
const DEFAULT_DRIVER_KIND = ProviderDriverKind.make("codex");
export function formatProviderDriverKindLabel(provider: ProviderDriverKind): string {
return provider
.replace(/([a-z])([A-Z])/g, "$1 $2")
.replace(/[_-]+/g, " ")
.trim()
.replace(/\b\w/g, (char) => char.toUpperCase());
}
export function getProviderModels(
providers: ReadonlyArray<ServerProvider>,
provider: ProviderDriverKind,
): ReadonlyArray<ServerProviderModel> {
return getProviderSnapshot(providers, provider)?.models ?? [];
}
export function getProviderSnapshot(
providers: ReadonlyArray<ServerProvider>,
provider: ProviderDriverKind,
): ServerProvider | undefined {
const defaultInstanceId = defaultInstanceIdForDriver(provider);
return providers.find((candidate) => candidate.instanceId === defaultInstanceId);
}
export function getProviderDisplayName(
providers: ReadonlyArray<ServerProvider>,
provider: ProviderDriverKind,
): string {
const snapshot = getProviderSnapshot(providers, provider);
return snapshot?.displayName?.trim() || formatProviderDriverKindLabel(provider);
}
export function getProviderInteractionModeToggle(
providers: ReadonlyArray<ServerProvider>,
provider: ProviderDriverKind,
): boolean {
return getProviderSnapshot(providers, provider)?.showInteractionModeToggle ?? true;
}
export function isProviderEnabled(
providers: ReadonlyArray<ServerProvider>,
provider: ProviderDriverKind,
): boolean {
if (providers.length === 0) {
return true;
}
return getProviderSnapshot(providers, provider)?.enabled ?? false;
}
// Resolve an instance selection to the correlated live driver. If the
// instance is absent, fall back to a live enabled provider instead of
// inferring a driver from the missing instance id.
export function resolveSelectableProvider(
providers: ReadonlyArray<ServerProvider>,
provider: ProviderDriverKind | ProviderInstanceId | null | undefined,
): ProviderDriverKind {
const requestedEntry = providers.find((candidate) => candidate.instanceId === provider);
if (requestedEntry?.enabled) {
return requestedEntry.driver;
}
return providers.find((candidate) => candidate.enabled)?.driver ?? DEFAULT_DRIVER_KIND;
}
export function getProviderModelCapabilities(
models: ReadonlyArray<ServerProviderModel>,
model: string | null | undefined,
provider: ProviderDriverKind,
): ModelCapabilities {
return findProviderModelCapabilities(models, model, provider) ?? EMPTY_CAPABILITIES;
}
/**
* The capabilities a listed model advertises, or undefined when this client
* cannot know them: the model is not listed, or its snapshot carries no
* descriptor list. Unknown is not the same as an empty list, which says the
* model takes no options.
*/
export function findProviderModelCapabilities(
models: ReadonlyArray<ServerProviderModel>,
model: string | null | undefined,
provider: ProviderDriverKind,
): ModelCapabilities | undefined {
const slug = normalizeModelSlug(model, provider);
const caps = models.find((candidate) => candidate.slug === slug)?.capabilities;
return caps?.optionDescriptors === undefined ? undefined : withoutPlanAgentOption(caps);
}
// Plan mode is retired, so the opencode "plan" agent is never selectable.
// Drop the option so it cannot be selected or dispatched, and drop the
// descriptor entirely when nothing remains selectable. currentValue
// is re-resolved against the surviving options so a stale or defaulted "plan"
// value cannot leak back into dispatch.
function withoutPlanAgentOption(caps: ModelCapabilities): ModelCapabilities {
return {
...caps,
optionDescriptors: (caps.optionDescriptors ?? []).flatMap((descriptor) => {
if (descriptor.type !== "select" || descriptor.id !== "agent") {
return [descriptor];
}
const options = descriptor.options.filter((option) => option.id !== "plan");
if (options.length === 0) {
return [];
}
const currentValue =
descriptor.currentValue && options.some((option) => option.id === descriptor.currentValue)
? descriptor.currentValue
: (options.find((option) => option.isDefault)?.id ?? options[0]?.id);
return [{ ...descriptor, options, ...(currentValue ? { currentValue } : {}) }];
}),
};
}
export function getDefaultServerModel(
providers: ReadonlyArray<ServerProvider>,
provider: ProviderDriverKind,
): string {
const models = getProviderModels(providers, provider);
return (
models.find((model) => model.isDefault && !model.isCustom)?.slug ??
models.find((model) => !model.isCustom)?.slug ??
models[0]?.slug ??
DEFAULT_MODEL_BY_PROVIDER[provider] ??
DEFAULT_MODEL
);
}