@clinebot/core 0.0.35 → 0.0.36

package/src/index.ts

@@ -7,6 +7,7 @@
 export * as Llms from "@clinebot/llms";
 // Shared contracts and path helpers re-exported for app consumers.
 export type {
+	AddProviderActionRequest,
 	AgentConfig,
 	AgentEvent,
 	AgentExtension,
@@ -15,34 +16,35 @@ export type {
 	AgentMode,
 	AgentResult,
 	BasicLogger,
+	ChatRunTurnRequest,
+	ChatRuntimeConfig,
+	ChatStartSessionArtifacts,
+	ChatStartSessionRequest,
+	ChatTurnResult,
+	ClineAccountActionRequest,
 	ConnectorHookEvent,
+	EnterpriseAuthenticateRequest,
+	EnterpriseAuthenticateResponse,
+	EnterpriseStatusRequest,
+	EnterpriseStatusResponse,
+	EnterpriseSyncRequest,
+	EnterpriseSyncResponse,
 	emptyWorkspaceManifest,
+	GetProviderModelsActionRequest,
 	HookSessionContext,
 	ITelemetryService,
-	RpcAddProviderActionRequest,
-	RpcChatMessage,
-	RpcChatRunTurnRequest,
-	RpcChatRuntimeConfigBase,
-	RpcChatRuntimeLoggerConfig,
-	RpcChatStartSessionArtifacts,
-	RpcChatStartSessionRequest,
-	RpcChatTurnResult,
-	RpcClineAccountActionRequest,
-	RpcEnterpriseAuthenticateRequest,
-	RpcEnterpriseAuthenticateResponse,
-	RpcEnterpriseStatusRequest,
-	RpcEnterpriseStatusResponse,
-	RpcEnterpriseSyncRequest,
-	RpcEnterpriseSyncResponse,
-	RpcOAuthProviderId,
-	RpcProviderActionRequest,
-	RpcProviderCapability,
-	RpcProviderCatalogResponse,
-	RpcProviderListItem,
-	RpcProviderModel,
-	RpcProviderOAuthLoginResponse,
-	RpcSaveProviderSettingsActionRequest,
+	ListProvidersActionRequest,
+	OAuthProviderId,
+	ProviderActionRequest,
+	ProviderCatalogResponse,
+	ProviderListItem,
+	ProviderModel,
+	ProviderOAuthLoginResponse,
+	RuntimeLoggerConfig,
+	SaveProviderSettingsActionRequest,
 	SessionLineage,
+	TEAM_LIFECYCLE_EVENT_TYPE,
+	TEAM_PROGRESS_EVENT_TYPE,
 	TeamProgressProjectionEvent,
 	TelemetryArray,
 	TelemetryMetadata,
@@ -69,8 +71,6 @@ export {
 	noopBasicLogger,
 	normalizeUserInput,
 	parseUserCommandEnvelope,
-	RPC_TEAM_LIFECYCLE_EVENT_TYPE,
-	RPC_TEAM_PROGRESS_EVENT_TYPE,
 } from "@clinebot/shared";
 export * from "@clinebot/shared/storage";
 export {
@@ -85,11 +85,11 @@ export {
 	type ClineAccountUsageTransaction,
 	type ClineAccountUser,
 	type ClineOrganization,
-	executeRpcClineAccountAction,
+	executeClineAccountAction,
 	type FeaturebaseTokenResponse,
-	isRpcClineAccountActionRequest,
+	isClineAccountActionRequest,
+	type ProviderActionExecutor,
 	RpcClineAccountService,
-	type RpcProviderActionExecutor,
 	type UserRemoteConfigOrganization,
 	type UserRemoteConfigResponse,
 } from "./account";
@@ -154,8 +154,10 @@ export {
 	ClineCore,
 	type ClineCoreOptions,
 	type ClineCoreStartInput,
-	type RpcOptions,
+	type HubOptions,
+	type RemoteOptions,
 } from "./ClineCore";
+export * from "./cron";
 export type {
 	LoadAgentPluginFromPathOptions,
 	PluginInitializationFailure,
@@ -296,16 +298,11 @@ export {
 	toTeamProgressLifecycleEvent,
 } from "./extensions/tools/team";
 export {
-	createPersistentSubprocessHooks,
 	createSubprocessHooks,
 	type HookEventName,
 	HookEventNameSchema,
 	type HookEventPayload,
 	HookEventPayloadSchema,
-	PersistentHookClient,
-	type PersistentHookClientOptions,
-	type PersistentSubprocessHookControl,
-	type PersistentSubprocessHooksOptions,
 	parseHookEventPayload,
 	type RunHookOptions,
 	type RunHookResult,
@@ -320,41 +317,19 @@ export type {
 	CheckpointEntry,
 	CheckpointMetadata,
 } from "./hooks/checkpoint-hooks";
+export * from "./hub";
 export type { SessionBackend } from "./runtime/host";
 export {
 	createRuntimeHost,
 	createRuntimeHost as createSessionHost,
 	resolveSessionBackend,
 } from "./runtime/host";
-export {
-	clearRpcDiscoveryIfAddressMatches,
-	type EnsureRpcRuntimeOptions,
-	ensureRpcRuntimeAddress,
-	isCompatibleRuntime,
-	type ResolveRpcRuntimeResult,
-	RPC_BUILD_ID_ENV,
-	RPC_DISCOVERY_PATH_ENV,
-	RPC_OWNER_ID_ENV,
-	RPC_STARTUP_LOCK_BYPASS_ENV,
-	type RpcDiscoveryRecord,
-	type RpcOwnerContext,
-	type RpcStartupLockHandle,
-	recordRpcDiscovery,
-	resolveEnsuredRpcRuntime,
-	resolveRpcOwnerContext,
-	resolveRpcRuntimeBuildKey,
-	waitForCompatibleRpcRuntime,
-	withRpcStartupLock,
-} from "./runtime/rpc-runtime-ensure";
-export {
-	type RpcSpawnLease,
-	tryAcquireRpcSpawnLease,
-} from "./runtime/rpc-spawn-lease";
 export {
 	formatRulesForSystemPrompt,
 	isRuleEnabled,
 	listEnabledRulesFromWatcher,
 	loadRulesForSystemPromptFromWatcher,
+	mergeRulesForSystemPrompt,
 } from "./runtime/rules";
 export {
 	createTeamName,
@@ -364,6 +339,7 @@ export type {
 	RuntimeHost,
 	RuntimeHost as SessionHost,
 	RuntimeHostMode,
+	RuntimeHostSubscribeOptions,
 	SendSessionInput,
 	SessionAccumulatedUsage,
 	StartSessionInput,
@@ -375,9 +351,6 @@ export type {
 	RuntimeBuilder,
 	RuntimeBuilderInput,
 	SessionRuntime,
-	TeamToolsFactory,
-	TeamToolsFactoryOptions,
-	TeamToolsFactoryResult,
 } from "./runtime/session-runtime";
 export {
 	type SandboxCallOptions,
@@ -388,6 +361,18 @@ export {
 	type DesktopToolApprovalOptions,
 	requestDesktopToolApproval,
 } from "./runtime/tool-approval";
+export type { GlobalSettings } from "./services/global-settings";
+export {
+	filterDisabledTools,
+	filterExtensionToolRegistrations,
+	isToolDisabledGlobally,
+	readGlobalSettings,
+	resolveDisabledToolNames,
+	toggleDisabledTool,
+	writeGlobalSettings,
+} from "./services/global-settings";
+export type { PluginToolSummary } from "./services/plugin-tools";
+export { listPluginTools } from "./services/plugin-tools";
 export {
 	addLocalProvider,
 	type DeleteLocalProviderRequest,
@@ -474,7 +459,6 @@ export {
 	generateWorkspaceInfo,
 	normalizeWorkspacePath,
 } from "./services/workspace-manifest";
-export { RpcCoreSessionService } from "./session/rpc-session-service";
 export {
 	deriveSubsessionStatus,
 	makeSubSessionId,
@@ -482,24 +466,24 @@ export {
 	sanitizeSessionToken,
 } from "./session/session-graph";
 export type { SessionManifest } from "./session/session-manifest";
+export type { SessionRow } from "./session/session-row";
 export type {
 	CreateRootSessionWithArtifactsInput,
 	RootSessionArtifacts,
-	SessionRow,
 } from "./session/session-service";
 export { CoreSessionService } from "./session/session-service";
 export {
-	createSqliteRpcSessionBackend,
-	SqliteRpcSessionBackend,
-	type SqliteRpcSessionBackendOptions,
-} from "./session/sqlite-rpc-session-backend";
+	FileTeamPersistenceStore,
+	type FileTeamPersistenceStoreOptions,
+} from "./session/team-persistence-store";
 export type {
 	WorkspaceManager,
 	WorkspaceManagerEvent,
 } from "./session/workspace-manager";
 export { InMemoryWorkspaceManager } from "./session/workspace-manager";
+export { HubRuntimeHost } from "./transports/hub";
 export { LocalRuntimeHost } from "./transports/local";
-export { RpcRuntimeHost } from "./transports/rpc";
+export { RemoteRuntimeHost } from "./transports/remote";
 export type {
 	ChatMessage,
 	ChatSessionConfig,
@@ -524,6 +508,7 @@ export { createContextCompactionPrepareTurn } from "./extensions/context/compact
 export {
 	ALL_DEFAULT_TOOL_NAMES,
 	type AskQuestionExecutor,
+	type BuiltinToolAvailabilityContext,
 	type CreateBuiltinToolsOptions,
 	type CreateDefaultToolsOptions,
 	createBuiltinTools,
@@ -535,11 +520,82 @@ export {
 	type DefaultToolName,
 	DefaultToolNames,
 	type DefaultToolsConfig,
+	getCoreAcpToolNames,
+	getCoreBuiltinToolCatalog,
+	getCoreDefaultEnabledToolIds,
+	getCoreHeadlessToolNames,
+	resolveCoreSelectedToolIds,
+	TEAM_TOOL_NAMES,
+	type ToolCatalogEntry,
 	type ToolExecutors,
 	type ToolPolicyPresetName,
 	type ToolPresetName,
 	ToolPresets,
 } from "./extensions/tools";
+export {
+	clearLiveModelsCatalogCache,
+	clearPrivateModelsCatalogCache,
+	DEFAULT_MODELS_CATALOG_URL,
+	getLiveModelsCatalog,
+	getProviderConfig,
+	OPENAI_COMPATIBLE_PROVIDERS,
+	resolveProviderConfig,
+} from "./llms/provider-defaults";
+export type {
+	AuthSettings,
+	AwsSettings,
+	AzureSettings,
+	BuiltInProviderId,
+	GcpSettings,
+	ModelCatalogConfig,
+	ModelCatalogSettings,
+	OcaSettings,
+	ProviderCapability,
+	ProviderConfig,
+	ProviderDefaultsConfig,
+	ProviderId,
+	ProviderSettings,
+	ReasoningSettings,
+	SapSettings,
+} from "./llms/provider-settings";
+export {
+	AuthSettingsSchema,
+	AwsSettingsSchema,
+	AzureSettingsSchema,
+	BUILT_IN_PROVIDER,
+	BUILT_IN_PROVIDER_IDS,
+	createProviderConfig,
+	GcpSettingsSchema,
+	isBuiltInProviderId,
+	ModelCatalogSettingsSchema,
+	normalizeProviderId,
+	OcaSettingsSchema,
+	ProviderIdSchema,
+	ProviderSettingsSchema,
+	parseSettings,
+	ReasoningSettingsSchema,
+	SapSettingsSchema,
+	safeCreateProviderConfig,
+	safeParseSettings,
+	toProviderConfig,
+} from "./llms/provider-settings";
+export {
+	defineLlmsConfig,
+	loadLlmsConfigFromFile,
+} from "./llms/runtime-config";
+export { createLlmsSdk, DefaultLlmsSdk } from "./llms/runtime-registry";
+export type {
+	BuiltInProviderSummary,
+	CreateHandlerInput,
+	LlmsConfig,
+	LlmsSdk,
+	ProviderConfigDefaults,
+	ProviderSelectionConfig,
+	RegisterBuiltinProviderInput,
+	RegisteredProviderSummary,
+	RegisterModelInput,
+	RegisterProviderInput,
+} from "./llms/runtime-types";
 export {
 	TelemetryService,
 	type TelemetryServiceOptions,

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

@@ -0,0 +1,193 @@
+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;
+	}
+}