@qodalis/cli-files 2.0.0-beta.1

package/public-api.d.ts

@@ -0,0 +1,995 @@
+import * as _qodalis_cli_core from '@qodalis/cli-core';
+import { ICliOwnership, ICliCommandProcessor, CliProcessCommand, ICliExecutionContext, ICliFileTransferService, ICliFileEntry, ICliCompletionProvider, ICliCompletionContext, ICliModule } from '@qodalis/cli-core';
+
+/**
+ * Represents a node in the virtual filesystem (file or directory).
+ */
+interface IFileNode {
+    /** Name of the file or directory */
+    name: string;
+    /** Node type */
+    type: 'file' | 'directory';
+    /** File content (text only, undefined for directories) */
+    content?: string;
+    /** Child nodes (only for directories) */
+    children?: IFileNode[];
+    /** Creation timestamp (ms since epoch) */
+    createdAt: number;
+    /** Last modification timestamp (ms since epoch) */
+    modifiedAt: number;
+    /** Size in bytes (content length for files, 0 for directories) */
+    size: number;
+    /** Unix-style permission string (e.g. "rwxr-xr-x") */
+    permissions?: string;
+    /** Owner and group metadata */
+    ownership?: ICliOwnership;
+    /** Target path for symbolic links */
+    linkTarget?: string;
+}
+
+declare const IFileSystemService_TOKEN = "cli-file-system-service";
+/**
+ * Abstraction for virtual filesystem operations.
+ */
+interface IFileSystemService {
+    getCurrentDirectory(): string;
+    setCurrentDirectory(path: string): void;
+    resolvePath(path: string): string;
+    getHomePath(): string;
+    setHomePath(path: string): void;
+    setCurrentUser(uid: string, groups: string[]): void;
+    getNode(path: string): IFileNode | null;
+    listDirectory(path: string): IFileNode[];
+    readFile(path: string): string | null;
+    exists(path: string): boolean;
+    isDirectory(path: string): boolean;
+    createDirectory(path: string, recursive?: boolean): void;
+    createFile(path: string, content?: string): void;
+    writeFile(path: string, content: string, append?: boolean): void;
+    remove(path: string, recursive?: boolean): void;
+    copy(src: string, dest: string, recursive?: boolean): void;
+    move(src: string, dest: string): void;
+    chmod(path: string, permissions: string): void;
+    chown(path: string, ownership: ICliOwnership): void;
+    initialize(): Promise<void>;
+    persist(): Promise<void>;
+}
+
+declare class CliLsCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    writeDescription(context: ICliExecutionContext): void;
+    private writeLongFormat;
+    private writeShortFormat;
+}
+
+declare class CliCdCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+}
+
+declare class CliPwdCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+}
+
+declare class CliMkdirCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+}
+
+declare class CliRmdirCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+}
+
+declare class CliTouchCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+}
+
+declare class CliCatCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+}
+
+declare class CliEchoCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    extendsProcessor: boolean;
+    originalProcessor?: ICliCommandProcessor;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+}
+
+declare class CliRmCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+}
+
+declare class CliCpCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseArgs;
+}
+
+declare class CliMvCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseArgs;
+}
+
+declare class CliTreeCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "number";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private printTree;
+}
+
+declare class CliHeadCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "number";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parsePaths;
+}
+
+declare class CliTailCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "number";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parsePaths;
+}
+
+declare class CliWcCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parsePaths;
+}
+
+declare class CliFindCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: ({
+        name: string;
+        description: string;
+        required: boolean;
+        type: "string";
+    } | {
+        name: string;
+        description: string;
+        required: boolean;
+        type: "number";
+    })[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseSearchPath;
+    private globToRegex;
+    private walk;
+}
+
+declare class CliGrepCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private grepContent;
+    private parseArgs;
+    private collectFiles;
+}
+
+declare class CliTacCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parsePaths;
+}
+
+declare class CliBasenameCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseTokens;
+}
+
+declare class CliDirnameCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseTokens;
+}
+
+declare class CliSortCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: ({
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    } | {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "string";
+    })[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parsePaths;
+}
+
+declare class CliUniqCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parsePaths;
+}
+
+declare class CliCutCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "string";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseSpec;
+    private resolveIndices;
+    private parsePaths;
+}
+
+declare class CliPasteCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: ({
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "string";
+    } | {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    })[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parsePaths;
+}
+
+declare class CliTrCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private deleteChars;
+    private squeezeChars;
+    private translateChars;
+}
+
+declare class CliStatCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: never[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parsePaths;
+}
+
+declare class CliChmodCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseArgs;
+    private resolvePermissions;
+    private octalToPermString;
+    private applyPermissions;
+}
+
+declare class CliChownCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseArgs;
+    /** Parse "user:group", "user:", ":group", or "user" */
+    private parseOwnerSpec;
+    private applyOwnership;
+}
+
+declare class CliDuCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: ({
+        name: string;
+        description: string;
+        required: boolean;
+        type: "boolean";
+        aliases?: undefined;
+    } | {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "number";
+    })[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseArgs;
+    private collectSizes;
+    private formatSize;
+}
+
+declare class CliLnCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseArgs;
+}
+
+declare class CliSedCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: ({
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    } | {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "string";
+    })[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseRawCommand;
+    private tokenize;
+    private parseExpression;
+    private parseAddress;
+    private parseSubstitution;
+    private addressMatches;
+}
+
+declare class CliAwkCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "string";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private parseArgs;
+    private parseProgram;
+    private findMatchingBrace;
+    private matchesPattern;
+    private getFieldValue;
+    private compareValues;
+    private executeAction;
+    private executePrint;
+    private splitByComma;
+    private evaluateConcatExpr;
+    private tokenizeExpr;
+    private resolveToken;
+    private executeAssignment;
+    private evaluateNumericExpr;
+    private escapeRegex;
+}
+
+declare class CliDiffCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private linesEqual;
+    private computeLCS;
+    private outputNormal;
+    private outputUnified;
+    private parsePaths;
+}
+
+declare class CliTeeCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private getAllPaths;
+    private parseArgs;
+}
+
+declare class CliXargsCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    valueRequired: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: ({
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "string";
+    } | {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "number";
+    })[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private getAllNonFlagTokens;
+    private escapeRegex;
+    private parseArgs;
+}
+
+/**
+ * Execute a script file containing CLI commands.
+ *
+ * Supported syntax inside scripts:
+ *   - One command per line (pipes, operators, redirects all work)
+ *   - `# comment` lines and blank lines are ignored
+ *   - `set -e` (default) — stop on first error
+ *   - `set +e` — continue on errors
+ *   - `VAR=value` — variable assignment (script-scoped)
+ *   - `$VAR` / `${VAR}` — variable substitution
+ */
+declare class CliShCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    aliases: string[];
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    version: string;
+    acceptsRawInput: boolean;
+    metadata: {
+        icon: string;
+        module: string;
+    };
+    parameters: {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    }[];
+    processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    writeDescription(context: ICliExecutionContext): void;
+}
+/**
+ * Parse and execute script content line by line.
+ *
+ * Exported so the executor can reuse it for `./script.sh` execution.
+ */
+declare function executeScript(content: string, context: ICliExecutionContext): Promise<void>;
+
+declare class IndexedDbFileSystemService implements IFileSystemService {
+    private root;
+    private cwd;
+    private homePath;
+    private currentUid;
+    private currentGroups;
+    setCurrentUser(uid: string, groups: string[]): void;
+    private getDefaultOwnership;
+    getCurrentDirectory(): string;
+    setCurrentDirectory(path: string): void;
+    getHomePath(): string;
+    setHomePath(path: string): void;
+    resolvePath(path: string): string;
+    getNode(path: string): IFileNode | null;
+    listDirectory(path: string): IFileNode[];
+    readFile(path: string): string | null;
+    exists(path: string): boolean;
+    isDirectory(path: string): boolean;
+    createDirectory(path: string, recursive?: boolean): void;
+    createFile(path: string, content?: string): void;
+    writeFile(path: string, content: string, append?: boolean): void;
+    remove(path: string, recursive?: boolean): void;
+    copy(src: string, dest: string, recursive?: boolean): void;
+    move(src: string, dest: string): void;
+    chmod(path: string, permissions: string): void;
+    chown(path: string, ownership: ICliOwnership): void;
+    initialize(): Promise<void>;
+    persist(): Promise<void>;
+    private cloneNode;
+    private openDb;
+    private idbGet;
+}
+
+/**
+ * Configuration options for the ServerFileSystemService.
+ */
+interface ServerFileSystemOptions {
+    /** Base URL of the CLI server, e.g. 'http://localhost:8047' */
+    baseUrl: string;
+}
+/**
+ * IFileSystemService implementation that delegates operations to a CLI server's
+ * `/api/cli/fs/*` REST endpoints.
+ *
+ * Because the IFileSystemService interface is synchronous, this service maintains
+ * an in-memory file tree that is returned immediately by read operations. Write
+ * operations update the local tree first (for instant feedback) and then fire
+ * asynchronous requests to the server for persistence. The `initialize()` method
+ * fetches the initial directory listing from the server.
+ */
+declare class ServerFileSystemService implements IFileSystemService {
+    private root;
+    private cwd;
+    private homePath;
+    private currentUid;
+    private currentGroups;
+    private readonly baseUrl;
+    constructor(options: ServerFileSystemOptions);
+    setCurrentUser(uid: string, groups: string[]): void;
+    private getDefaultOwnership;
+    getCurrentDirectory(): string;
+    setCurrentDirectory(path: string): void;
+    getHomePath(): string;
+    setHomePath(path: string): void;
+    resolvePath(path: string): string;
+    getNode(path: string): IFileNode | null;
+    listDirectory(path: string): IFileNode[];
+    readFile(path: string): string | null;
+    exists(path: string): boolean;
+    isDirectory(path: string): boolean;
+    createDirectory(path: string, recursive?: boolean): void;
+    createFile(path: string, content?: string): void;
+    writeFile(path: string, content: string, append?: boolean): void;
+    remove(path: string, recursive?: boolean): void;
+    copy(src: string, dest: string, recursive?: boolean): void;
+    move(src: string, dest: string): void;
+    chmod(path: string, permissions: string): void;
+    chown(path: string, ownership: ICliOwnership): void;
+    /**
+     * Fetches the root directory listing from the server and populates the
+     * local in-memory file tree. Recursively loads subdirectories.
+     */
+    initialize(): Promise<void>;
+    /**
+     * No-op for server-backed storage — the server persists automatically.
+     */
+    persist(): Promise<void>;
+    private serverFetch;
+    private serverLs;
+    private serverCat;
+    private serverStat;
+    private serverMkdir;
+    private serverUpload;
+    private serverRm;
+    /**
+     * Recursively loads directory contents from the server into a local node.
+     */
+    private loadDirectoryFromServer;
+    /**
+     * Uploads all file nodes under the given path to the server.
+     * Used after copy/move to sync the local tree to the server.
+     */
+    private syncTreeToServer;
+    private cloneNode;
+}
+
+declare class VirtualFsFileTransferService implements ICliFileTransferService {
+    private readonly _fs;
+    private readonly _browserService;
+    constructor(_fs: IFileSystemService);
+    readFile(path: string): Promise<string | null>;
+    writeFile(path: string, content: string): Promise<void>;
+    listFiles(path: string): Promise<ICliFileEntry[]>;
+    exists(path: string): Promise<boolean>;
+    downloadToBrowser(filename: string, content: string | Blob): void;
+    uploadFromBrowser(accept?: string): Promise<{
+        name: string;
+        content: string;
+    } | null>;
+}
+
+/**
+ * Provides tab-completion for file and directory names from the virtual filesystem.
+ * Priority 50 (checked before command/parameter providers for file-related commands).
+ */
+declare class FilePathCompletionProvider implements ICliCompletionProvider {
+    private readonly fs;
+    priority: number;
+    constructor(fs: IFileSystemService);
+    getCompletions(context: ICliCompletionContext): string[];
+    private completePath;
+}
+
+/**
+ * Configuration options for the files module.
+ */
+interface CliFilesModuleConfig {
+    /**
+     * Whether to show the current working directory in the CLI prompt.
+     * @default true
+     */
+    showPathInPrompt?: boolean;
+}
+interface ICliFilesModule extends ICliModule {
+    configure(config: CliFilesModuleConfig): ICliModule;
+}
+declare const filesModule: ICliFilesModule;
+
+export { CliAwkCommandProcessor, CliBasenameCommandProcessor, CliCatCommandProcessor, CliCdCommandProcessor, CliChmodCommandProcessor, CliChownCommandProcessor, CliCpCommandProcessor, CliCutCommandProcessor, CliDiffCommandProcessor, CliDirnameCommandProcessor, CliDuCommandProcessor, CliEchoCommandProcessor, type CliFilesModuleConfig, CliFindCommandProcessor, CliGrepCommandProcessor, CliHeadCommandProcessor, CliLnCommandProcessor, CliLsCommandProcessor, CliMkdirCommandProcessor, CliMvCommandProcessor, CliPasteCommandProcessor, CliPwdCommandProcessor, CliRmCommandProcessor, CliRmdirCommandProcessor, CliSedCommandProcessor, CliShCommandProcessor, CliSortCommandProcessor, CliStatCommandProcessor, CliTacCommandProcessor, CliTailCommandProcessor, CliTeeCommandProcessor, CliTouchCommandProcessor, CliTrCommandProcessor, CliTreeCommandProcessor, CliUniqCommandProcessor, CliWcCommandProcessor, CliXargsCommandProcessor, FilePathCompletionProvider, type IFileNode, type IFileSystemService, IFileSystemService_TOKEN, IndexedDbFileSystemService, type ServerFileSystemOptions, ServerFileSystemService, VirtualFsFileTransferService, executeScript, filesModule };