@clinebot/core 0.0.35 → 0.0.37

package/src/hub/workspace.ts

@@ -0,0 +1,19 @@
+import { normalizeWorkspacePath } from "../services/workspace-manifest";
+import { type HubOwnerContext, resolveHubOwnerContext } from "./discovery";
+
+const DEFAULT_SHARED_HUB_OWNER_LABEL = "shared:cline";
+
+export function resolveWorkspaceHubOwnerContext(
+	workspaceRoot: string,
+): HubOwnerContext {
+	const normalized = normalizeWorkspacePath(workspaceRoot.trim());
+	return resolveHubOwnerContext(
+		`workspace:${normalized || workspaceRoot.trim()}`,
+	);
+}
+
+export function resolveSharedHubOwnerContext(
+	label = DEFAULT_SHARED_HUB_OWNER_LABEL,
+): HubOwnerContext {
+	return resolveHubOwnerContext(label);
+}

package/src/index.ts

@@ -7,42 +7,54 @@
 export * as Llms from "@clinebot/llms";
 // Shared contracts and path helpers re-exported for app consumers.
 export type {
+	AddProviderActionRequest,
 	AgentConfig,
 	AgentEvent,
 	AgentExtension,
+	AgentExtension as AgentPlugin, // Public-facing alias for extensions
 	AgentExtensionCommand,
+	AgentExtensionCommand as AgentPluginCommand,
 	AgentHooks,
 	AgentMode,
 	AgentResult,
+	AgentRunResult,
+	AgentRunStatus,
+	AutomationEventEnvelope,
 	BasicLogger,
+	ChatRunTurnRequest,
+	ChatRuntimeConfig,
+	ChatStartSessionArtifacts,
+	ChatStartSessionRequest,
+	ChatTurnResult,
+	ClineAccountActionRequest,
 	ConnectorHookEvent,
+	ContentBlock,
+	EnterpriseAuthenticateRequest,
+	EnterpriseAuthenticateResponse,
+	EnterpriseStatusRequest,
+	EnterpriseStatusResponse,
+	EnterpriseSyncRequest,
+	EnterpriseSyncResponse,
 	emptyWorkspaceManifest,
+	FileContent,
+	GetProviderModelsActionRequest,
 	HookSessionContext,
+	ImageContent,
 	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,
+	Message,
+	MessageWithMetadata,
+	OAuthProviderId,
+	ProviderActionRequest,
+	ProviderCatalogResponse,
+	ProviderListItem,
+	ProviderModel,
+	ProviderOAuthLoginResponse,
+	RuntimeLoggerConfig,
+	SaveProviderSettingsActionRequest,
 	SessionLineage,
+	TEAM_LIFECYCLE_EVENT_TYPE,
+	TEAM_PROGRESS_EVENT_TYPE,
 	TeamProgressProjectionEvent,
 	TelemetryArray,
 	TelemetryMetadata,
@@ -50,11 +62,15 @@ export type {
 	TelemetryPrimitive,
 	TelemetryProperties,
 	TelemetryValue,
+	TextContent,
+	ThinkingContent,
 	Tool,
 	ToolApprovalRequest,
 	ToolApprovalResult,
 	ToolContext,
 	ToolPolicy,
+	ToolResultContent,
+	ToolUseContent,
 	WorkspaceInfo,
 	WorkspaceInfoSchema,
 	WorkspaceManifest,
@@ -69,8 +85,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 +99,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";
@@ -151,10 +165,23 @@ export type {
 	OcaTokenResolution,
 } from "./auth/types";
 export {
+	type ClineAutomationEventIngressResult,
+	type ClineAutomationEventLog,
+	type ClineAutomationEventSuppression,
+	type ClineAutomationListEventsOptions,
+	type ClineAutomationListRunsOptions,
+	type ClineAutomationListSpecsOptions,
+	type ClineAutomationRun,
+	type ClineAutomationRunStatus,
+	type ClineAutomationSpec,
 	ClineCore,
+	type ClineCoreAutomationApi,
+	type ClineCoreAutomationOptions,
+	type ClineCoreListHistoryOptions,
 	type ClineCoreOptions,
 	type ClineCoreStartInput,
-	type RpcOptions,
+	type HubOptions,
+	type RemoteOptions,
 } from "./ClineCore";
 export type {
 	LoadAgentPluginFromPathOptions,
@@ -296,16 +323,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,50 +342,34 @@ 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,
 	DefaultRuntimeBuilder,
 } from "./runtime/runtime-builder";
 export type {
+	PendingPromptMutationResult,
+	PendingPromptsAction,
+	PendingPromptsDeleteInput,
+	PendingPromptsListInput,
+	PendingPromptsUpdateInput,
 	RuntimeHost,
 	RuntimeHost as SessionHost,
 	RuntimeHostMode,
+	RuntimeHostSubscribeOptions,
 	SendSessionInput,
 	SessionAccumulatedUsage,
 	StartSessionInput,
@@ -375,9 +381,6 @@ export type {
 	RuntimeBuilder,
 	RuntimeBuilderInput,
 	SessionRuntime,
-	TeamToolsFactory,
-	TeamToolsFactoryOptions,
-	TeamToolsFactoryResult,
 } from "./runtime/session-runtime";
 export {
 	type SandboxCallOptions,
@@ -388,6 +391,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 +489,6 @@ export {
 	generateWorkspaceInfo,
 	normalizeWorkspacePath,
 } from "./services/workspace-manifest";
-export { RpcCoreSessionService } from "./session/rpc-session-service";
 export {
 	deriveSubsessionStatus,
 	makeSubSessionId,
@@ -482,24 +496,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,
@@ -520,10 +534,12 @@ export { CORE_BUILD_VERSION } from "./version";
 export async function loadOpenTelemetryAdapter() {
 	return import("./services/telemetry/index.js");
 }
+export { Agent, createAgentRuntime } from "@clinebot/agents";
 export { createContextCompactionPrepareTurn } from "./extensions/context/compaction";
 export {
 	ALL_DEFAULT_TOOL_NAMES,
 	type AskQuestionExecutor,
+	type BuiltinToolAvailabilityContext,
 	type CreateBuiltinToolsOptions,
 	type CreateDefaultToolsOptions,
 	createBuiltinTools,
@@ -535,11 +551,93 @@ 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 {
+	type ClineRecommendedModel,
+	type ClineRecommendedModelsData,
+	FALLBACK_CLINE_RECOMMENDED_MODELS,
+	type FetchClineRecommendedModelsOptions,
+	fetchClineRecommendedModels,
+} from "./llms/cline-recommended-models";
+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,
+	ProviderClient,
+	ProviderConfig,
+	ProviderDefaultsConfig,
+	ProviderId,
+	ProviderProtocol,
+	ProviderSettings,
+	ReasoningSettings,
+	SapSettings,
+} from "./llms/provider-settings";
+export {
+	AuthSettingsSchema,
+	AwsSettingsSchema,
+	AzureSettingsSchema,
+	BUILT_IN_PROVIDER,
+	BUILT_IN_PROVIDER_IDS,
+	createProviderConfig,
+	GcpSettingsSchema,
+	isBuiltInProviderId,
+	ModelCatalogSettingsSchema,
+	normalizeProviderId,
+	OcaSettingsSchema,
+	ProviderClientSchema,
+	ProviderIdSchema,
+	ProviderProtocolSchema,
+	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,
@@ -565,6 +663,9 @@ export type {
 	CoreSessionEvent,
 	SessionChunkEvent,
 	SessionEndedEvent,
+	SessionPendingPrompt,
+	SessionPendingPromptSubmittedEvent,
+	SessionPendingPromptsEvent,
 	SessionTeamProgressEvent,
 	SessionToolEvent,
 } from "./types/events";

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

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