@lleverage-ai/agent-sdk 0.0.1

package/dist/backends/composite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.js","sourceRoot":"","sources":["../../src/backends/composite.ts"],"names":[],"mappings":"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"}

package/dist/backends/filesystem.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Filesystem backend for disk persistence.
+ *
+ * FilesystemBackend provides file operations on the real filesystem with
+ * security protections against directory traversal, symlink attacks, and
+ * excessive file sizes.
+ *
+ * This backend is ideal for:
+ * - Persistent agents that need to read/write real files
+ * - Development environments
+ * - Local tooling and automation
+ *
+ * @example
+ * ```typescript
+ * const backend = new FilesystemBackend({
+ *   rootDir: process.cwd(),
+ *   maxFileSizeMb: 10,
+ * });
+ *
+ * // Read a file
+ * const content = await backend.read("./src/index.ts");
+ *
+ * // Write a file
+ * await backend.write("./output.txt", "Generated content");
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { BackendProtocol, EditResult, FileData, FileInfo, GrepMatch, WriteResult } from "../backend.js";
+/**
+ * Configuration options for FilesystemBackend.
+ *
+ * @example
+ * ```typescript
+ * const options: FilesystemBackendOptions = {
+ *   rootDir: "/home/user/project",
+ *   maxFileSizeMb: 5,
+ *   followSymlinks: false,
+ * };
+ * ```
+ *
+ * @category Backend
+ */
+export interface FilesystemBackendOptions {
+    /**
+     * Base directory for all operations.
+     * All paths are resolved relative to this directory.
+     * @defaultValue process.cwd()
+     */
+    rootDir?: string;
+    /**
+     * Maximum file size in megabytes for read operations.
+     * Files larger than this will be rejected with an error.
+     * @defaultValue 10
+     */
+    maxFileSizeMb?: number;
+    /**
+     * Whether to follow symbolic links.
+     * When false (default), symlinks are rejected for security.
+     * @defaultValue false
+     */
+    followSymlinks?: boolean;
+    /**
+     * Additional paths that are allowed outside rootDir.
+     * Useful for accessing system paths like /tmp.
+     */
+    allowedPaths?: string[];
+}
+/**
+ * Error thrown when a path traversal attack is detected.
+ *
+ * @category Backend
+ */
+export declare class PathTraversalError extends Error {
+    readonly attemptedPath: string;
+    readonly rootDir: string;
+    constructor(attemptedPath: string, rootDir: string);
+}
+/**
+ * Error thrown when a symlink is encountered and not allowed.
+ *
+ * @category Backend
+ */
+export declare class SymlinkError extends Error {
+    readonly path: string;
+    constructor(path: string);
+}
+/**
+ * Error thrown when a file exceeds the size limit.
+ *
+ * @category Backend
+ */
+export declare class FileSizeLimitError extends Error {
+    readonly path: string;
+    readonly sizeMb: number;
+    readonly limitMb: number;
+    constructor(path: string, sizeMb: number, limitMb: number);
+}
+/**
+ * Filesystem backend implementation for real disk operations.
+ *
+ * Provides secure file operations with protections against:
+ * - Directory traversal attacks (../ paths)
+ * - Symlink attacks
+ * - Excessive file sizes
+ *
+ * @example
+ * ```typescript
+ * const backend = new FilesystemBackend({
+ *   rootDir: "/home/user/project",
+ *   maxFileSizeMb: 10,
+ *   followSymlinks: false,
+ * });
+ *
+ * // List files
+ * const files = await backend.lsInfo("./src");
+ *
+ * // Read with line numbers
+ * const content = await backend.read("./src/index.ts");
+ *
+ * // Search for patterns
+ * const matches = await backend.grepRaw("TODO", "./src", "*.ts");
+ * ```
+ *
+ * @category Backend
+ */
+export declare class FilesystemBackend implements BackendProtocol {
+    private readonly rootDir;
+    private readonly maxFileSizeMb;
+    private readonly followSymlinks;
+    private readonly allowedPaths;
+    /**
+     * Create a new FilesystemBackend.
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: FilesystemBackendOptions);
+    /**
+     * List files and directories at the given path.
+     *
+     * @param dirPath - Directory path to list (non-recursive)
+     * @returns Array of file/directory info
+     */
+    lsInfo(dirPath: string): Promise<FileInfo[]>;
+    /**
+     * Read file content with line numbers.
+     *
+     * @param filePath - Path to the file to read
+     * @param offset - Starting line offset (0-indexed)
+     * @param limit - Maximum number of lines to read
+     * @returns Formatted content with line numbers
+     */
+    read(filePath: string, offset?: number, limit?: number): Promise<string>;
+    /**
+     * Read raw file content as FileData.
+     *
+     * @param filePath - Path to the file to read
+     * @returns Raw file data with content and timestamps
+     */
+    readRaw(filePath: string): Promise<FileData>;
+    /**
+     * Search for pattern matches using regex.
+     *
+     * @param pattern - Regular expression pattern to search for
+     * @param searchPath - Directory to search in (defaults to root)
+     * @param glob - Glob pattern to filter files (e.g., "*.ts")
+     * @returns Array of matches
+     */
+    grepRaw(pattern: string, searchPath?: string | null, glob?: string | null): Promise<GrepMatch[]>;
+    /**
+     * Find files matching a glob pattern.
+     *
+     * @param pattern - Glob pattern (e.g., "**\/*.ts")
+     * @param basePath - Base directory for the search
+     * @returns Array of matching file info
+     */
+    globInfo(pattern: string, basePath?: string): Promise<FileInfo[]>;
+    /**
+     * Create or overwrite a file.
+     *
+     * @param filePath - Path for the file
+     * @param content - Content to write
+     * @returns Result indicating success or failure
+     */
+    write(filePath: string, content: string): Promise<WriteResult>;
+    /**
+     * Edit a file by replacing text.
+     *
+     * @param filePath - Path to the file to edit
+     * @param oldString - Text to find and replace
+     * @param newString - Replacement text
+     * @param replaceAll - If true, replace all occurrences
+     * @returns Result indicating success or failure
+     */
+    edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
+    /**
+     * Resolve a path and validate it's within the allowed boundaries.
+     *
+     * @param inputPath - Path to resolve
+     * @returns Resolved absolute path
+     * @throws {PathTraversalError} If path escapes root directory
+     * @throws {SymlinkError} If path contains a symlink and followSymlinks is false
+     * @internal
+     */
+    private resolvePath;
+    /**
+     * Check if a resolved path is within allowed boundaries.
+     * @internal
+     */
+    private isPathAllowed;
+    /**
+     * Check if a resolved path is within any of the allowed paths.
+     * @internal
+     */
+    private isPathInAllowedPaths;
+    /**
+     * Check for symlinks in path components.
+     * @throws {SymlinkError} If a symlink is found
+     * @internal
+     */
+    private checkSymlinks;
+    /**
+     * Validate file access checking size limits and symlinks.
+     * @throws {FileSizeLimitError} If file exceeds size limit
+     * @throws {SymlinkError} If file is a symlink and not allowed
+     * @internal
+     */
+    private validateFileAccess;
+    /**
+     * Convert an absolute path to a relative path from rootDir.
+     * @internal
+     */
+    private makeRelativePath;
+    /**
+     * Walk a directory recursively and return all file paths.
+     * @internal
+     */
+    private walkDirectory;
+    /**
+     * Check if a path matches a glob pattern.
+     * Supports basic glob patterns: *, **, ?
+     * @internal
+     */
+    private matchesGlob;
+    /**
+     * Type guard for Node.js errors with code property.
+     * @internal
+     */
+    private isNodeError;
+}
+/**
+ * Create a FilesystemBackend with the specified options.
+ *
+ * @param options - Configuration options
+ * @returns A new FilesystemBackend instance
+ *
+ * @example
+ * ```typescript
+ * const backend = createFilesystemBackend({
+ *   rootDir: "/home/user/project",
+ *   maxFileSizeMb: 5,
+ * });
+ * ```
+ *
+ * @category Backend
+ */
+export declare function createFilesystemBackend(options?: FilesystemBackendOptions): FilesystemBackend;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/backends/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/backends/filesystem.ts"],"names":[],"mappings":"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"}