@clinebot/core 0.0.0 → 0.0.3

package/src/default-tools/model-tool-routing.test.ts

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import {
+	DEFAULT_MODEL_TOOL_ROUTING_RULES,
+	resolveToolRoutingConfig,
+} from "./model-tool-routing.js";
+
+describe("model tool routing", () => {
+	it("applies default codex/gpt routing in act mode", () => {
+		const config = resolveToolRoutingConfig(
+			"openai",
+			"openai/gpt-5.4",
+			"act",
+			DEFAULT_MODEL_TOOL_ROUTING_RULES,
+		);
+
+		expect(config.enableApplyPatch).toBe(true);
+		expect(config.enableEditor).toBe(false);
+	});
+
+	it("does not apply default codex/gpt routing in plan mode", () => {
+		const config = resolveToolRoutingConfig(
+			"openai",
+			"openai/gpt-5.4",
+			"plan",
+			DEFAULT_MODEL_TOOL_ROUTING_RULES,
+		);
+
+		expect(config).toEqual({});
+	});
+
+	it("applies matching custom rules in order", () => {
+		const config = resolveToolRoutingConfig(
+			"anthropic",
+			"claude-sonnet-4-6",
+			"act",
+			[
+				{
+					name: "claude-editor-off",
+					mode: "act",
+					modelIdIncludes: ["claude"],
+					disableTools: ["editor"],
+				},
+				{
+					name: "claude-apply-patch-on",
+					mode: "act",
+					modelIdIncludes: ["claude"],
+					enableTools: ["apply_patch"],
+				},
+			],
+		);
+
+		expect(config.enableEditor).toBe(false);
+		expect(config.enableApplyPatch).toBe(true);
+	});
+
+	it("returns empty config when no rules match", () => {
+		const config = resolveToolRoutingConfig(
+			"anthropic",
+			"claude-sonnet-4-6",
+			"act",
+			[
+				{
+					mode: "act",
+					modelIdIncludes: ["gpt"],
+					enableTools: ["apply_patch"],
+				},
+			],
+		);
+
+		expect(config).toEqual({});
+	});
+
+	it("can match provider-only rules", () => {
+		const config = resolveToolRoutingConfig("openai", "o4-mini", "act", [
+			{
+				mode: "act",
+				providerIdIncludes: ["openai"],
+				enableTools: ["apply_patch"],
+				disableTools: ["editor"],
+			},
+		]);
+
+		expect(config.enableApplyPatch).toBe(true);
+		expect(config.enableEditor).toBe(false);
+	});
+});

package/src/default-tools/model-tool-routing.ts

@@ -0,0 +1,132 @@
+import type { CoreAgentMode } from "../types/config";
+import type { DefaultToolName, DefaultToolsConfig } from "./types.js";
+
+export interface ToolRoutingRule {
+	/**
+	 * Optional rule label for debugging and logs.
+	 */
+	name?: string;
+	/**
+	 * Which mode the rule applies to.
+	 * @default "any"
+	 */
+	mode?: CoreAgentMode | "any";
+	/**
+	 * Case-insensitive substrings that must match the model ID.
+	 * When omitted/empty, the rule is not constrained by model ID.
+	 */
+	modelIdIncludes?: string[];
+	/**
+	 * Case-insensitive substrings that must match the provider ID.
+	 * When omitted/empty, the rule is not constrained by provider ID.
+	 */
+	providerIdIncludes?: string[];
+	/**
+	 * Enable these tools when the rule matches.
+	 */
+	enableTools?: DefaultToolName[];
+	/**
+	 * Disable these tools when the rule matches.
+	 */
+	disableTools?: DefaultToolName[];
+}
+
+const TOOL_NAME_TO_FLAG: Record<
+	DefaultToolName,
+	keyof Pick<
+		DefaultToolsConfig,
+		| "enableReadFiles"
+		| "enableSearch"
+		| "enableBash"
+		| "enableWebFetch"
+		| "enableApplyPatch"
+		| "enableEditor"
+		| "enableSkills"
+		| "enableAskQuestion"
+	>
+> = {
+	read_files: "enableReadFiles",
+	search_codebase: "enableSearch",
+	run_commands: "enableBash",
+	fetch_web_content: "enableWebFetch",
+	apply_patch: "enableApplyPatch",
+	editor: "enableEditor",
+	skills: "enableSkills",
+	ask_question: "enableAskQuestion",
+};
+
+export const DEFAULT_MODEL_TOOL_ROUTING_RULES: ToolRoutingRule[] = [
+	{
+		name: "openai-native-use-apply-patch",
+		mode: "act",
+		providerIdIncludes: ["openai-native"],
+		enableTools: ["apply_patch"],
+		disableTools: ["editor"],
+	},
+	{
+		name: "codex-and-gpt-use-apply-patch",
+		mode: "act",
+		modelIdIncludes: ["codex", "gpt"],
+		enableTools: ["apply_patch"],
+		disableTools: ["editor"],
+	},
+];
+
+function matchesModelId(
+	modelId: string,
+	includes: string[] | undefined,
+): boolean {
+	if (!includes || includes.length === 0) {
+		return true;
+	}
+	const normalizedModelId = modelId.toLowerCase();
+	return includes.some((value) =>
+		normalizedModelId.includes(value.toLowerCase()),
+	);
+}
+
+function matchesRule(
+	rule: ToolRoutingRule,
+	providerId: string,
+	modelId: string,
+	mode: CoreAgentMode,
+): boolean {
+	if (rule.mode && rule.mode !== "any" && rule.mode !== mode) {
+		return false;
+	}
+	return (
+		matchesModelId(providerId, rule.providerIdIncludes) &&
+		matchesModelId(modelId, rule.modelIdIncludes)
+	);
+}
+
+export function resolveToolRoutingConfig(
+	providerId: string,
+	modelId: string,
+	mode: CoreAgentMode,
+	rules: ToolRoutingRule[] | undefined,
+): Partial<DefaultToolsConfig> {
+	if (!rules || rules.length === 0) {
+		return {};
+	}
+
+	const toggles = new Map<DefaultToolName, boolean>();
+
+	for (const rule of rules) {
+		if (!matchesRule(rule, providerId, modelId, mode)) {
+			continue;
+		}
+		for (const toolName of rule.disableTools ?? []) {
+			toggles.set(toolName, false);
+		}
+		for (const toolName of rule.enableTools ?? []) {
+			toggles.set(toolName, true);
+		}
+	}
+
+	const config: Partial<DefaultToolsConfig> = {};
+	for (const [toolName, enabled] of toggles.entries()) {
+		config[TOOL_NAME_TO_FLAG[toolName]] = enabled;
+	}
+	return config;
+}

package/src/default-tools/schemas.ts

@@ -18,8 +18,16 @@ const AbsolutePath = z
  * Schema for read_files tool input
  */
 export const ReadFilesInputSchema = z.object({
-	file_paths: z.array(AbsolutePath).describe("Array of absolute file paths"),
+	file_paths: z
+		.array(AbsolutePath)
+		.describe(
+			"Array of absolute file paths to get full content from. Prefer this tool over running terminal command to get file content for better performance and reliability.",
+		),
 });
+
+/**
+ * Union schema for read_files tool input, allowing either a single string, an array of strings, or the full object schema
+ */
 export const ReadFilesInputUnionSchema = z.union([
 	ReadFilesInputSchema,
 	z.array(z.string()),
@@ -42,8 +50,12 @@ const CommandInputSchema = z.string();
 export const RunCommandsInputSchema = z.object({
 	commands: z
 		.array(CommandInputSchema)
-		.describe("Array of shell commands to execute"),
+		.describe("Array of shell commands to execute."),
 });
+
+/**
+ * Union schema for run_commands tool input. More flexible.
+ */
 export const RunCommandsInputUnionSchema = z.union([
 	RunCommandsInputSchema,
 	z.array(CommandInputSchema),
@@ -54,7 +66,7 @@ export const RunCommandsInputUnionSchema = z.union([
  * Schema for a single web fetch request
  */
 export const WebFetchRequestSchema = z.object({
-	url: z.url().describe("The URL to fetch"),
+	url: z.string().describe("The URL to fetch"),
 	prompt: z.string().min(2).describe("Analysis prompt for the fetched content"),
 });
 
@@ -64,7 +76,7 @@ export const WebFetchRequestSchema = z.object({
 export const FetchWebContentInputSchema = z.object({
 	requests: z
 		.array(WebFetchRequestSchema)
-		.describe("Array of web fetch requests"),
+		.describe("Array of the URLs for the web fetch requests"),
 });
 
 /**
@@ -74,62 +86,43 @@ export const EditFileInputSchema = z
 	.object({
 		command: z
 			.enum(["create", "str_replace", "insert"])
-			.describe(
-				"Editor command to execute: create, str_replace, insert, or undo_edit",
-			),
+			.describe("Editor command to execute: create, str_replace, insert"),
 		path: z.string().min(1).describe("Absolute file path"),
 		file_text: z
 			.string()
-			.optional()
-			.describe("Full file content used with create"),
+			.nullish()
+			.describe("Full file content required for 'create' command"),
 		old_str: z
 			.string()
-			.optional()
-			.describe("Exact text to replace (must match exactly once)"),
-		new_str: z.string().optional().describe("Replacement or inserted text"),
+			.nullish()
+			.describe(
+				"Exact text to replace (must match exactly once) for 'str_replace' command",
+			),
+		new_str: z
+			.string()
+			.nullish()
+			.describe("Replacement text for 'str_replace' or 'insert' commands"),
 		insert_line: z
 			.number()
 			.int()
-			.optional()
-			.describe("Zero-based line index for insert"),
+			.nullish()
+			.describe("Optional one-based line index for 'insert' command"),
 	})
-	.superRefine((value, ctx) => {
-		switch (value.command) {
-			case "create":
-				if (value.file_text === undefined) {
-					ctx.addIssue({
-						code: z.ZodIssueCode.custom,
-						path: ["file_text"],
-						message: "file_text is required for command=create",
-					});
-				}
-				break;
-			case "str_replace":
-				if (value.old_str === undefined) {
-					ctx.addIssue({
-						code: z.ZodIssueCode.custom,
-						path: ["old_str"],
-						message: "old_str is required for command=str_replace",
-					});
-				}
-				break;
-			case "insert":
-				if (value.insert_line === undefined) {
-					ctx.addIssue({
-						code: z.ZodIssueCode.custom,
-						path: ["insert_line"],
-						message: "insert_line is required for command=insert",
-					});
-				}
-				if (value.new_str === undefined) {
-					ctx.addIssue({
-						code: z.ZodIssueCode.custom,
-						path: ["new_str"],
-						message: "new_str is required for command=insert",
-					});
-				}
-				break;
-		}
+	.refine((v) => v.command !== "create" || v.file_text != null, {
+		path: ["file_text"],
+		message: "file_text is required for command=create",
+	})
+	.refine((v) => v.command !== "str_replace" || v.old_str != null, {
+		path: ["old_str"],
+		message: "old_str is required for command=str_replace",
+	})
+	.refine((v) => v.command !== "insert" || v.insert_line != null, {
+		path: ["insert_line"],
+		message: "insert_line is required for command=insert",
+	})
+	.refine((v) => v.command !== "insert" || v.new_str != null, {
+		path: ["new_str"],
+		message: "new_str is required for command=insert",
 	});
 
 /**
@@ -156,7 +149,11 @@ export const SkillsInputSchema = z.object({
 		.describe(
 			'The skill name. E.g., "commit", "review-pr", "pdf", or "ms-office-suite:pdf"',
 		),
-	args: z.string().optional().describe("Optional arguments for the skill"),
+	args: z
+		.string()
+		.nullable()
+		.optional()
+		.describe("Arguments for the skill; use null when omitted"),
 });
 
 /**

package/src/index.browser.ts

@@ -0,0 +1 @@
+export * from "./index";

package/src/{server/index.ts → index.node.ts}

@@ -1,25 +1,3 @@
-/**
- * @clinebot/core/server
- *
- * Node/runtime services for host applications (CLI, desktop runtime, servers).
- */
-
-export {
-	type ClineAccountBalance,
-	type ClineAccountOperations,
-	type ClineAccountOrganization,
-	type ClineAccountOrganizationBalance,
-	type ClineAccountOrganizationUsageTransaction,
-	type ClineAccountPaymentTransaction,
-	ClineAccountService,
-	type ClineAccountServiceOptions,
-	type ClineAccountUsageTransaction,
-	type ClineAccountUser,
-	executeRpcClineAccountAction,
-	isRpcClineAccountActionRequest,
-	RpcClineAccountService,
-	type RpcProviderActionExecutor,
-} from "../account";
 export type {
 	AgentConfigWatcher,
 	AgentConfigWatcherEvent,
@@ -49,7 +27,7 @@ export type {
 	UserInstructionConfigWatcher,
 	UserInstructionConfigWatcherEvent,
 	WorkflowConfig,
-} from "../agents";
+} from "./agents";
 export {
 	createAgentConfigDefinition,
 	createAgentConfigWatcher,
@@ -86,17 +64,17 @@ export {
 	toPartialAgentConfig,
 	UnifiedConfigFileWatcher,
 	WORKFLOWS_CONFIG_DIRECTORY_NAME,
-} from "../agents";
+} from "./agents";
 export {
 	createOAuthClientCallbacks,
 	type OAuthClientCallbacksOptions,
-} from "../auth/client";
+} from "./auth/client";
 export {
 	createClineOAuthProvider,
 	getValidClineCredentials,
 	loginClineOAuth,
 	refreshClineToken,
-} from "../auth/cline";
+} from "./auth/cline";
 export {
 	getValidOpenAICodexCredentials,
 	isOpenAICodexTokenExpired,
@@ -104,7 +82,7 @@ export {
 	normalizeOpenAICodexCredentials,
 	openaiCodexOAuthProvider,
 	refreshOpenAICodexToken,
-} from "../auth/codex";
+} from "./auth/codex";
 export {
 	createOcaOAuthProvider,
 	createOcaRequestHeaders,
@@ -121,8 +99,8 @@ export {
 	loginOcaOAuth,
 	OCI_HEADER_OPC_REQUEST_ID,
 	refreshOcaToken,
-} from "../auth/oca";
-export { startLocalOAuthServer } from "../auth/server";
+} from "./auth/oca";
+export { startLocalOAuthServer } from "./auth/server";
 export type {
 	OAuthCredentials,
 	OAuthLoginCallbacks,
@@ -134,127 +112,100 @@ export type {
 	OcaOAuthEnvironmentConfig,
 	OcaOAuthProviderOptions,
 	OcaTokenResolution,
-} from "../auth/types";
-export {
-	ALL_DEFAULT_TOOL_NAMES,
-	type AskQuestionExecutor,
-	type CreateBuiltinToolsOptions,
-	type CreateDefaultToolsOptions,
-	createBuiltinTools,
-	createDefaultExecutors,
-	createDefaultTools,
-	createDefaultToolsWithPreset,
-	createToolPoliciesWithPreset,
-	type DefaultExecutorsOptions,
-	type DefaultToolName,
-	DefaultToolNames,
-	type DefaultToolsConfig,
-	type ToolExecutors,
-	type ToolPolicyPresetName,
-	type ToolPresetName,
-	ToolPresets,
-} from "../default-tools";
+} from "./auth/types";
+export * from "./index";
 export type {
 	FastFileIndexOptions,
 	MentionEnricherOptions,
 	MentionEnrichmentResult,
-} from "../input";
+} from "./input";
 export {
 	enrichPromptWithMentions,
 	getFileIndex,
 	prewarmFileIndex,
-} from "../input";
-
-export type {
-	LoadMcpSettingsOptions,
-	McpConnectionStatus,
-	McpManager,
-	McpManagerOptions,
-	McpServerClient,
-	McpServerClientFactory,
-	McpServerRegistration,
-	McpServerSnapshot,
-	McpServerTransportConfig,
-	McpSettingsFile,
-	McpSseTransportConfig,
-	McpStdioTransportConfig,
-	McpStreamableHttpTransportConfig,
-	RegisterMcpServersFromSettingsOptions,
-} from "../mcp";
-export {
-	hasMcpSettingsFile,
-	InMemoryMcpManager,
-	loadMcpSettingsFile,
-	registerMcpServersFromSettingsFile,
-	resolveDefaultMcpSettingsPath,
-	resolveMcpServerRegistrations,
-} from "../mcp";
+} from "./input";
+export {
+	addLocalProvider,
+	ensureCustomProvidersLoaded,
+	getLocalProviderModels,
+	listLocalProviders,
+	loginLocalProvider,
+	normalizeOAuthProvider,
+	resolveLocalClineAuthToken,
+	saveLocalProviderOAuthCredentials,
+	saveLocalProviderSettings,
+} from "./providers/local-provider-service";
 export {
 	formatRulesForSystemPrompt,
 	isRuleEnabled,
 	listEnabledRulesFromWatcher,
 	loadRulesForSystemPromptFromWatcher,
-} from "../runtime/rules";
+} from "./runtime/rules";
 export {
 	createTeamName,
 	DefaultRuntimeBuilder,
-} from "../runtime/runtime-builder";
+} from "./runtime/runtime-builder";
 export {
 	type SandboxCallOptions,
 	SubprocessSandbox,
 	type SubprocessSandboxOptions,
-} from "../runtime/sandbox/subprocess-sandbox";
+} from "./runtime/sandbox/subprocess-sandbox";
 export type {
 	BuiltRuntime,
 	RuntimeBuilder,
 	RuntimeBuilderInput,
 	SessionRuntime,
-} from "../runtime/session-runtime";
+} from "./runtime/session-runtime";
 export {
 	type DesktopToolApprovalOptions,
 	requestDesktopToolApproval,
-} from "../runtime/tool-approval";
-export type { AvailableWorkflow } from "../runtime/workflows";
+} from "./runtime/tool-approval";
+export type { AvailableWorkflow } from "./runtime/workflows";
 export {
 	listAvailableWorkflowsFromWatcher,
 	resolveWorkflowSlashCommandFromWatcher,
-} from "../runtime/workflows";
-export { DefaultSessionManager } from "../session/default-session-manager";
-export { RpcCoreSessionService } from "../session/rpc-session-service";
+} from "./runtime/workflows";
+export { DefaultSessionManager } from "./session/default-session-manager";
+export { RpcCoreSessionService } from "./session/rpc-session-service";
 export {
 	deriveSubsessionStatus,
 	makeSubSessionId,
 	makeTeamTaskSubSessionId,
 	sanitizeSessionToken,
-} from "../session/session-graph";
+} from "./session/session-graph";
 export type {
 	CreateSessionHostOptions,
+	SessionBackend,
 	SessionHost,
-} from "../session/session-host";
-export { createSessionHost } from "../session/session-host";
+} from "./session/session-host";
+export {
+	createSessionHost,
+	resolveSessionBackend,
+} from "./session/session-host";
 export type {
 	SendSessionInput,
+	SessionAccumulatedUsage,
 	SessionManager,
 	StartSessionInput,
 	StartSessionResult,
-} from "../session/session-manager";
-export type { SessionManifest } from "../session/session-manifest";
+} from "./session/session-manager";
+export type { SessionManifest } from "./session/session-manifest";
 export type {
 	CreateRootSessionWithArtifactsInput,
 	RootSessionArtifacts,
-} from "../session/session-service";
-export { CoreSessionService } from "../session/session-service";
+} from "./session/session-service";
+export { CoreSessionService } from "./session/session-service";
 export {
 	createSqliteRpcSessionBackend,
 	SqliteRpcSessionBackend,
 	type SqliteRpcSessionBackendOptions,
-} from "../session/sqlite-rpc-session-backend";
+} from "./session/sqlite-rpc-session-backend";
 export type {
 	WorkspaceManager,
 	WorkspaceManagerEvent,
-} from "../session/workspace-manager";
-export { InMemoryWorkspaceManager } from "../session/workspace-manager";
-export type { WorkspaceManifest } from "../session/workspace-manifest";
+} from "./session/workspace-manager";
+export { InMemoryWorkspaceManager } from "./session/workspace-manager";
+export type { WorkspaceManifest } from "./session/workspace-manifest";
 export {
 	buildWorkspaceMetadata,
 	emptyWorkspaceManifest,
@@ -263,20 +214,11 @@ export {
 	upsertWorkspaceInfo,
 	WorkspaceInfoSchema,
 	WorkspaceManifestSchema,
-} from "../session/workspace-manifest";
+} from "./session/workspace-manifest";
 export {
 	type MigrateLegacyProviderSettingsOptions,
 	type MigrateLegacyProviderSettingsResult,
 	migrateLegacyProviderSettings,
-} from "../storage/provider-settings-legacy-migration";
-export { ProviderSettingsManager } from "../storage/provider-settings-manager";
-export { SqliteSessionStore } from "../storage/sqlite-session-store";
-export type { SessionStatus } from "../types/common";
-export { SESSION_STATUSES, SessionSource } from "../types/common";
-export type {
-	CoreAgentMode,
-	CoreModelConfig,
-	CoreRuntimeFeatures,
-	CoreSessionConfig,
-} from "../types/config";
-export type { WorkspaceInfo } from "../types/workspace";
+} from "./storage/provider-settings-legacy-migration";
+export { ProviderSettingsManager } from "./storage/provider-settings-manager";
+export { SqliteSessionStore } from "./storage/sqlite-session-store";