@polka-codes/core 0.9.86 → 0.9.89

package/README.md

@@ -10,9 +10,10 @@ Core AI services and agent implementations for Polka Codes framework.
 
 - Multiple AI provider support (Anthropic, DeepSeek, GoogleVertex, Ollama, OpenAI, and OpenRouter)
 - Extensible agent architecture
-- Tool integration system
+- Tool integration system with safety enhancements
 - Type-safe API
 - Logging and monitoring
+- File operation safety (read-first enforcement, line numbers, partial reading)
 
 ## Installation
 
@@ -110,6 +111,31 @@ bun run build
 bun test
 ```
 
+### Line Numbers
+
+All file reads include line numbers for easy reference:
+
+```
+     1→import React from 'react';
+     2→
+     3→function App() {
+     4→  return <div>Hello</div>;
+     5→}
+```
+
+### Partial File Reading
+
+You can read specific sections of a file using `offset` and `limit` parameters:
+
+```typescript
+// Read lines 100-150 of a large file
+await readFile.handler(provider, {
+  path: 'large-file.ts',
+  offset: 100,  // Skip first 100 lines
+  limit: 50     // Read 50 lines
+});
+```
+
 ---
 
 *This README was generated by polka.codes*

package/dist/_tsup-dts-rollup.d.ts

@@ -122,6 +122,7 @@ declare const configSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         project: z.ZodOptional<z.ZodString>;
         keyFile: z.ZodOptional<z.ZodString>;
         baseUrl: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     defaultProvider: z.ZodOptional<z.ZodString>;
     defaultModel: z.ZodOptional<z.ZodString>;
@@ -211,6 +212,67 @@ declare const configSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         branch: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>]>>>, z.ZodString]>>;
     excludeFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodOptional<z.ZodString>;
+        strategy: z.ZodOptional<z.ZodEnum<{
+            "goal-directed": "goal-directed";
+            "continuous-improvement": "continuous-improvement";
+        }>>;
+        continueOnCompletion: z.ZodOptional<z.ZodBoolean>;
+        maxIterations: z.ZodOptional<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        requireApprovalFor: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            destructive: "destructive";
+            commits: "commits";
+            all: "all";
+        }>>;
+        autoApproveSafeTasks: z.ZodOptional<z.ZodBoolean>;
+        maxAutoApprovalCost: z.ZodOptional<z.ZodNumber>;
+        pauseOnError: z.ZodOptional<z.ZodBoolean>;
+        workingBranch: z.ZodOptional<z.ZodString>;
+        destructiveOperations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maxConcurrency: z.ZodOptional<z.ZodNumber>;
+        autoSaveInterval: z.ZodOptional<z.ZodNumber>;
+        workingDir: z.ZodOptional<z.ZodString>;
+        continuousImprovement: z.ZodOptional<z.ZodObject<{
+            sleepTimeOnNoTasks: z.ZodOptional<z.ZodNumber>;
+            sleepTimeBetweenTasks: z.ZodOptional<z.ZodNumber>;
+            maxCycles: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        discovery: z.ZodOptional<z.ZodObject<{
+            enabledStrategies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            cacheTime: z.ZodOptional<z.ZodNumber>;
+            checkChanges: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        safety: z.ZodOptional<z.ZodObject<{
+            enabledChecks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            blockDestructive: z.ZodOptional<z.ZodBoolean>;
+            maxFileSize: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        healthCheck: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            interval: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        approval: z.ZodOptional<z.ZodObject<{
+            level: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                destructive: "destructive";
+                commits: "commits";
+                all: "all";
+            }>>;
+            autoApproveSafeTasks: z.ZodOptional<z.ZodBoolean>;
+            maxAutoApprovalCost: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    memory: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            sqlite: "sqlite";
+            memory: "memory";
+        }>>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>>>;
 export { configSchema }
 export { configSchema as configSchema_alias_1 }
@@ -254,15 +316,98 @@ export { createDynamicWorkflow }
 export { createDynamicWorkflow as createDynamicWorkflow_alias_1 }
 export { createDynamicWorkflow as createDynamicWorkflow_alias_2 }
 
+/**
+ * Create an error tool response
+ *
+ * @param message - The error message
+ * @returns An error tool response object
+ *
+ * @example
+ * ```ts
+ * return createErrorResponse('Failed to read file')
+ * ```
+ */
+declare function createErrorResponse(message: string): ToolResponse;
+export { createErrorResponse }
+export { createErrorResponse as createErrorResponse_alias_1 }
+export { createErrorResponse as createErrorResponse_alias_2 }
+
 /**
  * Create a file content XML element
  */
 export declare function createFileElement(tagName: string, path: string, content?: string, attrs?: Record<string, string>): string;
 
 /**
- * Create a standardized error response for provider method not available
+ * Create a provider capability error response
+ * Use this when a required provider capability is not available
+ *
+ * @param capability - The capability that's missing (e.g., "read file", "write file")
+ * @returns An error response indicating the missing capability
+ *
+ * @example
+ * ```ts
+ * if (!provider.readFile) {
+ *   return createProviderErrorResponse('read file')
+ * }
+ * ```
+ */
+declare function createProviderErrorResponse(capability: string): ToolResponse;
+export { createProviderErrorResponse as createProviderError }
+export { createProviderErrorResponse }
+export { createProviderErrorResponse as createProviderErrorResponse_alias_1 }
+export { createProviderErrorResponse as createProviderErrorResponse_alias_2 }
+
+/**
+ * Create a successful tool response
+ *
+ * @param value - The response value (string or JSON string)
+ * @param type - Response type ('text' or 'json')
+ * @returns A successful tool response object
+ *
+ * @example
+ * ```ts
+ * return createSuccessResponse('File content loaded')
+ * return createSuccessResponse(JSON.stringify(data), 'json')
+ * ```
+ */
+declare function createSuccessResponse(value: string, type?: 'text' | 'json'): ToolResponse;
+export { createSuccessResponse }
+export { createSuccessResponse as createSuccessResponse_alias_1 }
+export { createSuccessResponse as createSuccessResponse_alias_2 }
+
+/**
+ * Create a validation error response
+ * Use this when input validation fails
+ *
+ * @param errors - The validation error details
+ * @returns An error response with validation details
+ *
+ * @example
+ * ```ts
+ * const result = schema.safeParse(input)
+ * if (!result.success) {
+ *   return createValidationErrorResponse(result.error)
+ * }
+ * ```
+ */
+declare function createValidationErrorResponse(errors: {
+    message: string;
+}): ToolResponse;
+export { createValidationErrorResponse }
+export { createValidationErrorResponse as createValidationErrorResponse_alias_1 }
+export { createValidationErrorResponse as createValidationErrorResponse_alias_2 }
+
+/**
+ * Database statistics
  */
-export declare function createProviderError(action: string): ToolResponse;
+declare type DatabaseStats = {
+    totalEntries: number;
+    entriesByType: Record<string, number>;
+    databaseSize: number;
+};
+export { DatabaseStats }
+export { DatabaseStats as DatabaseStats_alias_1 }
+export { DatabaseStats as DatabaseStats_alias_2 }
 
 declare const _default: {
     handler: ToolHandler<{
@@ -331,14 +476,14 @@ export { _default_11 as searchFiles_alias_1 }
 declare const _default_12: {
     handler: ToolHandler<{
         readonly name: "writeToFile";
-        readonly description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.";
+        readonly description: "Request to write content to a file at the specified path.\n\nWhen to use:\n- Creating new files\n- Completely replacing file contents\n- When you have the complete intended content\n\nWhen NOT to use:\n- For modifying existing files: Use replaceInFile instead\n- For appending content: Use executeCommand with echo >> instead\n- For targeted edits: Use replaceInFile instead\n\nFeatures:\n- Automatically creates any directories needed\n- Overwrites existing files completely\n- Must provide complete file content (no truncation)\n\nIMPORTANT CONSTRAINT:\n- Always provide COMPLETE intended content (no omissions)\n- Ensure no incorrect escape sequences (&lt;, &gt;, &amp;)\n- Ensure no unwanted CDATA tags in content";
         readonly parameters: z.ZodObject<{
             path: z.ZodString;
             content: z.ZodString;
         }, z.core.$strip>;
     }, FilesystemProvider>;
     name: "writeToFile";
-    description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.";
+    description: "Request to write content to a file at the specified path.\n\nWhen to use:\n- Creating new files\n- Completely replacing file contents\n- When you have the complete intended content\n\nWhen NOT to use:\n- For modifying existing files: Use replaceInFile instead\n- For appending content: Use executeCommand with echo >> instead\n- For targeted edits: Use replaceInFile instead\n\nFeatures:\n- Automatically creates any directories needed\n- Overwrites existing files completely\n- Must provide complete file content (no truncation)\n\nIMPORTANT CONSTRAINT:\n- Always provide COMPLETE intended content (no omissions)\n- Ensure no incorrect escape sequences (&lt;, &gt;, &amp;)\n- Ensure no unwanted CDATA tags in content";
     parameters: z.ZodObject<{
         path: z.ZodString;
         content: z.ZodString;
@@ -431,16 +576,20 @@ export { _default_5 as readBinaryFile_alias_1 }
 declare const _default_6: {
     handler: ToolHandler<{
         readonly name: "readFile";
-        readonly description: "Request to read the contents of one or multiple files at the specified paths. Use comma separated paths to read multiple files. Use this when you need to examine the contents of an existing file you do not know the contents of, for example to analyze code, review text files, or extract information from configuration files. May not be suitable for other types of binary files, as it returns the raw content as a string. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
+        readonly description: "Request to read the contents of one or multiple files at the specified paths.\n\nWhen to use:\n- Examining file contents you don't know\n- Analyzing code, reviewing text files, extracting configuration info\n- Reading multiple files at once (use comma-separated paths)\n- Understanding file structure before editing\n\nWhen NOT to use:\n- For file existence checks: Use listFiles instead\n- For searching within files: Use grep instead\n- For file name searches: Use searchFiles instead\n- Prefer this tool over executeCommand with cat/head/tail\n\nFeatures:\n- Supports comma-separated paths for multiple files\n- Line numbers included for easy reference\n- Optional offset/limit for partial file reading\n- Automatically handles different file types\n\nIMPORTANT:\n- Line numbers are included for easy reference\n- Use offset/limit for large files to read specific sections";
         readonly parameters: z.ZodObject<{
-            path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+            path: z.ZodPipe<z.ZodTransform<any[], unknown>, z.ZodArray<z.ZodString>>;
+            offset: z.ZodOptional<z.ZodNumber>;
+            limit: z.ZodOptional<z.ZodNumber>;
             includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>>;
         }, z.core.$strip>;
     }, FilesystemProvider>;
     name: "readFile";
-    description: "Request to read the contents of one or multiple files at the specified paths. Use comma separated paths to read multiple files. Use this when you need to examine the contents of an existing file you do not know the contents of, for example to analyze code, review text files, or extract information from configuration files. May not be suitable for other types of binary files, as it returns the raw content as a string. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
+    description: "Request to read the contents of one or multiple files at the specified paths.\n\nWhen to use:\n- Examining file contents you don't know\n- Analyzing code, reviewing text files, extracting configuration info\n- Reading multiple files at once (use comma-separated paths)\n- Understanding file structure before editing\n\nWhen NOT to use:\n- For file existence checks: Use listFiles instead\n- For searching within files: Use grep instead\n- For file name searches: Use searchFiles instead\n- Prefer this tool over executeCommand with cat/head/tail\n\nFeatures:\n- Supports comma-separated paths for multiple files\n- Line numbers included for easy reference\n- Optional offset/limit for partial file reading\n- Automatically handles different file types\n\nIMPORTANT:\n- Line numbers are included for easy reference\n- Use offset/limit for large files to read specific sections";
     parameters: z.ZodObject<{
-        path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+        path: z.ZodPipe<z.ZodTransform<any[], unknown>, z.ZodArray<z.ZodString>>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
         includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>>;
     }, z.core.$strip>;
 };
@@ -489,14 +638,14 @@ export { _default_8 as renameFile_alias_1 }
 declare const _default_9: {
     handler: ToolHandler<{
         readonly name: "replaceInFile";
-        readonly description: "Request to replace sections of content in an existing file using SEARCH/REPLACE blocks that define exact changes to specific parts of the file. This tool should be used when you need to make targeted changes to specific parts of a file.";
+        readonly description: "Request to replace sections of content in an existing file using\nSEARCH/REPLACE blocks.\n\nWhen to use:\n- Making targeted changes to specific parts of a file\n- Replacing variable names, function signatures, imports\n- Fixing bugs in existing code\n- When you know the exact content to replace\n\nWhen NOT to use:\n- For creating new files: Use writeToFile instead\n- For completely replacing file contents: Use writeToFile instead\n- When you don't know the exact content: Read file first\n\nSEARCH/REPLACE FORMAT:\n<<<<<<< SEARCH\n[exact content to find]\n=======\n[new content to replace with]\n>>>>>>> REPLACE\n\nCritical rules:\n1. SEARCH content must match EXACTLY (character-for-character including whitespace)\n2. Each block replaces only first occurrence\n3. Include just enough lines for uniqueness (not too many, not too few)\n4. Keep blocks concise (don't include long unchanged sections)\n5. List blocks in order they appear in file\n6. Use multiple blocks for multiple independent changes\n\nSpecial operations:\n- Move code: Two blocks (delete from original + insert at new location)\n- Delete code: Empty REPLACE section\n\nIMPORTANT CONSTRAINTS:\n- SEARCH text must match file content exactly\n- Each block is independent (doesn't affect other blocks)\n- Cannot use for appending or inserting without SEARCH context";
         readonly parameters: z.ZodObject<{
             path: z.ZodString;
             diff: z.ZodString;
         }, z.core.$strip>;
     }, FilesystemProvider>;
     name: "replaceInFile";
-    description: "Request to replace sections of content in an existing file using SEARCH/REPLACE blocks that define exact changes to specific parts of the file. This tool should be used when you need to make targeted changes to specific parts of a file.";
+    description: "Request to replace sections of content in an existing file using\nSEARCH/REPLACE blocks.\n\nWhen to use:\n- Making targeted changes to specific parts of a file\n- Replacing variable names, function signatures, imports\n- Fixing bugs in existing code\n- When you know the exact content to replace\n\nWhen NOT to use:\n- For creating new files: Use writeToFile instead\n- For completely replacing file contents: Use writeToFile instead\n- When you don't know the exact content: Read file first\n\nSEARCH/REPLACE FORMAT:\n<<<<<<< SEARCH\n[exact content to find]\n=======\n[new content to replace with]\n>>>>>>> REPLACE\n\nCritical rules:\n1. SEARCH content must match EXACTLY (character-for-character including whitespace)\n2. Each block replaces only first occurrence\n3. Include just enough lines for uniqueness (not too many, not too few)\n4. Keep blocks concise (don't include long unchanged sections)\n5. List blocks in order they appear in file\n6. Use multiple blocks for multiple independent changes\n\nSpecial operations:\n- Move code: Two blocks (delete from original + insert at new location)\n- Delete code: Empty REPLACE section\n\nIMPORTANT CONSTRAINTS:\n- SEARCH text must match file content exactly\n- Each block is independent (doesn't affect other blocks)\n- Cannot use for appending or inserting without SEARCH context";
     parameters: z.ZodObject<{
         path: z.ZodString;
         diff: z.ZodString;
@@ -506,6 +655,14 @@ export { _default_9 as default_alias_8 }
 export { _default_9 as replaceInFile }
 export { _default_9 as replaceInFile_alias_1 }
 
+/**
+ * Default memory configuration
+ */
+declare const DEFAULT_MEMORY_CONFIG: MemoryConfig;
+export { DEFAULT_MEMORY_CONFIG }
+export { DEFAULT_MEMORY_CONFIG as DEFAULT_MEMORY_CONFIG_alias_1 }
+export { DEFAULT_MEMORY_CONFIG as DEFAULT_MEMORY_CONFIG_alias_2 }
+
 /**
  * Represents a directory entry
  */
@@ -678,6 +835,7 @@ export { FileSystemProvider as FileSystemProvider_alias_2 }
 declare type FilesystemProvider = {
     readFile?: (path: string, includeIgnored: boolean) => Promise<string | undefined>;
     writeFile?: (path: string, content: string) => Promise<void>;
+    fileExists?: (path: string) => Promise<boolean>;
     removeFile?: (path: string) => Promise<void>;
     renameFile?: (sourcePath: string, targetPath: string) => Promise<void>;
     listFiles?: (path: string, recursive: boolean, maxCount: number, includeIgnored: boolean) => Promise<[string[], boolean]>;
@@ -790,6 +948,64 @@ export { IGNORED_DIRECTORIES }
 export { IGNORED_DIRECTORIES as IGNORED_DIRECTORIES_alias_1 }
 export { IGNORED_DIRECTORIES as IGNORED_DIRECTORIES_alias_2 }
 
+/**
+ * Memory Store Interface
+ *
+ * This interface defines the contract for memory store implementations.
+ * Implementations can use different storage backends (SQLite, PostgreSQL, Redis, etc.)
+ * while maintaining the same API for the core memory logic.
+ */
+declare interface IMemoryStore {
+    /**
+     * Read memory by topic name
+     *
+     * @param topic - The topic name
+     * @returns The content, or undefined if not found
+     */
+    readMemory(topic: string): Promise<string | undefined>;
+    /**
+     * Update memory with operation
+     *
+     * @param operation - The operation to perform ('append', 'replace', 'remove')
+     * @param topic - The topic name
+     * @param content - The content (required for append/replace)
+     * @param metadata - Optional metadata (entry_type, status, priority, tags)
+     */
+    updateMemory(operation: 'append' | 'replace' | 'remove', topic: string, content: string | undefined, metadata?: {
+        entry_type?: string;
+        status?: string;
+        priority?: string;
+        tags?: string;
+    }): Promise<void>;
+    /**
+     * Query memory with filters
+     *
+     * @param query - The query filters
+     * @param options - Query options (operation, includeMetadata)
+     * @returns Array of entries or count
+     */
+    queryMemory(query: MemoryQuery, options?: QueryOptions): Promise<MemoryEntry[] | number>;
+    /**
+     * Batch update memory
+     *
+     * @param operations - Array of memory operations
+     */
+    batchUpdateMemory(operations: MemoryOperation[]): Promise<void>;
+    /**
+     * Get database statistics
+     *
+     * @returns Database statistics
+     */
+    getStats(): Promise<DatabaseStats>;
+    /**
+     * Close the memory store and release resources
+     */
+    close(): void;
+}
+export { IMemoryStore }
+export { IMemoryStore as IMemoryStore_alias_1 }
+export { IMemoryStore as IMemoryStore_alias_2 }
+
 declare type InteractionProvider = {
     askFollowupQuestion?: (question: string, options: string[]) => Promise<string>;
 };
@@ -1155,6 +1371,67 @@ declare const mcpServerConfigSchema: z.ZodObject<{
 export { mcpServerConfigSchema }
 export { mcpServerConfigSchema as mcpServerConfigSchema_alias_1 }
 
+declare type MemoryConfig = z.infer<typeof memoryConfigSchema> & MemoryStoreConfig;
+export { MemoryConfig }
+export { MemoryConfig as MemoryConfig_alias_1 }
+export { MemoryConfig as MemoryConfig_alias_2 }
+
+/**
+ * Memory configuration schema
+ * Controls the persistent memory store feature
+ */
+declare const memoryConfigSchema: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        sqlite: "sqlite";
+        memory: "memory";
+    }>>>;
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strict>>;
+export { memoryConfigSchema }
+export { memoryConfigSchema as memoryConfigSchema_alias_1 }
+export { memoryConfigSchema as memoryConfigSchema_alias_2 }
+
+/**
+ * Memory entry types
+ */
+declare type MemoryEntry = {
+    id: string;
+    name: string;
+    scope: string;
+    content: string;
+    entry_type: string;
+    status?: string;
+    priority?: 'low' | 'medium' | 'high' | 'critical';
+    tags?: string;
+    metadata?: string;
+    created_at: number;
+    updated_at: number;
+    last_accessed: number;
+};
+export { MemoryEntry }
+export { MemoryEntry as MemoryEntry_alias_1 }
+export { MemoryEntry as MemoryEntry_alias_2 }
+
+/**
+ * Memory operation for batch updates
+ */
+declare type MemoryOperation = {
+    operation: 'append' | 'replace' | 'remove';
+    name: string;
+    content?: string;
+    metadata?: {
+        entry_type?: string;
+        status?: string;
+        priority?: string;
+        tags?: string;
+        metadata?: string;
+    };
+};
+export { MemoryOperation }
+export { MemoryOperation as MemoryOperation_alias_1 }
+export { MemoryOperation as MemoryOperation_alias_2 }
+
 declare interface MemoryProvider {
     listMemoryTopics: () => Promise<string[]>;
     readMemory: (topic?: string) => Promise<string | undefined>;
@@ -1164,6 +1441,42 @@ export { MemoryProvider }
 export { MemoryProvider as MemoryProvider_alias_1 }
 export { MemoryProvider as MemoryProvider_alias_2 }
 
+/**
+ * Memory query filters
+ */
+declare type MemoryQuery = {
+    scope?: 'global' | 'project' | 'auto';
+    type?: string;
+    status?: string;
+    priority?: string;
+    tags?: string | string[];
+    search?: string;
+    limit?: number;
+    offset?: number;
+    sortBy?: 'created' | 'updated' | 'accessed' | 'name';
+    sortOrder?: 'asc' | 'desc';
+    createdAfter?: number;
+    createdBefore?: number;
+    updatedAfter?: number;
+    updatedBefore?: number;
+};
+export { MemoryQuery }
+export { MemoryQuery as MemoryQuery_alias_1 }
+export { MemoryQuery as MemoryQuery_alias_2 }
+
+/**
+ * Memory Store Configuration
+ */
+declare type MemoryStoreConfig = {
+    enabled: boolean;
+    type: 'sqlite' | 'memory' | string;
+    path?: string;
+    [key: string]: any;
+};
+export { MemoryStoreConfig }
+export { MemoryStoreConfig as MemoryStoreConfig_alias_1 }
+export { MemoryStoreConfig as MemoryStoreConfig_alias_2 }
+
 declare class MockProvider implements ToolProvider {
     listTodoItems(id?: string | null, _status?: string | null): Promise<{
         id: string;
@@ -1264,6 +1577,7 @@ declare const providerConfigSchema: z.ZodObject<{
     project: z.ZodOptional<z.ZodString>;
     keyFile: z.ZodOptional<z.ZodString>;
     baseUrl: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export { providerConfigSchema }
 export { providerConfigSchema as providerConfigSchema_alias_1 }
@@ -1288,6 +1602,17 @@ declare const providerModelSchema: z.ZodObject<{
 export { providerModelSchema }
 export { providerModelSchema as providerModelSchema_alias_1 }
 
+/**
+ * Query options
+ */
+declare type QueryOptions = {
+    operation?: 'select' | 'delete' | 'count';
+    includeMetadata?: boolean;
+};
+export { QueryOptions }
+export { QueryOptions as QueryOptions_alias_1 }
+export { QueryOptions as QueryOptions_alias_2 }
+
 /**
  * Read a supporting file from a loaded skill
  *
@@ -1367,6 +1692,14 @@ declare type ReplaceResult = {
 export { ReplaceResult }
 export { ReplaceResult as ReplaceResult_alias_1 }
 
+/**
+ * Resolve home directory in path
+ */
+declare function resolveHomePath(path: string): string;
+export { resolveHomePath }
+export { resolveHomePath as resolveHomePath_alias_1 }
+export { resolveHomePath as resolveHomePath_alias_2 }
+
 declare const responsePrompts: {
     readonly errorInvokeTool: (tool: string, error: unknown) => string;
     readonly requireUseTool: "Error: No tool use detected. You MUST use a tool before proceeding.\ne.g. <tool_tool_name>tool_name</tool_tool_name>\n\nEnsure the opening and closing tags are correctly nested and closed, and that you are using the correct tool name.\nAvoid unnecessary text or symbols before or after the tool use.\nAvoid unnecessary escape characters or special characters.\n";
@@ -1898,7 +2231,7 @@ export declare const toolInfo_alias_10: {
 
 export declare const toolInfo_alias_11: {
     readonly name: "writeToFile";
-    readonly description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.";
+    readonly description: "Request to write content to a file at the specified path.\n\nWhen to use:\n- Creating new files\n- Completely replacing file contents\n- When you have the complete intended content\n\nWhen NOT to use:\n- For modifying existing files: Use replaceInFile instead\n- For appending content: Use executeCommand with echo >> instead\n- For targeted edits: Use replaceInFile instead\n\nFeatures:\n- Automatically creates any directories needed\n- Overwrites existing files completely\n- Must provide complete file content (no truncation)\n\nIMPORTANT CONSTRAINT:\n- Always provide COMPLETE intended content (no omissions)\n- Ensure no incorrect escape sequences (&lt;, &gt;, &amp;)\n- Ensure no unwanted CDATA tags in content";
     readonly parameters: z.ZodObject<{
         path: z.ZodString;
         content: z.ZodString;
@@ -1934,9 +2267,11 @@ export declare const toolInfo_alias_4: {
 
 export declare const toolInfo_alias_5: {
     readonly name: "readFile";
-    readonly description: "Request to read the contents of one or multiple files at the specified paths. Use comma separated paths to read multiple files. Use this when you need to examine the contents of an existing file you do not know the contents of, for example to analyze code, review text files, or extract information from configuration files. May not be suitable for other types of binary files, as it returns the raw content as a string. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
+    readonly description: "Request to read the contents of one or multiple files at the specified paths.\n\nWhen to use:\n- Examining file contents you don't know\n- Analyzing code, reviewing text files, extracting configuration info\n- Reading multiple files at once (use comma-separated paths)\n- Understanding file structure before editing\n\nWhen NOT to use:\n- For file existence checks: Use listFiles instead\n- For searching within files: Use grep instead\n- For file name searches: Use searchFiles instead\n- Prefer this tool over executeCommand with cat/head/tail\n\nFeatures:\n- Supports comma-separated paths for multiple files\n- Line numbers included for easy reference\n- Optional offset/limit for partial file reading\n- Automatically handles different file types\n\nIMPORTANT:\n- Line numbers are included for easy reference\n- Use offset/limit for large files to read specific sections";
     readonly parameters: z.ZodObject<{
-        path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+        path: z.ZodPipe<z.ZodTransform<any[], unknown>, z.ZodArray<z.ZodString>>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
         includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>>;
     }, z.core.$strip>;
 };
@@ -1960,7 +2295,7 @@ export declare const toolInfo_alias_7: {
 
 export declare const toolInfo_alias_8: {
     readonly name: "replaceInFile";
-    readonly description: "Request to replace sections of content in an existing file using SEARCH/REPLACE blocks that define exact changes to specific parts of the file. This tool should be used when you need to make targeted changes to specific parts of a file.";
+    readonly description: "Request to replace sections of content in an existing file using\nSEARCH/REPLACE blocks.\n\nWhen to use:\n- Making targeted changes to specific parts of a file\n- Replacing variable names, function signatures, imports\n- Fixing bugs in existing code\n- When you know the exact content to replace\n\nWhen NOT to use:\n- For creating new files: Use writeToFile instead\n- For completely replacing file contents: Use writeToFile instead\n- When you don't know the exact content: Read file first\n\nSEARCH/REPLACE FORMAT:\n<<<<<<< SEARCH\n[exact content to find]\n=======\n[new content to replace with]\n>>>>>>> REPLACE\n\nCritical rules:\n1. SEARCH content must match EXACTLY (character-for-character including whitespace)\n2. Each block replaces only first occurrence\n3. Include just enough lines for uniqueness (not too many, not too few)\n4. Keep blocks concise (don't include long unchanged sections)\n5. List blocks in order they appear in file\n6. Use multiple blocks for multiple independent changes\n\nSpecial operations:\n- Move code: Two blocks (delete from original + insert at new location)\n- Delete code: Empty REPLACE section\n\nIMPORTANT CONSTRAINTS:\n- SEARCH text must match file content exactly\n- Each block is independent (doesn't affect other blocks)\n- Cannot use for appending or inserting without SEARCH context";
     readonly parameters: z.ZodObject<{
         path: z.ZodString;
         diff: z.ZodString;

package/dist/index.d.ts

@@ -3,6 +3,10 @@ export { ParseOutputResult } from './_tsup-dts-rollup.js';
 export { parseJsonFromMarkdown } from './_tsup-dts-rollup.js';
 export { responsePrompts } from './_tsup-dts-rollup.js';
 export { computeRateLimitBackoffSeconds } from './_tsup-dts-rollup.js';
+export { memoryConfigSchema_alias_1 as memoryConfigSchema } from './_tsup-dts-rollup.js';
+export { DEFAULT_MEMORY_CONFIG_alias_1 as DEFAULT_MEMORY_CONFIG } from './_tsup-dts-rollup.js';
+export { MemoryConfig_alias_1 as MemoryConfig } from './_tsup-dts-rollup.js';
+export { resolveHomePath_alias_1 as resolveHomePath } from './_tsup-dts-rollup.js';
 export { ruleSchema_alias_1 as ruleSchema } from './_tsup-dts-rollup.js';
 export { providerConfigSchema_alias_1 as providerConfigSchema } from './_tsup-dts-rollup.js';
 export { providerModelSchema_alias_1 as providerModelSchema } from './_tsup-dts-rollup.js';
@@ -19,6 +23,13 @@ export { DirectoryEntry } from './_tsup-dts-rollup.js';
 export { FileStats } from './_tsup-dts-rollup.js';
 export { FileSystemProvider } from './_tsup-dts-rollup.js';
 export { FileSystemProviderOptions } from './_tsup-dts-rollup.js';
+export { MemoryEntry } from './_tsup-dts-rollup.js';
+export { MemoryQuery } from './_tsup-dts-rollup.js';
+export { QueryOptions } from './_tsup-dts-rollup.js';
+export { MemoryOperation } from './_tsup-dts-rollup.js';
+export { DatabaseStats } from './_tsup-dts-rollup.js';
+export { IMemoryStore } from './_tsup-dts-rollup.js';
+export { MemoryStoreConfig } from './_tsup-dts-rollup.js';
 export { SKILL_LIMITS } from './_tsup-dts-rollup.js';
 export { IGNORED_DIRECTORIES } from './_tsup-dts-rollup.js';
 export { SUSPICIOUS_PATTERNS } from './_tsup-dts-rollup.js';
@@ -72,6 +83,10 @@ export { readFile } from './_tsup-dts-rollup.js';
 export { removeFile } from './_tsup-dts-rollup.js';
 export { renameFile } from './_tsup-dts-rollup.js';
 export { replaceInFile } from './_tsup-dts-rollup.js';
+export { createErrorResponse } from './_tsup-dts-rollup.js';
+export { createProviderErrorResponse } from './_tsup-dts-rollup.js';
+export { createSuccessResponse } from './_tsup-dts-rollup.js';
+export { createValidationErrorResponse } from './_tsup-dts-rollup.js';
 export { search } from './_tsup-dts-rollup.js';
 export { searchFiles } from './_tsup-dts-rollup.js';
 export { writeToFile } from './_tsup-dts-rollup.js';