@clinebot/core 0.0.37 → 0.0.38

package/src/extensions/tools/helpers.ts

@@ -1,154 +0,0 @@
-import { validateWithZod } from "@clinebot/shared";
-import {
-	type EditFileInput,
-	INPUT_ARG_CHAR_LIMIT,
-	type ReadFileRequest,
-	ReadFilesInputUnionSchema,
-	type StructuredCommandInput,
-	StructuredCommandsInputUnionSchema,
-} from "./schemas";
-
-/**
- * Format an error into a string message
- */
-export function formatError(error: unknown): string {
-	if (error instanceof Error) {
-		return error.message;
-	}
-	return String(error);
-}
-
-export function getEditorSizeError(input: EditFileInput): string | null {
-	if (
-		typeof input.old_text === "string" &&
-		input.old_text.length > INPUT_ARG_CHAR_LIMIT
-	) {
-		return `Editor input too large: old_text was ${input.old_text.length} characters, exceeding the recommended limit of ${INPUT_ARG_CHAR_LIMIT}. Split the edit into smaller tool calls so later tool calls are less likely to be truncated or time out.`;
-	}
-
-	if (input.new_text.length > INPUT_ARG_CHAR_LIMIT) {
-		return `Editor input too large: new_text was ${input.new_text.length} characters, exceeding the recommended limit of ${INPUT_ARG_CHAR_LIMIT}. Split the edit into smaller tool calls so later tool calls are less likely to be truncated or time out.`;
-	}
-
-	return null;
-}
-
-/**
- * Create a timeout-wrapped promise
- */
-export function withTimeout<T>(
-	promise: Promise<T>,
-	ms: number,
-	message: string,
-): Promise<T> {
-	return Promise.race([
-		promise,
-		new Promise<never>((_, reject) => {
-			setTimeout(() => reject(new Error(message)), ms);
-		}),
-	]);
-}
-
-export function normalizeReadFileRequests(input: unknown): ReadFileRequest[] {
-	const validate = validateWithZod(ReadFilesInputUnionSchema, input);
-
-	if (typeof validate === "string") {
-		return [{ path: validate }];
-	}
-
-	if (Array.isArray(validate)) {
-		return validate.map((value) =>
-			typeof value === "string" ? { path: value } : value,
-		);
-	}
-
-	if ("files" in validate) {
-		const files = Array.isArray(validate.files)
-			? validate.files
-			: [validate.files];
-		return files;
-	}
-
-	if ("file_paths" in validate) {
-		const filePaths = Array.isArray(validate.file_paths)
-			? validate.file_paths
-			: [validate.file_paths];
-		return filePaths.map((filePath) => ({ path: filePath }));
-	}
-
-	if ("paths" in validate) {
-		const paths = Array.isArray(validate.paths)
-			? validate.paths
-			: [validate.paths];
-		return paths.map((path) => (typeof path === "string" ? { path } : path));
-	}
-
-	return [validate];
-}
-
-export function formatReadFileQuery(request: ReadFileRequest): string {
-	const { path, start_line, end_line } = request;
-	if (start_line == null && end_line == null) {
-		return path;
-	}
-	const start = start_line ?? 1;
-	const end = end_line ?? "EOF";
-	return `${path}:${start}-${end}`;
-}
-
-export function getReadFileRangeError(request: ReadFileRequest): string | null {
-	const { start_line, end_line } = request;
-	if (start_line == null || end_line == null || start_line <= end_line) {
-		return null;
-	}
-
-	return `start_line must be less than or equal to end_line (received start_line: ${start_line}, end_line: ${end_line})`;
-}
-
-export function normalizeRunCommandsInput(
-	input: unknown,
-): Array<string | StructuredCommandInput> {
-	const validate = validateWithZod(StructuredCommandsInputUnionSchema, input);
-
-	if (typeof validate === "string") {
-		return [validate];
-	}
-
-	if (Array.isArray(validate)) {
-		return validate;
-	}
-
-	if ("commands" in validate) {
-		return Array.isArray(validate.commands)
-			? validate.commands
-			: [validate.commands];
-	}
-
-	if ("command" in validate) {
-		return "args" in validate ? [validate] : [validate.command];
-	}
-
-	if ("cmd" in validate) {
-		return [validate.cmd];
-	}
-
-	return [validate];
-}
-
-export function formatRunCommandQuery(
-	command: string | StructuredCommandInput,
-): string {
-	if (typeof command === "string") {
-		return command;
-	}
-
-	const args = command.args ?? [];
-	if (args.length === 0) {
-		return command.command;
-	}
-
-	const renderedArgs = args.map((arg) =>
-		/[\s"]/u.test(arg) ? JSON.stringify(arg) : arg,
-	);
-	return `${command.command} ${renderedArgs.join(" ")}`;
-}

package/src/extensions/tools/index.ts

@@ -1,183 +0,0 @@
-/**
- * Default Tools
- *
- * This module provides a set of configurable default tools for agents.
- */
-
-// Zod Utilities
-export { validateWithZod, zodToJsonSchema } from "@clinebot/shared";
-// Constants
-export { ALL_DEFAULT_TOOL_NAMES, DefaultToolNames } from "./constants";
-// Tool Definitions
-export {
-	createApplyPatchTool,
-	createAskQuestionTool,
-	createBashTool,
-	createDefaultTools,
-	createEditorTool,
-	createReadFilesTool,
-	createSearchTool,
-	createSkillsTool,
-	createSubmitAndExitTool,
-	createWebFetchTool,
-	createWindowsShellTool,
-} from "./definitions";
-// Built-in Executors
-export {
-	type ApplyPatchExecutorOptions,
-	type BashExecutorOptions,
-	createApplyPatchExecutor,
-	createBashExecutor,
-	createDefaultExecutors,
-	createEditorExecutor,
-	createFileReadExecutor,
-	createSearchExecutor,
-	createWebFetchExecutor,
-	type DefaultExecutorsOptions,
-	type EditorExecutorOptions,
-	type FileReadExecutorOptions,
-	type SearchExecutorOptions,
-	type WebFetchExecutorOptions,
-} from "./executors/index";
-export {
-	DEFAULT_MODEL_TOOL_ROUTING_RULES,
-	resolveToolRoutingConfig,
-	type ToolRoutingRule,
-} from "./model-tool-routing";
-// Presets
-export {
-	createDefaultToolsWithPreset,
-	createToolPoliciesWithPreset,
-	resolveToolPresetName,
-	type ToolPolicyPresetName,
-	type ToolPresetName,
-	ToolPresets,
-} from "./presets";
-export {
-	type BuiltinToolAvailabilityContext,
-	getCoreAcpToolNames,
-	getCoreBuiltinToolCatalog,
-	getCoreDefaultEnabledToolIds,
-	getCoreHeadlessToolNames,
-	resolveCoreSelectedToolIds,
-	type ToolCatalogEntry,
-} from "./runtime";
-// Schemas
-export {
-	type ApplyPatchInput,
-	ApplyPatchInputSchema,
-	type AskQuestionInput,
-	AskQuestionInputSchema,
-	type EditFileInput,
-	EditFileInputSchema,
-	type FetchWebContentInput,
-	FetchWebContentInputSchema,
-	type ReadFileRequest,
-	ReadFileRequestSchema,
-	type ReadFilesInput,
-	ReadFilesInputSchema,
-	type RunCommandsInput,
-	RunCommandsInputSchema,
-	type SearchCodebaseInput,
-	SearchCodebaseInputSchema,
-	type SkillsInput,
-	SkillsInputSchema,
-	type SubmitInput,
-	SubmitInputSchema,
-	type WebFetchRequest,
-	WebFetchRequestSchema,
-} from "./schemas";
-export { TEAM_TOOL_NAMES } from "./team/team-tools";
-// Types
-export type {
-	ApplyPatchExecutor,
-	AskQuestionExecutor,
-	BashExecutor,
-	CreateDefaultToolsOptions,
-	DefaultToolName,
-	DefaultToolsConfig,
-	EditorExecutor,
-	FileReadExecutor,
-	SearchExecutor,
-	SkillsExecutor,
-	SkillsExecutorSkillMetadata,
-	SkillsExecutorWithMetadata,
-	ToolExecutors,
-	ToolOperationResult,
-	VerifySubmitExecutor,
-	WebFetchExecutor,
-} from "./types";
-
-// =============================================================================
-// Convenience: Create Tools with Built-in Executors
-// =============================================================================
-
-import type { Tool } from "@clinebot/shared";
-import { createDefaultTools } from "./definitions";
-import {
-	createDefaultExecutors,
-	type DefaultExecutorsOptions,
-} from "./executors/index";
-import type { CreateDefaultToolsOptions, ToolExecutors } from "./types";
-
-/**
- * Options for creating default tools with built-in executors
- */
-export interface CreateBuiltinToolsOptions
-	extends Omit<CreateDefaultToolsOptions, "executors"> {
-	/**
-	 * Configuration for the built-in executors
-	 */
-	executorOptions?: DefaultExecutorsOptions;
-	/**
-	 * Optional executor overrides/additions for tools without built-ins
-	 */
-	executors?: Partial<ToolExecutors>;
-}
-
-/**
- * Create default tools with built-in Node.js executors
- *
- * This is a convenience function that creates the default tools with
- * working implementations using Node.js built-in modules.
- *
- * @example
- * ```typescript
- * import { Agent, createBuiltinTools } from "@clinebot/core"
- *
- * const tools = createBuiltinTools({
- *   cwd: "/path/to/project",
- *   enableBash: true,
- *   enableWebFetch: false, // Disable web fetching
- *   executorOptions: {
- *     bash: { timeoutMs: 60000 },
- *   },
- * })
- *
- * const agent = new Agent({
- *   providerId: "anthropic",
- *   modelId: "claude-sonnet-4-20250514",
- *   systemPrompt: "You are a coding assistant.",
- *   tools,
- * })
- * ```
- */
-export function createBuiltinTools(
-	options: CreateBuiltinToolsOptions = {},
-): Tool[] {
-	const {
-		executorOptions = {},
-		executors: executorOverrides,
-		...toolsConfig
-	} = options;
-
-	const executors = {
-		...createDefaultExecutors(executorOptions),
-		...(executorOverrides ?? {}),
-	};
-
-	return createDefaultTools({
-		...toolsConfig,
-		executors,
-	});
-}

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

@@ -1,134 +0,0 @@
-import type { CoreAgentMode } from "../../types/config";
-import type { DefaultToolName, DefaultToolsConfig } from "./types";
-
-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"
-		| "enableSubmitAndExit"
-	>
-> = {
-	read_files: "enableReadFiles",
-	search_codebase: "enableSearch",
-	run_commands: "enableBash",
-	fetch_web_content: "enableWebFetch",
-	apply_patch: "enableApplyPatch",
-	editor: "enableEditor",
-	skills: "enableSkills",
-	ask_question: "enableAskQuestion",
-	submit_and_exit: "enableSubmitAndExit",
-};
-
-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/extensions/tools/presets.ts

@@ -1,190 +0,0 @@
-/**
- * Tool Presets
- *
- * Pre-configured tool combinations for common use cases.
- */
-
-import type { AgentMode, Tool, ToolPolicy } from "@clinebot/shared";
-import { ALL_DEFAULT_TOOL_NAMES } from "./constants";
-import { createDefaultTools } from "./definitions";
-import type { CreateDefaultToolsOptions, DefaultToolsConfig } from "./types";
-
-export interface ToolPresetConfig extends DefaultToolsConfig {
-	enableSpawnAgent?: boolean;
-	enableAgentTeams?: boolean;
-}
-
-/**
- * Preset configurations for common use cases
- */
-export const ToolPresets = {
-	/**
-	 * Act mode (full development tools)
-	 * Good for coding assistants and task automation
-	 */
-	act: {
-		enableReadFiles: true,
-		enableSearch: true,
-		enableBash: true,
-		enableWebFetch: true,
-		enableApplyPatch: false,
-		enableEditor: true,
-		enableSkills: true,
-		enableAskQuestion: true,
-		enableSubmitAndExit: false,
-		enableSpawnAgent: true,
-		enableAgentTeams: true,
-	},
-
-	/**
-	 * Plan mode (read-only, no shell access)
-	 * Good for analysis and documentation agents
-	 */
-	plan: {
-		enableReadFiles: true,
-		enableSearch: true,
-		enableBash: true,
-		enableWebFetch: true,
-		enableApplyPatch: false,
-		enableEditor: false,
-		enableSkills: true,
-		enableAskQuestion: true,
-		enableSubmitAndExit: false,
-		enableSpawnAgent: true,
-		enableAgentTeams: true,
-	},
-
-	/**
-	 * Search-focused tools (read_files + search_codebase)
-	 * Good for code exploration and analysis agents
-	 */
-	search: {
-		enableReadFiles: true,
-		enableSearch: true,
-		enableBash: false,
-		enableWebFetch: false,
-		enableApplyPatch: false,
-		enableEditor: false,
-		enableSkills: false,
-		enableAskQuestion: false,
-		enableSubmitAndExit: false,
-		enableSpawnAgent: true,
-		enableAgentTeams: true,
-	},
-
-	/**
-	 * Minimal tools for focused tasks
-	 */
-	minimal: {
-		enableReadFiles: false,
-		enableSearch: false,
-		enableBash: true,
-		enableWebFetch: false,
-		enableApplyPatch: false,
-		enableEditor: false,
-		enableSkills: false,
-		enableAskQuestion: false,
-		enableSubmitAndExit: false,
-		enableSpawnAgent: true,
-		enableAgentTeams: false,
-	},
-
-	/**
-	 * YOLO mode (automation-focused tools + no approval required)
-	 * Good for trusted local automation workflows.
-	 */
-	yolo: {
-		enableReadFiles: true,
-		enableSearch: true,
-		enableBash: true,
-		enableWebFetch: true,
-		enableApplyPatch: false,
-		enableEditor: true,
-		enableSkills: true,
-		enableAskQuestion: false,
-		enableSubmitAndExit: true,
-		enableSpawnAgent: false,
-		enableAgentTeams: false,
-	},
-} as const satisfies Record<string, ToolPresetConfig>;
-
-/**
- * Type for preset names
- */
-export type ToolPresetName = keyof typeof ToolPresets;
-
-export function resolveToolPresetName(options: {
-	mode?: AgentMode;
-}): ToolPresetName {
-	if (options.mode === "plan") {
-		return "plan";
-	}
-	if (options.mode === "yolo") {
-		return "yolo";
-	}
-	return "act";
-}
-
-/**
- * Tool policy preset names
- */
-export type ToolPolicyPresetName = "default" | "yolo";
-
-/**
- * Build tool policies for a preset.
- * `yolo` guarantees tool policies are enabled and auto-approved.
- */
-export function createToolPoliciesWithPreset(
-	presetName: ToolPolicyPresetName,
-): Record<string, ToolPolicy> {
-	if (presetName !== "yolo") {
-		return {};
-	}
-
-	const yoloPolicy: ToolPolicy = {
-		enabled: true,
-		autoApprove: true,
-	};
-
-	const policies: Record<string, ToolPolicy> = {
-		"*": yoloPolicy,
-	};
-
-	for (const toolName of ALL_DEFAULT_TOOL_NAMES) {
-		policies[toolName] = yoloPolicy;
-	}
-
-	return policies;
-}
-
-/**
- * Create default tools using a preset configuration
- *
- * @example
- * ```typescript
- * const tools = createDefaultToolsWithPreset("plan", {
- *   executors: {
- *     readFile: async ({ path }) => fs.readFile(path, "utf-8"),
- *     search: async (query, cwd) => searchFiles(query, cwd),
- *     webFetch: async (url, prompt) => fetchAndAnalyze(url, prompt),
- *   },
- *   cwd: "/path/to/project",
- * })
- * ```
- */
-export function createDefaultToolsWithPreset(
-	presetName: ToolPresetName,
-	options: Omit<CreateDefaultToolsOptions, keyof DefaultToolsConfig> &
-		Partial<DefaultToolsConfig>,
-): Tool[] {
-	const preset = ToolPresets[presetName];
-	const {
-		enableSpawnAgent: _enableSpawnAgent,
-		enableAgentTeams: _enableAgentTeams,
-		...toolConfig
-	} = preset;
-	return createDefaultTools({
-		...toolConfig,
-		...options,
-	});
-}