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 {
defaultInstanceIdForDriver,
instanceUsesSavedCredential,
type ProviderInstanceConfig,
type ServerProvider,
SubscriptionBaseUrl,
type SubscriptionAuthStartInput,
type SubscriptionProviderId,
type SubscriptionProviderStatus,
} from "@akeru/contracts";
import * as Schema from "effect/Schema";
import type { MessageKey } from "./i18n/index.ts";
export const PROVIDER_CONNECTIONS = [
{ id: "openai-codex", label: "ChatGPT" },
{ id: "anthropic", label: "Claude" },
{ id: "xai", label: "Grok" },
{ id: "kimi-for-coding", label: "Kimi For Coding" },
{ id: "opencode-go", label: "OpenCode Go" },
] as const satisfies ReadonlyArray<{ id: SubscriptionProviderId; label: string }>;
export function providerSupportsBaseUrl(provider: SubscriptionProviderId): boolean {
return provider !== "xai";
}
export function providerUsesApiKey(status: SubscriptionProviderStatus | undefined): boolean {
return status?.authMode === "api-key" || status?.provider === "opencode-go";
}
const isSubscriptionBaseUrl = Schema.is(SubscriptionBaseUrl);
export function apiKeyValidationError(key: string, baseUrl: string): string | null {
if (!key.trim()) return "Enter an API key.";
if (baseUrl.trim() && !isSubscriptionBaseUrl(baseUrl.trim())) {
return "Use an HTTP or HTTPS base URL without credentials, a query, or a fragment.";
}
return null;
}
export function apiKeyStartInput(
provider: SubscriptionProviderId,
baseUrl: string,
): SubscriptionAuthStartInput {
return {
provider,
authMode: "api-key",
...(providerSupportsBaseUrl(provider) && baseUrl.trim() ? { baseUrl: baseUrl.trim() } : {}),
};
}
/** How often clients refresh statuses while a server-side post-login health check runs. */
export const HEALTH_CHECK_REFRESH_MS = 1500;
/** True while the server is still checking a newly stored credential for any provider. */
export function anyProviderHealthChecking(
statuses: ReadonlyArray<SubscriptionProviderStatus> | undefined,
): boolean {
return statuses?.some((status) => status.healthChecking === true) ?? false;
}
/** Catalog copy: render through `t`. */
export function providerConnectionLabel(status: SubscriptionProviderStatus): MessageKey {
if (!status.connected) return "Not connected";
if (status.healthChecking === true) return "Checking health…";
return providerUsesApiKey(status) ? "API key saved" : "OAuth connected";
}
/** Subscription connection that backs each built-in driver's default instance. */
export const SUBSCRIPTION_PROVIDER_BY_DRIVER = new Map<string, SubscriptionProviderId>([
["codex", "openai-codex"],
["claudeAgent", "anthropic"],
["grok", "xai"],
["kimi", "kimi-for-coding"],
["opencodeGo", "opencode-go"],
]);
/**
* Keep default built-in provider instances aligned with the connections the
* user made inside Akeru. Host CLI credentials are intentionally not enough
* to make an unconnected account appear in model pickers. Custom instances
* remain governed by their own configured environment and provider probe.
*/
export function filterProvidersBySubscriptionConnection(
providers: ReadonlyArray<ServerProvider>,
statuses: ReadonlyArray<SubscriptionProviderStatus> | undefined,
): ReadonlyArray<ServerProvider> {
if (!statuses) return providers;
const connected = new Set(
statuses.filter((status) => status.connected).map((status) => status.provider),
);
return providers.filter((provider) => {
const subscriptionProvider = SUBSCRIPTION_PROVIDER_BY_DRIVER.get(String(provider.driver));
if (!subscriptionProvider) return true;
if (provider.instanceId !== defaultInstanceIdForDriver(provider.driver)) return true;
return connected.has(subscriptionProvider);
});
}
/**
* Server turn preflight lets an expired OAuth login on a saved connection try a
* token refresh, so clients must not block Send on it. Returns the provider
* with that expired login cleared; revoked and API-key logins stay blocked, as
* do instances configured with their own credential in `providerInstances`.
*/
export function withRefreshableSubscriptionLogin(
provider: ServerProvider,
statuses: ReadonlyArray<SubscriptionProviderStatus> | undefined,
providerInstances?: Readonly<Record<string, ProviderInstanceConfig>>,
): ServerProvider {
const subscriptionProvider = SUBSCRIPTION_PROVIDER_BY_DRIVER.get(String(provider.driver));
if (!subscriptionProvider) return provider;
if (provider.instanceId !== defaultInstanceIdForDriver(provider.driver)) return provider;
if (
!instanceUsesSavedCredential(subscriptionProvider, providerInstances?.[provider.instanceId])
) {
return provider;
}
const status = statuses?.find((candidate) => candidate.provider === subscriptionProvider);
if (status?.health !== "expired" || status.authMode !== "oauth") return provider;
const expired = provider.unavailability === "expired-login";
if (!expired && provider.auth.status !== "unauthenticated") return provider;
const {
unavailability: _unavailability,
unavailabilityDetail: _unavailabilityDetail,
repairAction: _repairAction,
...rest
} = provider;
return {
...(expired ? rest : provider),
auth:
provider.auth.status === "unauthenticated"
? { ...provider.auth, status: "unknown" }
: provider.auth,
};
}