@clinebot/core 0.0.37 → 0.0.38

package/src/llms/cline-recommended-models.ts

@@ -1,167 +0,0 @@
-import { ProviderSettingsManager } from "../services/storage/provider-settings-manager";
-
-export interface ClineRecommendedModel {
-	id: string;
-	name: string;
-	description: string;
-	tags: string[];
-}
-
-export interface ClineRecommendedModelsData {
-	recommended: ClineRecommendedModel[];
-	free: ClineRecommendedModel[];
-}
-
-export interface FetchClineRecommendedModelsOptions {
-	baseUrl?: string;
-	fetchImpl?: typeof fetch;
-	providerSettingsManager?: Pick<
-		ProviderSettingsManager,
-		"getProviderSettings"
-	>;
-	timeoutMs?: number;
-}
-
-const DEFAULT_API_BASE_URL = "https://api.cline.bot";
-const DEFAULT_REQUEST_TIMEOUT_MS = 5_000;
-
-export const FALLBACK_CLINE_RECOMMENDED_MODELS: ClineRecommendedModelsData = {
-	recommended: [
-		{
-			id: "anthropic/claude-opus-4.6",
-			name: "Claude Opus 4.6",
-			description: "Most intelligent model for agents and coding",
-			tags: ["BEST"],
-		},
-		{
-			id: "anthropic/claude-sonnet-4.6",
-			name: "Claude Sonnet 4.6",
-			description: "Strong coding and agent performance",
-			tags: ["NEW"],
-		},
-		{
-			id: "google/gemini-3.1-pro-preview",
-			name: "Gemini 3.1 Pro Preview",
-			description: "1M context window, strong coding performance",
-			tags: ["NEW"],
-		},
-		{
-			id: "openai/gpt-5.3-codex",
-			name: "GPT-5.3 Codex",
-			description: "OpenAI's latest with strong coding abilities",
-			tags: ["NEW"],
-		},
-	],
-	free: [
-		{
-			id: "kwaipilot/kat-coder-pro",
-			name: "KwaiKAT Kat Coder Pro",
-			description: "Advanced agentic coding model",
-			tags: ["FREE"],
-		},
-		{
-			id: "arcee-ai/trinity-large-preview:free",
-			name: "Arcee AI Trinity Large Preview",
-			description: "Advanced large preview model",
-			tags: ["FREE"],
-		},
-	],
-};
-
-function cloneRecommendedModels(
-	data: ClineRecommendedModelsData,
-): ClineRecommendedModelsData {
-	return {
-		recommended: data.recommended.map((model) => ({
-			...model,
-			tags: [...model.tags],
-		})),
-		free: data.free.map((model) => ({ ...model, tags: [...model.tags] })),
-	};
-}
-
-function normalizeModel(raw: unknown): ClineRecommendedModel | null {
-	if (!raw || typeof raw !== "object") return null;
-	const data = raw as Record<string, unknown>;
-	if (typeof data.id !== "string" || data.id.length === 0) return null;
-	return {
-		id: data.id,
-		name:
-			typeof data.name === "string" && data.name.length > 0
-				? data.name
-				: data.id,
-		description: typeof data.description === "string" ? data.description : "",
-		tags: Array.isArray(data.tags)
-			? data.tags.filter((tag): tag is string => typeof tag === "string")
-			: [],
-	};
-}
-
-function normalizeResponse(raw: unknown): ClineRecommendedModelsData | null {
-	if (!raw || typeof raw !== "object") return null;
-	const data = raw as Record<string, unknown>;
-	const recommendedRaw = Array.isArray(data.recommended)
-		? data.recommended
-		: [];
-	const freeRaw = Array.isArray(data.free) ? data.free : [];
-	const recommended = recommendedRaw
-		.map(normalizeModel)
-		.filter((model): model is ClineRecommendedModel => model !== null);
-	const free = freeRaw
-		.map(normalizeModel)
-		.filter((model): model is ClineRecommendedModel => model !== null);
-	if (recommended.length === 0 && free.length === 0) return null;
-	return { recommended, free };
-}
-
-function getConfiguredApiBaseUrl(
-	options: FetchClineRecommendedModelsOptions,
-): string {
-	const explicitBaseUrl = options.baseUrl?.trim();
-	if (explicitBaseUrl) return explicitBaseUrl;
-
-	try {
-		const manager =
-			options.providerSettingsManager ?? new ProviderSettingsManager();
-		const settings = manager.getProviderSettings("cline");
-		return settings?.baseUrl?.trim() || DEFAULT_API_BASE_URL;
-	} catch {
-		return DEFAULT_API_BASE_URL;
-	}
-}
-
-async function fetchWithTimeout(
-	fetchImpl: typeof fetch,
-	input: string,
-	timeoutMs: number,
-): Promise<Response> {
-	const controller = new AbortController();
-	const timer = setTimeout(() => controller.abort(), timeoutMs);
-	try {
-		return await fetchImpl(input, { signal: controller.signal });
-	} finally {
-		clearTimeout(timer);
-	}
-}
-
-export async function fetchClineRecommendedModels(
-	options: FetchClineRecommendedModelsOptions = {},
-): Promise<ClineRecommendedModelsData> {
-	try {
-		const base = getConfiguredApiBaseUrl(options);
-		const fetchImpl = options.fetchImpl ?? fetch;
-		const resp = await fetchWithTimeout(
-			fetchImpl,
-			`${base}/api/v1/ai/cline/recommended-models`,
-			options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
-		);
-		if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
-		const json: unknown = await resp.json();
-		const data = normalizeResponse(json);
-		if (data) return data;
-	} catch {
-		// Fall back to the bundled list when the remote source is unavailable.
-	}
-
-	return cloneRecommendedModels(FALLBACK_CLINE_RECOMMENDED_MODELS);
-}

package/src/llms/configured-provider-registry.ts

@@ -1,193 +0,0 @@
-import type { ProviderConfig } from "./provider-settings";
-import type {
-	BuiltInProviderSummary,
-	CreateHandlerInput,
-	ProviderConfigDefaults,
-	ProviderSelectionConfig,
-	RegisteredProviderSummary,
-} from "./runtime-types";
-
-interface ConfiguredProviderRecord {
-	id: string;
-	models: Set<string>;
-	defaultModel: string;
-	defaults: ProviderConfigDefaults;
-}
-
-interface RegisterConfiguredProviderInput {
-	id: string;
-	models: readonly string[];
-	defaultModel?: string;
-	defaults?: ProviderConfigDefaults;
-}
-
-function cloneDefaults(
-	defaults: ProviderConfigDefaults | undefined,
-): ProviderConfigDefaults {
-	return defaults ? { ...defaults } : {};
-}
-
-function resolveApiKey(
-	apiKey?: string,
-	apiKeyEnv?: string,
-): string | undefined {
-	if (apiKey) {
-		return apiKey;
-	}
-	if (!apiKeyEnv) {
-		return undefined;
-	}
-	const runtimeProcess = globalThis.process;
-	if (!runtimeProcess?.env) {
-		return undefined;
-	}
-	return runtimeProcess.env[apiKeyEnv];
-}
-
-function assertNonEmptyModels(
-	providerId: string,
-	models: readonly string[],
-): void {
-	if (!models.length) {
-		throw new Error(
-			`Provider "${providerId}" must include at least one model.`,
-		);
-	}
-}
-
-export function toBuiltInProviderSummary(input: {
-	collection: BuiltInProviderSummary["id"] extends string
-		? {
-				provider: Pick<
-					import("@clinebot/llms").ProviderInfo,
-					| "id"
-					| "name"
-					| "description"
-					| "protocol"
-					| "baseUrl"
-					| "capabilities"
-					| "env"
-					| "defaultModelId"
-				>;
-				models: Record<string, unknown>;
-			}
-		: never;
-}): BuiltInProviderSummary {
-	const models = Object.keys(input.collection.models);
-	return {
-		id: input.collection.provider.id,
-		name: input.collection.provider.name,
-		description: input.collection.provider.description,
-		protocol: input.collection.provider.protocol,
-		baseUrl: input.collection.provider.baseUrl,
-		capabilities: input.collection.provider.capabilities,
-		env: input.collection.provider.env,
-		models,
-		defaultModel: input.collection.provider.defaultModelId,
-		modelCount: models.length,
-	};
-}
-
-export class ConfiguredProviderRegistry {
-	private readonly providers = new Map<string, ConfiguredProviderRecord>();
-
-	register(input: RegisterConfiguredProviderInput): void {
-		assertNonEmptyModels(input.id, input.models);
-		const defaultModel = input.defaultModel ?? input.models[0];
-		if (!defaultModel) {
-			throw new Error(`Provider "${input.id}" must define a default model.`);
-		}
-		if (!input.models.includes(defaultModel)) {
-			throw new Error(
-				`Default model "${defaultModel}" is not included in configured models for "${input.id}".`,
-			);
-		}
-		const existing = this.providers.get(input.id);
-		this.providers.set(input.id, {
-			id: input.id,
-			models: new Set([...(existing?.models ?? []), ...input.models]),
-			defaultModel,
-			defaults: {
-				...(existing?.defaults ?? {}),
-				...cloneDefaults(input.defaults),
-			},
-		});
-	}
-
-	registerSelectionConfig(provider: ProviderSelectionConfig): void {
-		this.register({
-			id: provider.id,
-			models: provider.models,
-			defaultModel: provider.defaultModel,
-			defaults: {
-				apiKey: resolveApiKey(provider.apiKey, provider.apiKeyEnv),
-				routingProviderId: provider.builtinProviderId,
-				baseUrl: provider.baseUrl,
-				headers: provider.headers,
-				timeoutMs: provider.timeoutMs,
-				capabilities: provider.capabilities,
-				...cloneDefaults(provider.settings),
-			},
-		});
-	}
-
-	registerModel(providerId: string, modelId: string): void {
-		const existing = this.providers.get(providerId);
-		if (!existing) {
-			this.providers.set(providerId, {
-				id: providerId,
-				models: new Set([modelId]),
-				defaultModel: modelId,
-				defaults: {},
-			});
-			return;
-		}
-		existing.models.add(modelId);
-	}
-
-	createHandlerConfig(input: CreateHandlerInput): ProviderConfig {
-		const provider = this.require(input.providerId);
-		const modelId = input.modelId ?? provider.defaultModel;
-		if (!provider.models.has(modelId)) {
-			throw new Error(
-				`Model "${modelId}" is not configured for provider "${input.providerId}".`,
-			);
-		}
-		return {
-			providerId: input.providerId,
-			modelId,
-			...provider.defaults,
-			...input.overrides,
-		};
-	}
-
-	list(): RegisteredProviderSummary[] {
-		return Array.from(this.providers.values()).map((provider) => ({
-			id: provider.id,
-			models: Array.from(provider.models),
-			defaultModel: provider.defaultModel,
-		}));
-	}
-
-	getModels(providerId: string): string[] {
-		return Array.from(this.require(providerId).models);
-	}
-
-	hasProvider(providerId: string): boolean {
-		return this.providers.has(providerId);
-	}
-
-	hasModel(providerId: string, modelId: string): boolean {
-		return this.providers.get(providerId)?.models.has(modelId) ?? false;
-	}
-
-	private require(providerId: string): ConfiguredProviderRecord {
-		const provider = this.providers.get(providerId);
-		if (!provider) {
-			throw new Error(
-				`Provider "${providerId}" is not configured in this SDK instance.`,
-			);
-		}
-		return provider;
-	}
-}

package/src/llms/handler-factory.ts

@@ -1,56 +0,0 @@
-/**
- * Build a concrete `LlmsProviders.ApiHandler` from an `AgentConfig`.
- *
- * @see PLAN.md §3.1 — moved from `packages/agents/src/utils/config-helpers.ts` lines 15–55.
- * @see PLAN.md §3.2.1 — `AgentConfig → AgentRuntimeConfig` mapping for
- *                      the `model` field.
- *
- * Pure port. Core calls this once per session (and again on
- * `updateConnection`) to produce the `AgentModel` adapter handed to
- * `new AgentRuntime({ model, ... })`.
- */
-
-import * as LlmsProviders from "@clinebot/llms";
-import type { AgentConfig, BasicLogger } from "@clinebot/shared";
-
-export function resolveKnownModelsFromConfig(
-	config: AgentConfig,
-): Record<string, LlmsProviders.ModelInfo> | undefined {
-	const pc = config.providerConfig as LlmsProviders.ProviderConfig | undefined;
-	if (pc?.knownModels) {
-		return pc.knownModels;
-	}
-	if (config.knownModels) {
-		return config.knownModels;
-	}
-	return (
-		LlmsProviders.MODEL_COLLECTIONS_BY_PROVIDER_ID[config.providerId]?.models ??
-		undefined
-	);
-}
-
-export function createHandlerFromConfig(
-	config: AgentConfig,
-	logger: BasicLogger | undefined,
-): LlmsProviders.ApiHandler {
-	const pc = config.providerConfig as LlmsProviders.ProviderConfig | undefined;
-	const baseProviderConfig =
-		pc?.providerId === config.providerId ? pc : undefined;
-	const normalizedProviderConfig: LlmsProviders.ProviderConfig = {
-		...(baseProviderConfig ?? {}),
-		providerId: config.providerId,
-		modelId: config.modelId,
-		apiKey: config.apiKey ?? baseProviderConfig?.apiKey,
-		baseUrl: config.baseUrl ?? baseProviderConfig?.baseUrl,
-		headers: config.headers ?? baseProviderConfig?.headers,
-		knownModels: resolveKnownModelsFromConfig(config),
-		maxOutputTokens: config.maxTokensPerTurn,
-		reasoningEffort: config.reasoningEffort,
-		thinkingBudgetTokens: config.thinkingBudgetTokens,
-		thinking: config.thinking,
-		abortSignal: config.abortSignal,
-		logger,
-		extensionContext: config.extensionContext,
-	};
-	return LlmsProviders.createHandler(normalizedProviderConfig);
-}