@morphllm/morphsdk 0.2.21 → 0.2.23

package/dist/tools/codebase_search/core.d.ts

@@ -1,40 +0,0 @@
-import { CodebaseSearchResult, CodebaseSearchInput, CodebaseSearchConfig } from './types.js';
-import '../utils/resilience.js';
-
-/**
- * Core implementation for codebase search
- * Calls Morph rerank service for two-stage semantic search
- */
-
-/**
- * CodebaseSearch client for programmatic semantic search
- */
-declare class CodebaseSearchClient {
-    private config;
-    constructor(config?: {
-        apiKey?: string;
-        debug?: boolean;
-        timeout?: number;
-        retryConfig?: any;
-    });
-    /**
-     * Execute a semantic code search
-     *
-     * @param input - Search parameters including query, repoId, and target directories
-     * @param overrides - Optional config overrides for this operation
-     * @returns Search results with ranked code matches
-     */
-    search(input: {
-        query: string;
-        repoId: string;
-        target_directories?: string[];
-        explanation?: string;
-        limit?: number;
-    }, overrides?: any): Promise<CodebaseSearchResult>;
-}
-/**
- * Execute semantic code search
- */
-declare function executeCodebaseSearch(input: CodebaseSearchInput, config: CodebaseSearchConfig): Promise<CodebaseSearchResult>;
-
-export { CodebaseSearchClient, executeCodebaseSearch };

package/dist/tools/codebase_search/index.d.ts

@@ -1,10 +0,0 @@
-export { executeCodebaseSearch } from './core.js';
-export { CODEBASE_SEARCH_DESCRIPTION, CODEBASE_SEARCH_SYSTEM_PROMPT } from './prompts.js';
-export { CodeSearchResult, CodebaseSearchConfig, CodebaseSearchInput, CodebaseSearchResult, SearchStats } from './types.js';
-export { createCodebaseSearchTool as anthropicCodebaseSearchTool } from './anthropic.js';
-export { createCodebaseSearchTool as openaiCodebaseSearchTool } from './openai.js';
-export { createCodebaseSearchTool as vercelCodebaseSearchTool } from './vercel.js';
-import '../utils/resilience.js';
-import '@anthropic-ai/sdk/resources/messages';
-import 'openai/resources/chat/completions';
-import 'ai';

package/dist/tools/codebase_search/openai.d.ts

@@ -1,87 +0,0 @@
-import { ChatCompletionTool } from 'openai/resources/chat/completions';
-import { CodebaseSearchConfig, CodebaseSearchInput, CodebaseSearchResult } from './types.js';
-import '../utils/resilience.js';
-
-/**
- * OpenAI SDK adapter for codebase_search tool
- */
-
-/**
- * Direct codebase_search tool definition
- * Use this when you want to pass config at execute time
- */
-declare const codebaseSearchTool: ChatCompletionTool;
-/**
- * Create OpenAI-native codebase_search tool with execute and formatResult methods
- *
- * @param config - Configuration with repoId
- * @returns OpenAI ChatCompletionTool definition with methods
- *
- * @example
- * ```ts
- * import OpenAI from 'openai';
- * import { createCodebaseSearchTool } from 'morphsdk/tools/openai';
- *
- * const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
- * const tool = createCodebaseSearchTool({ repoId: 'my-project' });
- *
- * const response = await client.chat.completions.create({
- *   model: "gpt-4o",
- *   tools: [tool], // tool itself is the ChatCompletionTool
- *   messages: [{ role: "user", content: "Find authentication code" }]
- * });
- *
- * // Execute and format
- * const result = await tool.execute(toolCallArgs);
- * const formatted = tool.formatResult(result);
- * ```
- */
-declare function createCodebaseSearchTool(config: CodebaseSearchConfig): ChatCompletionTool & {
-    execute: (input: CodebaseSearchInput | string) => Promise<CodebaseSearchResult>;
-    formatResult: (result: CodebaseSearchResult) => string;
-    getSystemPrompt: () => string;
-};
-/**
- * Execute codebase_search tool call
- *
- * @param input - Tool input from GPT (parsed from tool_calls)
- * @param config - Configuration with repoId (REQUIRED)
- * @returns Search results
- *
- * @example
- * ```ts
- * // Handle tool calls from GPT:
- * if (response.choices[0].message.tool_calls) {
- *   for (const toolCall of response.choices[0].message.tool_calls) {
- *     const args = JSON.parse(toolCall.function.arguments);
- *     const result = await execute(args, { repoId: 'my-project' });
- *     console.log(`Found ${result.results.length} matches`);
- *   }
- * }
- * ```
- */
-declare function execute(input: CodebaseSearchInput, config: CodebaseSearchConfig): Promise<CodebaseSearchResult>;
-/**
- * Format search results for GPT
- *
- * @param result - Search result from endpoint
- * @returns Formatted string for tool message
- */
-declare function formatResult(result: CodebaseSearchResult): string;
-/**
- * Get the system prompt for codebase_search usage
- *
- * @returns System prompt to guide GPT
- */
-declare function getSystemPrompt(): string;
-/**
- * Default export for convenience
- */
-declare const _default: {
-    createCodebaseSearchTool: typeof createCodebaseSearchTool;
-    execute: typeof execute;
-    formatResult: typeof formatResult;
-    getSystemPrompt: typeof getSystemPrompt;
-};
-
-export { codebaseSearchTool, createCodebaseSearchTool, _default as default, execute, formatResult, getSystemPrompt };

package/dist/tools/codebase_search/prompts.d.ts

@@ -1,7 +0,0 @@
-/**
- * Tool descriptions and system prompts for codebase search
- */
-declare const CODEBASE_SEARCH_DESCRIPTION = "Semantic search that finds code by meaning, not exact text.\n\nUse this to explore unfamiliar codebases or ask \"how/where/what\" questions:\n- \"How does X work?\" - Find implementation details\n- \"Where is Y handled?\" - Locate specific functionality\n- \"What happens when Z?\" - Understand flow\n\nThe tool uses two-stage retrieval (embedding similarity + reranking) to find the most semantically relevant code chunks.\n\nReturns code chunks with file paths, line ranges, and full content ranked by relevance.";
-declare const CODEBASE_SEARCH_SYSTEM_PROMPT = "You have access to the codebase_search tool that performs semantic code search.\n\nWhen searching:\n- Use natural language queries describing what you're looking for\n- Be specific about functionality, not variable names\n- Use target_directories to narrow search if you know the area\n- Results are ranked by relevance (rerank score is most important)\n\nThe tool returns:\n- File paths with symbol names (e.g. \"src/auth.ts::AuthService@L1-L17\")\n- Line ranges for precise navigation\n- Full code content for each match\n- Dual relevance scores: embedding similarity + rerank score\n\nUse results to understand code or answer questions. The content is provided in full - avoid re-reading unless you need more context.";
-
-export { CODEBASE_SEARCH_DESCRIPTION, CODEBASE_SEARCH_SYSTEM_PROMPT };

package/dist/tools/codebase_search/types.d.ts

@@ -1,46 +0,0 @@
-import { RetryConfig } from '../utils/resilience.js';
-
-/**
- * Type definitions for codebase search tool
- */
-
-interface CodebaseSearchConfig {
-    repoId: string;
-    searchUrl?: string;
-    apiKey?: string;
-    /** Timeout for search requests in ms (default: 30000) */
-    timeout?: number;
-    /** Retry configuration for API calls */
-    retryConfig?: RetryConfig;
-    /** Enable debug logging (default: false) */
-    debug?: boolean;
-}
-interface CodebaseSearchInput {
-    query: string;
-    target_directories?: string[];
-    explanation?: string;
-    limit?: number;
-}
-interface CodeSearchResult {
-    filepath: string;
-    symbolPath: string;
-    content: string;
-    language: string;
-    startLine: number;
-    endLine: number;
-    embeddingSimilarity: number;
-    rerankScore: number;
-}
-interface SearchStats {
-    totalResults: number;
-    candidatesRetrieved: number;
-    searchTimeMs: number;
-}
-interface CodebaseSearchResult {
-    success: boolean;
-    results: CodeSearchResult[];
-    stats: SearchStats;
-    error?: string;
-}
-
-export type { CodeSearchResult, CodebaseSearchConfig, CodebaseSearchInput, CodebaseSearchResult, SearchStats };

package/dist/tools/codebase_search/vercel.d.ts

@@ -1,65 +0,0 @@
-import * as ai from 'ai';
-import { CodebaseSearchConfig } from './types.js';
-import '../utils/resilience.js';
-
-/**
- * Create Vercel AI SDK codebase_search tool
- *
- * @param config - Configuration with repoId
- * @returns Vercel AI SDK tool definition (execution built-in)
- *
- * @example
- * ```ts
- * import { generateText } from 'ai';
- * import { anthropic } from '@ai-sdk/anthropic';
- * import { createCodebaseSearchTool } from 'morphsdk/tools/codebase-search/vercel';
- *
- * const tool = createCodebaseSearchTool({ repoId: 'my-project' });
- *
- * const result = await generateText({
- *   model: anthropic('claude-3-5-sonnet-20241022'),
- *   tools: { codebaseSearch: tool },
- *   prompt: "Find authentication code",
- *   maxSteps: 5
- * });
- *
- * // Vercel AI SDK automatically executes and handles results
- * console.log(result.text);
- * ```
- */
-declare function createCodebaseSearchTool(config: CodebaseSearchConfig): ai.Tool<{
-    query: string;
-    target_directories: string[];
-    explanation: string;
-    limit?: number | undefined;
-}, {
-    error: string | undefined;
-    results: never[];
-    found?: undefined;
-    searchTime?: undefined;
-} | {
-    found: number;
-    searchTime: string;
-    results: {
-        file: string;
-        symbol: string;
-        lines: string;
-        language: string;
-        relevance: string;
-        code: string;
-    }[];
-    error?: undefined;
-}>;
-/**
- * Get system prompt for Vercel AI SDK
- */
-declare function getSystemPrompt(): string;
-/**
- * Default export
- */
-declare const _default: {
-    createCodebaseSearchTool: typeof createCodebaseSearchTool;
-    getSystemPrompt: typeof getSystemPrompt;
-};
-
-export { createCodebaseSearchTool, _default as default, getSystemPrompt };

package/dist/tools/fastapply/anthropic.d.ts

@@ -1,4 +0,0 @@
-import '@anthropic-ai/sdk/resources/messages';
-import './types.js';
-export { c as createEditFileTool, e as editFileTool } from '../../anthropic-CknfcMoO.js';
-import '../utils/resilience.js';

package/dist/tools/fastapply/core.d.ts

@@ -1,41 +0,0 @@
-import { EditFileInput, EditFileConfig, EditFileResult, EditChanges } from './types.js';
-import '../utils/resilience.js';
-
-/**
- * Core implementation of Morph Fast Apply
- */
-
-/**
- * FastApply client for programmatic file editing
- */
-declare class FastApplyClient {
-    private config;
-    constructor(config?: {
-        apiKey?: string;
-        debug?: boolean;
-        timeout?: number;
-        retryConfig?: any;
-    });
-    /**
-     * Execute a file edit operation
-     *
-     * @param input - Edit parameters including filepath, instructions, and code_edit
-     * @param overrides - Optional config overrides for this operation
-     * @returns Edit result with success status and changes
-     */
-    execute(input: EditFileInput, overrides?: Partial<EditFileConfig>): Promise<EditFileResult>;
-}
-/**
- * Generate a unified diff between two strings
- */
-declare function generateUdiff(original: string, modified: string, filepath: string): string;
-/**
- * Count changes from a unified diff
- */
-declare function countChanges(original: string, modified: string): EditChanges;
-/**
- * Execute a file edit using Morph Fast Apply
- */
-declare function executeEditFile(input: EditFileInput, config?: EditFileConfig): Promise<EditFileResult>;
-
-export { FastApplyClient, countChanges, executeEditFile, generateUdiff };

package/dist/tools/fastapply/index.d.ts

@@ -1,10 +0,0 @@
-export { countChanges, executeEditFile, generateUdiff } from './core.js';
-export { EditChanges, EditFileConfig, EditFileInput, EditFileResult } from './types.js';
-export { EDIT_FILE_SYSTEM_PROMPT, EDIT_FILE_TOOL_DESCRIPTION } from './prompts.js';
-export { a as anthropic } from '../../anthropic-CknfcMoO.js';
-export { o as openai } from '../../openai-BkKsS30n.js';
-export { v as vercel } from '../../vercel-B1GZ_g9N.js';
-import '../utils/resilience.js';
-import '@anthropic-ai/sdk/resources/messages';
-import 'openai/resources/chat/completions';
-import 'ai';

package/dist/tools/fastapply/openai.d.ts

@@ -1,4 +0,0 @@
-import 'openai/resources/chat/completions';
-import './types.js';
-export { c as createEditFileTool, e as default, e as editFileTool, a as execute, f as formatResult, g as getSystemPrompt } from '../../openai-BkKsS30n.js';
-import '../utils/resilience.js';

package/dist/tools/fastapply/prompts.d.ts

@@ -1,7 +0,0 @@
-/**
- * System prompts for edit_file tool
- */
-declare const EDIT_FILE_TOOL_DESCRIPTION = "Use this tool to make an edit to an existing file.\n\nThis will be read by a less intelligent model, which will quickly apply the edit. You should make it clear what the edit is, while also minimizing the unchanged code you write.\n\nWhen writing the edit, you should specify each edit in sequence, with the special comment // ... existing code ... to represent unchanged code in between edited lines.\n\nFor example:\n\n// ... existing code ...\nFIRST_EDIT\n// ... existing code ...\nSECOND_EDIT\n// ... existing code ...\nTHIRD_EDIT\n// ... existing code ...\n\nYou should still bias towards repeating as few lines of the original file as possible to convey the change.\nBut, each edit should contain minimally sufficient context of unchanged lines around the code you're editing to resolve ambiguity.\n\nDO NOT omit spans of pre-existing code (or comments) without using the // ... existing code ... comment to indicate its absence. If you omit the existing code comment, the model may inadvertently delete these lines.\n\nIf you plan on deleting a section, you must provide context before and after to delete it.\n\nMake sure it is clear what the edit should be, and where it should be applied.\nMake edits to a file in a single edit_file call instead of multiple edit_file calls to the same file. The apply model can handle many distinct edits at once.";
-declare const EDIT_FILE_SYSTEM_PROMPT = "When the user is asking for edits to their code, use the edit_file tool to highlight the changes necessary and add comments to indicate where unchanged code has been skipped. For example:\n\n// ... existing code ...\n{{ edit_1 }}\n// ... existing code ...\n{{ edit_2 }}\n// ... existing code ...\n\nOften this will mean that the start/end of the file will be skipped, but that's okay! Rewrite the entire file ONLY if specifically requested. Always provide a brief explanation of the updates, unless the user specifically requests only the code.\n\nThese edit codeblocks are also read by a less intelligent language model, colloquially called the apply model, to update the file. To help specify the edit to the apply model, you will be very careful when generating the codeblock to not introduce ambiguity. You will specify all unchanged regions (code and comments) of the file with \"// ... existing code ...\" comment markers. This will ensure the apply model will not delete existing unchanged code or comments when editing the file.";
-
-export { EDIT_FILE_SYSTEM_PROMPT, EDIT_FILE_TOOL_DESCRIPTION };

package/dist/tools/fastapply/types.d.ts

@@ -1,77 +0,0 @@
-import { RetryConfig } from '../utils/resilience.js';
-
-/**
- * Core types for Morph Fast Apply SDK
- */
-
-/**
- * Input parameters for the edit_file tool
- */
-interface EditFileInput {
-    /** Path to the file to edit (relative to baseDir) */
-    target_filepath: string;
-    /** First-person description of what you're changing */
-    instructions: string;
-    /** Lazy edit with // ... existing code ... markers */
-    code_edit: string;
-}
-/**
- * Statistics about the changes made
- */
-interface EditChanges {
-    linesAdded: number;
-    linesRemoved: number;
-    linesModified: number;
-}
-/**
- * Result returned after executing an edit
- */
-interface EditFileResult {
-    /** Whether the edit was successful */
-    success: boolean;
-    /** Path to the edited file */
-    filepath: string;
-    /** Universal diff format showing changes */
-    udiff?: string;
-    /** Statistics about the changes */
-    changes: EditChanges;
-    /** Error message if unsuccessful */
-    error?: string;
-}
-/**
- * Configuration options for the edit_file tool
- */
-interface EditFileConfig {
-    /** Morph API key (defaults to MORPH_API_KEY env var) */
-    morphApiKey?: string;
-    /** Morph API base URL */
-    morphApiUrl?: string;
-    /** Base directory for file operations (defaults to cwd) */
-    baseDir?: string;
-    /** Whether to generate udiff (default: true) */
-    generateUdiff?: boolean;
-    /** Whether to automatically write to file (default: true) */
-    autoWrite?: boolean;
-    /** Custom system prompt (null to disable) */
-    systemPrompt?: string | null;
-    /** Custom tool description (defaults to EDIT_FILE_TOOL_DESCRIPTION) */
-    description?: string;
-    /** Timeout for API calls in ms (default: 30000) */
-    timeout?: number;
-    /** Retry configuration for API calls */
-    retryConfig?: RetryConfig;
-    /** Enable debug logging (default: false) */
-    debug?: boolean;
-}
-/**
- * Response from Morph Apply API
- */
-interface MorphApplyResponse {
-    choices: Array<{
-        message: {
-            content: string;
-        };
-    }>;
-}
-
-export type { EditChanges, EditFileConfig, EditFileInput, EditFileResult, MorphApplyResponse };

package/dist/tools/fastapply/vercel.d.ts

@@ -1,4 +0,0 @@
-import 'ai';
-import './types.js';
-export { c as createEditFileTool, e as default, e as editFileTool, g as getSystemPrompt } from '../../vercel-B1GZ_g9N.js';
-import '../utils/resilience.js';

package/dist/tools/index.d.ts

@@ -1,10 +0,0 @@
-export { countChanges, executeEditFile, generateUdiff } from './fastapply/core.js';
-export { EditChanges, EditFileConfig, EditFileInput, EditFileResult } from './fastapply/types.js';
-export { EDIT_FILE_SYSTEM_PROMPT, EDIT_FILE_TOOL_DESCRIPTION } from './fastapply/prompts.js';
-export { a as anthropic } from '../anthropic-CknfcMoO.js';
-export { o as openai } from '../openai-BkKsS30n.js';
-export { v as vercel } from '../vercel-B1GZ_g9N.js';
-import './utils/resilience.js';
-import '@anthropic-ai/sdk/resources/messages';
-import 'openai/resources/chat/completions';
-import 'ai';

package/dist/tools/utils/resilience.d.ts

@@ -1,58 +0,0 @@
-/**
- * Resilience utilities for retry logic and timeout handling
- */
-interface RetryConfig {
-    maxRetries?: number;
-    initialDelay?: number;
-    maxDelay?: number;
-    backoffMultiplier?: number;
-    retryableErrors?: string[];
-    onRetry?: (attempt: number, error: Error) => void;
-}
-/**
- * Retry a fetch request with exponential backoff
- *
- * @param url - Request URL
- * @param options - Fetch options
- * @param retryConfig - Retry configuration
- * @returns Response from fetch
- *
- * @example
- * ```typescript
- * const response = await fetchWithRetry(
- *   'https://api.example.com/data',
- *   { method: 'POST', body: JSON.stringify(data) },
- *   { maxRetries: 5, initialDelay: 500 }
- * );
- * ```
- */
-declare function fetchWithRetry(url: string, options: RequestInit, retryConfig?: RetryConfig): Promise<Response>;
-/**
- * Add timeout to any promise
- *
- * @param promise - Promise to wrap with timeout
- * @param timeoutMs - Timeout in milliseconds
- * @param errorMessage - Optional custom error message
- * @returns Promise that rejects if timeout is reached
- *
- * @example
- * ```typescript
- * const result = await withTimeout(
- *   fetchData(),
- *   5000,
- *   'Data fetch timed out'
- * );
- * ```
- */
-declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, errorMessage?: string): Promise<T>;
-/**
- * Unified error type for all tools
- */
-declare class MorphError extends Error {
-    code: string;
-    statusCode?: number | undefined;
-    retryable: boolean;
-    constructor(message: string, code: string, statusCode?: number | undefined, retryable?: boolean);
-}
-
-export { MorphError, type RetryConfig, fetchWithRetry, withTimeout };

package/dist/vercel-B1GZ_g9N.d.ts

@@ -1,69 +0,0 @@
-import * as ai from 'ai';
-import { EditChanges, EditFileConfig } from './tools/fastapply/types.js';
-
-declare const editFileTool: ai.Tool<{
-    target_filepath: string;
-    instructions: string;
-    code_edit: string;
-}, {
-    success: boolean;
-    filepath: string;
-    changes: EditChanges;
-    udiff: string | undefined;
-}>;
-/**
- * Get the system prompt for edit_file usage
- *
- * Add this to your system message to guide the model on using edit_file properly.
- *
- * @example
- * ```ts
- * const result = await generateText({
- *   model: anthropic('claude-sonnet-4-5-20250929'),
- *   system: getSystemPrompt(),
- *   tools: { editFile: editFileTool },
- *   prompt: "Fix bugs"
- * });
- * ```
- */
-declare function getSystemPrompt(): string;
-/**
- * Create a custom edit_file tool with configuration
- *
- * @param config - Configuration options
- * @returns Vercel AI SDK tool with custom config
- *
- * @example
- * ```ts
- * const customEditTool = createEditFileTool({
- *   baseDir: './src',
- *   generateUdiff: true,
- *   description: 'Custom tool description for your use case'
- * });
- *
- * const result = await generateText({
- *   model: anthropic('claude-sonnet-4-5-20250929'),
- *   tools: { editFile: customEditTool },
- *   prompt: "Fix bugs"
- * });
- * ```
- */
-declare function createEditFileTool(config?: EditFileConfig): ai.Tool<{
-    target_filepath: string;
-    instructions: string;
-    code_edit: string;
-}, {
-    success: boolean;
-    filepath: string;
-    changes: EditChanges;
-    udiff: string | undefined;
-}>;
-
-declare const vercel_createEditFileTool: typeof createEditFileTool;
-declare const vercel_editFileTool: typeof editFileTool;
-declare const vercel_getSystemPrompt: typeof getSystemPrompt;
-declare namespace vercel {
-  export { vercel_createEditFileTool as createEditFileTool, editFileTool as default, vercel_editFileTool as editFileTool, vercel_getSystemPrompt as getSystemPrompt };
-}
-
-export { createEditFileTool as c, editFileTool as e, getSystemPrompt as g, vercel as v };