@clinebot/core 0.0.0

package/dist/default-tools/executors/web-fetch.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Web Fetch Executor
+ *
+ * Built-in implementation for fetching web content using native fetch.
+ */
+import type { WebFetchExecutor } from "../types.js";
+/**
+ * Options for the web fetch executor
+ */
+export interface WebFetchExecutorOptions {
+    /**
+     * Timeout for fetch requests in milliseconds
+     * @default 30000 (30 seconds)
+     */
+    timeoutMs?: number;
+    /**
+     * Maximum response size in bytes
+     * @default 5_000_000 (5MB)
+     */
+    maxResponseBytes?: number;
+    /**
+     * User agent string
+     * @default "Mozilla/5.0 (compatible; AgentBot/1.0)"
+     */
+    userAgent?: string;
+    /**
+     * Additional headers
+     */
+    headers?: Record<string, string>;
+    /**
+     * Whether to follow redirects
+     * @default true
+     */
+    followRedirects?: boolean;
+    /**
+     * Maximum number of redirects to follow
+     * @default 5
+     */
+    maxRedirects?: number;
+}
+/**
+ * Create a web fetch executor using native fetch
+ *
+ * @example
+ * ```typescript
+ * const webFetch = createWebFetchExecutor({
+ *   timeoutMs: 15000,
+ *   maxResponseBytes: 2_000_000,
+ * })
+ *
+ * const content = await webFetch(
+ *   "https://docs.example.com/api",
+ *   "Extract the authentication section",
+ *   context
+ * )
+ * ```
+ */
+export declare function createWebFetchExecutor(options?: WebFetchExecutorOptions): WebFetchExecutor;

package/dist/default-tools/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Default Tools
+ *
+ * This module provides a set of configurable default tools for agents.
+ */
+export { validateWithZod, zodToJsonSchema } from "@clinebot/shared";
+export { ALL_DEFAULT_TOOL_NAMES, DefaultToolNames } from "./constants.js";
+export { createApplyPatchTool, createAskQuestionTool, createBashTool, createDefaultTools, createEditorTool, createReadFilesTool, createSearchTool, createSkillsTool, createWebFetchTool, } from "./definitions.js";
+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.js";
+export { createDefaultToolsWithPreset, createToolPoliciesWithPreset, type ToolPolicyPresetName, type ToolPresetName, ToolPresets, } from "./presets.js";
+export { type ApplyPatchInput, ApplyPatchInputSchema, type AskQuestionInput, AskQuestionInputSchema, type EditFileInput, EditFileInputSchema, type FetchWebContentInput, FetchWebContentInputSchema, type ReadFilesInput, ReadFilesInputSchema, type RunCommandsInput, RunCommandsInputSchema, type SearchCodebaseInput, SearchCodebaseInputSchema, type SkillsInput, SkillsInputSchema, type WebFetchRequest, WebFetchRequestSchema, } from "./schemas.js";
+export type { ApplyPatchExecutor, AskQuestionExecutor, BashExecutor, CreateDefaultToolsOptions, DefaultToolName, DefaultToolsConfig, EditorExecutor, FileReadExecutor, SearchExecutor, SkillsExecutor, SkillsExecutorSkillMetadata, SkillsExecutorWithMetadata, ToolExecutors, ToolOperationResult, WebFetchExecutor, } from "./types.js";
+import type { Tool } from "@clinebot/agents";
+import { type DefaultExecutorsOptions } from "./executors/index.js";
+import type { CreateDefaultToolsOptions, ToolExecutors } from "./types.js";
+/**
+ * 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 } from "@clinebot/agents"
+ * import { createBuiltinTools } from "@clinebot/core/server"
+ *
+ * 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 declare function createBuiltinTools(options?: CreateBuiltinToolsOptions): Tool[];

package/dist/default-tools/presets.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Tool Presets
+ *
+ * Pre-configured tool combinations for common use cases.
+ */
+import type { Tool, ToolPolicy } from "@clinebot/shared";
+import type { CreateDefaultToolsOptions, DefaultToolsConfig } from "./types.js";
+/**
+ * Preset configurations for common use cases
+ */
+export declare const ToolPresets: {
+    /**
+     * Browser-based tools (no shell access, no web fetch)
+     */
+    readonly browser: {
+        readonly enableReadFiles: false;
+        readonly enableSearch: false;
+        readonly enableBash: false;
+        readonly enableWebFetch: false;
+        readonly enableApplyPatch: false;
+        readonly enableEditor: false;
+        readonly enableSkills: true;
+        readonly enableAskQuestion: true;
+    };
+    /**
+     * Search-focused tools (read_files + search_codebase)
+     * Good for code exploration and analysis agents
+     */
+    readonly search: {
+        readonly enableReadFiles: true;
+        readonly enableSearch: true;
+        readonly enableBash: false;
+        readonly enableWebFetch: false;
+        readonly enableApplyPatch: false;
+        readonly enableEditor: false;
+        readonly enableSkills: false;
+        readonly enableAskQuestion: false;
+    };
+    /**
+     * Full development tools (all tools enabled) - Act mode
+     * Good for coding assistants and task automation
+     */
+    readonly development: {
+        readonly enableReadFiles: true;
+        readonly enableSearch: true;
+        readonly enableBash: true;
+        readonly enableWebFetch: true;
+        readonly enableApplyPatch: false;
+        readonly enableEditor: true;
+        readonly enableSkills: true;
+        readonly enableAskQuestion: true;
+    };
+    /**
+     * Read-only tools (no shell access) - Plan mode
+     * Good for analysis and documentation agents
+     */
+    readonly readonly: {
+        readonly enableReadFiles: true;
+        readonly enableSearch: true;
+        readonly enableBash: true;
+        readonly enableWebFetch: true;
+        readonly enableApplyPatch: false;
+        readonly enableEditor: false;
+        readonly enableSkills: true;
+        readonly enableAskQuestion: true;
+    };
+    /**
+     * Minimal tools (file reading only)
+     * Good for focused single-file tasks
+     */
+    readonly minimal: {
+        readonly enableReadFiles: false;
+        readonly enableSearch: false;
+        readonly enableBash: false;
+        readonly enableWebFetch: false;
+        readonly enableApplyPatch: false;
+        readonly enableEditor: false;
+        readonly enableSkills: false;
+        readonly enableAskQuestion: true;
+    };
+    /**
+     * YOLO mode (everything enabled + no approval required)
+     * Good for trusted local automation workflows.
+     */
+    readonly yolo: {
+        readonly enableReadFiles: true;
+        readonly enableSearch: true;
+        readonly enableBash: true;
+        readonly enableWebFetch: true;
+        readonly enableApplyPatch: false;
+        readonly enableEditor: true;
+        readonly enableSkills: true;
+        readonly enableAskQuestion: true;
+    };
+};
+/**
+ * Type for preset names
+ */
+export type ToolPresetName = keyof typeof ToolPresets;
+/**
+ * Tool policy preset names
+ */
+export type ToolPolicyPresetName = "default" | "yolo";
+/**
+ * Build tool policies for a preset.
+ * `yolo` guarantees all tools are enabled and auto-approved.
+ */
+export declare function createToolPoliciesWithPreset(presetName: ToolPolicyPresetName): Record<string, ToolPolicy>;
+/**
+ * Create default tools using a preset configuration
+ *
+ * @example
+ * ```typescript
+ * const tools = createDefaultToolsWithPreset("readonly", {
+ *   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 declare function createDefaultToolsWithPreset(presetName: ToolPresetName, options: Omit<CreateDefaultToolsOptions, keyof DefaultToolsConfig> & Partial<DefaultToolsConfig>): Tool[];

package/dist/default-tools/schemas.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Zod Schemas for Default Tool Inputs
+ *
+ * These schemas define the input structure for each default tool
+ * and are used for both validation and JSON Schema generation.
+ */
+import { z } from "zod";
+/**
+ * Schema for read_files tool input
+ */
+export declare const ReadFilesInputSchema: z.ZodObject<{
+    file_paths: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const ReadFilesInputUnionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    file_paths: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodArray<z.ZodString>, z.ZodString]>;
+/**
+ * Schema for search_codebase tool input
+ */
+export declare const SearchCodebaseInputSchema: z.ZodObject<{
+    queries: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for run_commands tool input
+ */
+export declare const RunCommandsInputSchema: z.ZodObject<{
+    commands: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const RunCommandsInputUnionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    commands: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodArray<z.ZodString>, z.ZodString]>;
+/**
+ * Schema for a single web fetch request
+ */
+export declare const WebFetchRequestSchema: z.ZodObject<{
+    url: z.ZodURL;
+    prompt: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for fetch_web_content tool input
+ */
+export declare const FetchWebContentInputSchema: z.ZodObject<{
+    requests: z.ZodArray<z.ZodObject<{
+        url: z.ZodURL;
+        prompt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for editor tool input
+ */
+export declare const EditFileInputSchema: z.ZodObject<{
+    command: z.ZodEnum<{
+        create: "create";
+        str_replace: "str_replace";
+        insert: "insert";
+    }>;
+    path: z.ZodString;
+    file_text: z.ZodOptional<z.ZodString>;
+    old_str: z.ZodOptional<z.ZodString>;
+    new_str: z.ZodOptional<z.ZodString>;
+    insert_line: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for apply_patch tool input
+ */
+export declare const ApplyPatchInputSchema: z.ZodObject<{
+    input: z.ZodString;
+}, z.core.$strip>;
+export declare const ApplyPatchInputUnionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    input: z.ZodString;
+}, z.core.$strip>, z.ZodString]>;
+/**
+ * Schema for skills tool input
+ */
+export declare const SkillsInputSchema: z.ZodObject<{
+    skill: z.ZodString;
+    args: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for ask_followup_question tool input
+ */
+export declare const AskQuestionInputSchema: z.ZodObject<{
+    question: z.ZodString;
+    options: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Input for the read_files tool
+ */
+export type ReadFilesInput = z.infer<typeof ReadFilesInputSchema>;
+/**
+ * Input for the search_codebase tool
+ */
+export type SearchCodebaseInput = z.infer<typeof SearchCodebaseInputSchema>;
+/**
+ * Input for the run_commands tool
+ */
+export type RunCommandsInput = z.infer<typeof RunCommandsInputSchema>;
+/**
+ * Web fetch request parameters
+ */
+export type WebFetchRequest = z.infer<typeof WebFetchRequestSchema>;
+/**
+ * Input for the fetch_web_content tool
+ */
+export type FetchWebContentInput = z.infer<typeof FetchWebContentInputSchema>;
+/**
+ * Input for the editor tool
+ */
+export type EditFileInput = z.infer<typeof EditFileInputSchema>;
+/**
+ * Input for the apply_patch tool
+ */
+export type ApplyPatchInput = z.infer<typeof ApplyPatchInputSchema>;
+/**
+ * Input for the skills tool
+ */
+export type SkillsInput = z.infer<typeof SkillsInputSchema>;
+/**
+ * Input for the ask_followup_question tool
+ */
+export type AskQuestionInput = z.infer<typeof AskQuestionInputSchema>;

package/dist/default-tools/types.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Types for Default Tools
+ *
+ * Type definitions for executors, configuration, and results.
+ */
+import type { ToolContext } from "@clinebot/agents";
+import type { ApplyPatchInput, EditFileInput } from "./schemas";
+/**
+ * Result from a single tool operation
+ */
+export interface ToolOperationResult {
+    /** The query/input that was executed */
+    query: string;
+    /** The result content (if successful) */
+    result: string;
+    /** Error message (if failed) */
+    error?: string;
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Duration in MS */
+    duration?: number;
+}
+/**
+ * Executor for reading files
+ *
+ * @param filePath - Absolute path to the file to read
+ * @param context - Tool execution context
+ * @returns The file content as a string
+ */
+export type FileReadExecutor = (filePath: string, context: ToolContext) => Promise<string>;
+/**
+ * Executor for searching the codebase
+ *
+ * @param query - Regex pattern to search for
+ * @param cwd - Current working directory for the search
+ * @param context - Tool execution context
+ * @returns Search results as a formatted string
+ */
+export type SearchExecutor = (query: string, cwd: string, context: ToolContext) => Promise<string>;
+/**
+ * Executor for running shell commands
+ *
+ * @param command - Shell command to execute
+ * @param cwd - Current working directory for execution
+ * @param context - Tool execution context
+ * @returns Command output (stdout)
+ */
+export type BashExecutor = (command: string, cwd: string, context: ToolContext) => Promise<string>;
+/**
+ * Executor for fetching web content
+ *
+ * @param url - URL to fetch
+ * @param prompt - Analysis prompt for the content
+ * @param context - Tool execution context
+ * @returns Analyzed/extracted content
+ */
+export type WebFetchExecutor = (url: string, prompt: string, context: ToolContext) => Promise<string>;
+/**
+ * Executor for editing files
+ *
+ * @param input - Editor command input
+ * @param cwd - Current working directory for filesystem operations
+ * @param context - Tool execution context
+ * @returns A formatted operation result string
+ */
+export type EditorExecutor = (input: EditFileInput, cwd: string, context: ToolContext) => Promise<string>;
+/**
+ * Executor for apply_patch operations
+ *
+ * @param input - apply_patch command payload
+ * @param cwd - Current working directory for filesystem operations
+ * @param context - Tool execution context
+ * @returns A formatted operation result string
+ */
+export type ApplyPatchExecutor = (input: ApplyPatchInput, cwd: string, context: ToolContext) => Promise<string>;
+/**
+ * Executor for invoking configured skills
+ *
+ * @param skill - Skill name to invoke
+ * @param args - Optional arguments for the skill
+ * @param context - Tool execution context
+ * @returns Skill loading/invocation result
+ */
+export type SkillsExecutor = (skill: string, args: string | undefined, context: ToolContext) => Promise<string>;
+/**
+ * Executor for asking a single follow-up question with selectable options
+ *
+ * @param question - Single clarifying question for the user
+ * @param options - 2-5 selectable answer options
+ * @param context - Tool execution context
+ * @returns Executor-specific result payload
+ */
+export type AskQuestionExecutor = (question: string, options: string[], context: ToolContext) => Promise<string>;
+/**
+ * Skill metadata exposed by SkillsExecutor for clients/UI
+ */
+export interface SkillsExecutorSkillMetadata {
+    /** Normalized skill id (usually lowercased name) */
+    id: string;
+    /** Display name for the skill */
+    name: string;
+    /** Optional short description */
+    description?: string;
+    /** True when configured but intentionally disabled */
+    disabled: boolean;
+}
+/**
+ * A callable executor that can also expose configured skill metadata.
+ */
+export interface SkillsExecutorWithMetadata {
+    (skill: string, args: string | undefined, context: ToolContext): Promise<string>;
+    configuredSkills?: SkillsExecutorSkillMetadata[];
+}
+/**
+ * Collection of all tool executors
+ */
+export interface ToolExecutors {
+    /** File reading implementation */
+    readFile?: FileReadExecutor;
+    /** Codebase search implementation */
+    search?: SearchExecutor;
+    /** Shell command execution implementation */
+    bash?: BashExecutor;
+    /** Web content fetching implementation */
+    webFetch?: WebFetchExecutor;
+    /** Filesystem editor implementation */
+    editor?: EditorExecutor;
+    /** Apply patch implementation */
+    applyPatch?: ApplyPatchExecutor;
+    /** Skill invocation implementation */
+    skills?: SkillsExecutorWithMetadata;
+    /** Follow-up question implementation */
+    askQuestion?: AskQuestionExecutor;
+}
+/**
+ * Names of available default tools
+ */
+export type DefaultToolName = "read_files" | "search_codebase" | "run_commands" | "fetch_web_content" | "apply_patch" | "editor" | "skills" | "ask_question";
+/**
+ * Configuration for enabling/disabling default tools
+ */
+export interface DefaultToolsConfig {
+    /**
+     * Enable the read_files tool
+     * @default true
+     */
+    enableReadFiles?: boolean;
+    /**
+     * Enable the search_codebase tool
+     * @default true
+     */
+    enableSearch?: boolean;
+    /**
+     * Enable the run_commands tool
+     * @default true
+     */
+    enableBash?: boolean;
+    /**
+     * Enable the fetch_web_content tool
+     * @default true
+     */
+    enableWebFetch?: boolean;
+    /**
+     * Enable the apply_patch tool
+     * @default true
+     */
+    enableApplyPatch?: boolean;
+    /**
+     * Enable the editor tool
+     * @default true
+     */
+    enableEditor?: boolean;
+    /**
+     * Enable the skills tool
+     * @default true
+     */
+    enableSkills?: boolean;
+    /**
+     * Enable the ask_followup_question tool
+     * @default true
+     */
+    enableAskQuestion?: boolean;
+    /**
+     * Current working directory for tools that need it
+     */
+    cwd?: string;
+    /**
+     * Timeout for file read operations in milliseconds
+     * @default 10000
+     */
+    fileReadTimeoutMs?: number;
+    /**
+     * Timeout for bash command execution in milliseconds
+     * @default 30000
+     */
+    bashTimeoutMs?: number;
+    /**
+     * Timeout for web fetch operations in milliseconds
+     * @default 30000
+     */
+    webFetchTimeoutMs?: number;
+    /**
+     * Timeout for search operations in milliseconds
+     * @default 30000
+     */
+    searchTimeoutMs?: number;
+    /**
+     * Timeout for apply_patch operations in milliseconds
+     * @default 30000
+     */
+    applyPatchTimeoutMs?: number;
+    /**
+     * Timeout for editor operations in milliseconds
+     * @default 30000
+     */
+    editorTimeoutMs?: number;
+    /**
+     * Timeout for skills operations in milliseconds
+     * @default 15000
+     */
+    skillsTimeoutMs?: number;
+    /**
+     * Timeout for ask_followup_question operations in milliseconds
+     * @default 15000
+     */
+    askQuestionTimeoutMs?: number;
+}
+/**
+ * Options for creating default tools
+ */
+export interface CreateDefaultToolsOptions extends DefaultToolsConfig {
+    /**
+     * Executor implementations for the tools
+     * Only tools with provided executors will be available
+     */
+    executors: ToolExecutors;
+}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @clinebot/core
+ *
+ * Runtime-agnostic core contracts and shared state utilities.
+ */
+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 { ChatMessage, ChatSessionConfig, ChatSessionStatus, ChatSummary, ChatViewState, } from "./chat/chat-schema";
+export { ChatMessageRoleSchema, ChatMessageSchema, ChatSessionConfigSchema, ChatSessionStatusSchema, ChatSummarySchema, ChatViewStateSchema, } from "./chat/chat-schema";
+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";
+export { hasMcpSettingsFile, InMemoryMcpManager, type LoadMcpSettingsOptions, loadMcpSettingsFile, type McpConnectionStatus, type McpManager, type McpManagerOptions, type McpServerClient, type McpServerClientFactory, type McpServerRegistration, type McpServerSnapshot, type McpServerTransportConfig, type McpSettingsFile, type McpSseTransportConfig, type McpStdioTransportConfig, type McpStreamableHttpTransportConfig, type RegisterMcpServersFromSettingsOptions, registerMcpServersFromSettingsFile, resolveDefaultMcpSettingsPath, resolveMcpServerRegistrations, } from "./mcp";
+export { ProviderSettingsManager } from "./storage/provider-settings-manager";
+export { SqliteTeamStore, type SqliteTeamStoreOptions, } from "./storage/team-store";
+export { buildTeamProgressSummary, toTeamProgressLifecycleEvent, } from "./team";
+export type { RuntimeEnvironment, SessionEvent, StoredMessages } from "./types";
+export type { SessionStatus } from "./types/common";
+export { SESSION_STATUSES, SessionSource } from "./types/common";
+export type { CoreAgentMode, CoreModelConfig, CoreRuntimeFeatures, CoreSessionConfig, } from "./types/config";
+export type { CoreSessionEvent, SessionChunkEvent, SessionEndedEvent, SessionTeamProgressEvent, SessionToolEvent, } from "./types/events";
+export type { ProviderTokenSource, StoredProviderSettings, StoredProviderSettingsEntry, } from "./types/provider-settings";
+export { emptyStoredProviderSettings, StoredProviderSettingsEntrySchema, StoredProviderSettingsSchema, } from "./types/provider-settings";
+export type { SessionRecord, SessionRef } from "./types/sessions";
+export type { ArtifactStore, SessionStore, TeamStore } from "./types/storage";
+export type { WorkspaceInfo } from "./types/workspace";