@qodalis/cli-files 2.0.0-beta.17 → 2.0.0-beta.19

package/public-api.d.mts

@@ -1,4 +1,3 @@
-import * as _qodalis_cli_core from '@qodalis/cli-core';
 import { ICliOwnership, CliAccessAction, ICliCommandProcessor, CliProcessCommand, ICliExecutionContext, CliHeadersProvider, ICliFileTransferService, ICliFileEntry, ICliCompletionProvider, ICliCompletionContext, ICliConfigurableModule } from '@qodalis/cli-core';
 import { Subscription } from 'rxjs';
 
@@ -28,7 +27,7 @@ interface IFileNode {
     linkTarget?: string;
 }
 
-declare const IFileSystemService_TOKEN = "cli-file-system-service";
+declare const IFileSystemService_TOKEN: any;
 /**
  * Decides whether the current principal may act on a node. Set by the files
  * module from the generic authorization layer (`cliCanAccess`); when no policy
@@ -81,7 +80,7 @@ interface IFileSystemService {
 declare class CliLsCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
@@ -98,38 +97,42 @@ declare class CliLsCommandProcessor implements ICliCommandProcessor {
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     writeDescription(context: ICliExecutionContext): void;
     private writeLongFormat;
+    private humanReadable;
+    private formatSize;
     private writeShortFormat;
 }
 
 declare class CliCdCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
 declare class CliPwdCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     metadata: {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
 declare class CliMkdirCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -144,13 +147,14 @@ declare class CliMkdirCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
 declare class CliRmdirCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -158,13 +162,14 @@ declare class CliRmdirCommandProcessor implements ICliCommandProcessor {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
 declare class CliTouchCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -172,13 +177,14 @@ declare class CliTouchCommandProcessor implements ICliCommandProcessor {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
 declare class CliCatCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -186,13 +192,14 @@ declare class CliCatCommandProcessor implements ICliCommandProcessor {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
 declare class CliEchoCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     extendsProcessor: boolean;
@@ -201,13 +208,14 @@ declare class CliEchoCommandProcessor implements ICliCommandProcessor {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
 declare class CliRmCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -222,13 +230,14 @@ declare class CliRmCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
 declare class CliCpCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
@@ -242,6 +251,7 @@ declare class CliCpCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parseArgs;
 }
@@ -249,13 +259,14 @@ declare class CliCpCommandProcessor implements ICliCommandProcessor {
 declare class CliMvCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parseArgs;
 }
@@ -263,7 +274,7 @@ declare class CliMvCommandProcessor implements ICliCommandProcessor {
 declare class CliTreeCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
@@ -277,6 +288,7 @@ declare class CliTreeCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "number";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     /** File system of the running command (listing goes through access checks) */
     private fs?;
@@ -286,7 +298,7 @@ declare class CliTreeCommandProcessor implements ICliCommandProcessor {
 declare class CliHeadCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -301,6 +313,7 @@ declare class CliHeadCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "number";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parsePaths;
 }
@@ -308,7 +321,7 @@ declare class CliHeadCommandProcessor implements ICliCommandProcessor {
 declare class CliTailCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -323,6 +336,7 @@ declare class CliTailCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "number";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parsePaths;
 }
@@ -330,7 +344,7 @@ declare class CliTailCommandProcessor implements ICliCommandProcessor {
 declare class CliWcCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -345,14 +359,17 @@ declare class CliWcCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    /** Counts like Unix wc: lines are newline characters. */
+    private count;
     private parsePaths;
 }
 
 declare class CliFindCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
@@ -370,18 +387,23 @@ declare class CliFindCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "number";
     })[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    /** `--name` matches case-sensitively, `--iname` ignoring case. */
+    private nameRegex;
+    private matches;
     private parseSearchPath;
     private globToRegex;
     /** File system of the running command (listing goes through access checks) */
     private fs?;
+    /** Lists the children of `node`, which are at `depth` (1 = direct children). */
     private walk;
 }
 
 declare class CliGrepCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
@@ -395,7 +417,13 @@ declare class CliGrepCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    /**
+     * As Unix grep: 0 when a line matched, 1 when none did, 2 after an
+     * error (so `if grep -q ...` and `grep x f && ...` work).
+     */
+    private exitStatus;
     private grepContent;
     private parseArgs;
     private collectFiles;
@@ -404,7 +432,7 @@ declare class CliGrepCommandProcessor implements ICliCommandProcessor {
 declare class CliTacCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -412,6 +440,7 @@ declare class CliTacCommandProcessor implements ICliCommandProcessor {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parsePaths;
 }
@@ -419,7 +448,7 @@ declare class CliTacCommandProcessor implements ICliCommandProcessor {
 declare class CliBasenameCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -427,6 +456,7 @@ declare class CliBasenameCommandProcessor implements ICliCommandProcessor {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parseTokens;
 }
@@ -434,7 +464,7 @@ declare class CliBasenameCommandProcessor implements ICliCommandProcessor {
 declare class CliDirnameCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -442,6 +472,7 @@ declare class CliDirnameCommandProcessor implements ICliCommandProcessor {
         icon: string;
         module: string;
     };
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parseTokens;
 }
@@ -449,7 +480,7 @@ declare class CliDirnameCommandProcessor implements ICliCommandProcessor {
 declare class CliSortCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -470,6 +501,7 @@ declare class CliSortCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "string";
     })[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parsePaths;
 }
@@ -477,7 +509,7 @@ declare class CliSortCommandProcessor implements ICliCommandProcessor {
 declare class CliUniqCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -492,6 +524,7 @@ declare class CliUniqCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parsePaths;
 }
@@ -499,7 +532,7 @@ declare class CliUniqCommandProcessor implements ICliCommandProcessor {
 declare class CliCutCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -514,6 +547,7 @@ declare class CliCutCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "string";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parseSpec;
     private resolveIndices;
@@ -523,7 +557,7 @@ declare class CliCutCommandProcessor implements ICliCommandProcessor {
 declare class CliPasteCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -544,14 +578,21 @@ declare class CliPasteCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     })[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    /** `-d` list: each character in turn, with \t, \n, \\ and \0 (empty) escapes. */
+    private parseDelimiters;
+    /**
+     * The file operands. The engine drops a lone `-` from the value, so with
+     * piped input they are read from the raw command line to keep it.
+     */
     private parsePaths;
 }
 
 declare class CliTrCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -561,11 +602,14 @@ declare class CliTrCommandProcessor implements ICliCommandProcessor {
     };
     parameters: {
         name: string;
+        aliases: string[];
         description: string;
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private fail;
     private deleteChars;
     private squeezeChars;
     private translateChars;
@@ -574,7 +618,7 @@ declare class CliTrCommandProcessor implements ICliCommandProcessor {
 declare class CliStatCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -583,6 +627,7 @@ declare class CliStatCommandProcessor implements ICliCommandProcessor {
         module: string;
     };
     parameters: never[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parsePaths;
 }
@@ -590,7 +635,7 @@ declare class CliStatCommandProcessor implements ICliCommandProcessor {
 declare class CliChmodCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -604,6 +649,7 @@ declare class CliChmodCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parseArgs;
     private resolvePermissions;
@@ -614,7 +660,7 @@ declare class CliChmodCommandProcessor implements ICliCommandProcessor {
 declare class CliChownCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -628,6 +674,7 @@ declare class CliChownCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parseArgs;
     /** Parse "user:group", "user:", ":group", or "user" */
@@ -638,10 +685,9 @@ declare class CliChownCommandProcessor implements ICliCommandProcessor {
 declare class CliDuCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
-    valueRequired: boolean;
     metadata: {
         icon: string;
         module: string;
@@ -659,6 +705,7 @@ declare class CliDuCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "number";
     })[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parseArgs;
     /** File system of the running command (listing goes through access checks) */
@@ -670,7 +717,7 @@ declare class CliDuCommandProcessor implements ICliCommandProcessor {
 declare class CliLnCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -678,12 +725,20 @@ declare class CliLnCommandProcessor implements ICliCommandProcessor {
         icon: string;
         module: string;
     };
-    parameters: {
+    parameters: ({
         name: string;
         description: string;
         required: boolean;
         type: "boolean";
-    }[];
+        aliases?: undefined;
+    } | {
+        name: string;
+        aliases: string[];
+        description: string;
+        required: boolean;
+        type: "boolean";
+    })[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private parseArgs;
 }
@@ -691,7 +746,7 @@ declare class CliLnCommandProcessor implements ICliCommandProcessor {
 declare class CliSedCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
@@ -709,21 +764,41 @@ declare class CliSedCommandProcessor implements ICliCommandProcessor {
         aliases: string[];
         description: string;
         required: boolean;
-        type: "string";
+        type: "array";
     })[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    private writeLines;
+    /** Runs the script over the lines and returns the output lines. */
+    private run;
+    /** `&` is the match, `\1`..`\9` the groups, `\n` a newline, `\x` a literal x. */
+    private expandReplacement;
     private parseRawCommand;
     private tokenize;
-    private parseExpression;
+    /** Commands of a script, separated by `;` or newlines. */
+    private parseScript;
+    private parseCommand;
     private parseAddress;
+    /**
+     * Text up to the next unescaped delimiter, escapes kept (an escaped
+     * delimiter becomes the plain character when it has no regex meaning).
+     */
+    private readDelimited;
+    /**
+     * Basic regular expressions use \( \) \{ \} \+ \? \| for groups and
+     * operators. When a pattern uses them (or never in -E mode), they are
+     * turned into the JavaScript form and the bare characters made literal.
+     */
+    private toJsRegex;
     private parseSubstitution;
     private addressMatches;
+    private singleMatches;
 }
 
 declare class CliAwkCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
@@ -737,8 +812,16 @@ declare class CliAwkCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "string";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    /**
+     * The program is the first operand, usually quoted. Unquoted, it may span
+     * several words (`awk {print $1} file`): it is then everything before the
+     * trailing operands that are existing files, or the whole value with
+     * piped input.
+     */
     private parseArgs;
+    private bracesBalanced;
     private parseProgram;
     private findMatchingBrace;
     private matchesPattern;
@@ -758,7 +841,7 @@ declare class CliAwkCommandProcessor implements ICliCommandProcessor {
 declare class CliDiffCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -773,6 +856,7 @@ declare class CliDiffCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     private linesEqual;
     private computeLCS;
@@ -784,7 +868,7 @@ declare class CliDiffCommandProcessor implements ICliCommandProcessor {
 declare class CliTeeCommandProcessor implements ICliCommandProcessor {
     command: string;
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -799,15 +883,15 @@ declare class CliTeeCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "boolean";
     }[];
+    writeDescription(context: ICliExecutionContext): void;
     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;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     valueRequired: boolean;
@@ -828,28 +912,24 @@ declare class CliXargsCommandProcessor implements ICliCommandProcessor {
         required: boolean;
         type: "number";
     })[];
+    writeDescription(context: ICliExecutionContext): void;
     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
+ * Scripts run through the engine's shell runner (`@qodalis/cli`
+ * `runScript`): commands, `;`, comments, `set -e`/`set +e`, `VAR=value`,
+ * `if`/`elif`/`else`/`fi`, `for`/`while`/`until` loops, `break`/`continue`,
+ * `exit`, and `test`/`[ ]` conditions.
  */
 declare class CliShCommandProcessor implements ICliCommandProcessor {
     command: string;
     aliases: string[];
     description: string;
-    author: _qodalis_cli_core.ICliCommandAuthor;
+    author: any;
     version: string;
     acceptsRawInput: boolean;
     metadata: {
@@ -867,9 +947,8 @@ declare class CliShCommandProcessor implements ICliCommandProcessor {
     writeDescription(context: ICliExecutionContext): void;
 }
 /**
- * Parse and execute script content line by line.
- *
- * Exported so the executor can reuse it for `./script.sh` execution.
+ * Execute script content with the engine's shell runner (control flow,
+ * variables, `set -e`), the same one used for `./script.sh`.
  */
 declare function executeScript(content: string, context: ICliExecutionContext): Promise<void>;
 
@@ -1081,4 +1160,5 @@ interface ICliFilesModule extends ICliConfigurableModule<CliFilesModuleConfig> {
 }
 declare const filesModule: ICliFilesModule;
 
-export { ANONYMOUS_OWNERSHIP, CliAwkCommandProcessor, CliBasenameCommandProcessor, CliCatCommandProcessor, CliCdCommandProcessor, CliChmodCommandProcessor, CliChownCommandProcessor, CliCpCommandProcessor, CliCutCommandProcessor, CliDiffCommandProcessor, CliDirnameCommandProcessor, CliDuCommandProcessor, CliEchoCommandProcessor, type CliFileAccessPolicy, type CliFilesModuleConfig, CliFilesPermissions, 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, HOME_DIR_PERMISSIONS, type IFileNode, type IFileSystemService, IFileSystemService_TOKEN, IndexedDbFileSystemService, SYSTEM_OWNERSHIP, type ServerFileSystemOptions, ServerFileSystemService, VirtualFsFileTransferService, createFileAccessPolicy, executeScript, filesModule, followUserAccounts, followUserSession };
+export { ANONYMOUS_OWNERSHIP, CliAwkCommandProcessor, CliBasenameCommandProcessor, CliCatCommandProcessor, CliCdCommandProcessor, CliChmodCommandProcessor, CliChownCommandProcessor, CliCpCommandProcessor, CliCutCommandProcessor, CliDiffCommandProcessor, CliDirnameCommandProcessor, CliDuCommandProcessor, CliEchoCommandProcessor, CliFilesPermissions, 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, HOME_DIR_PERMISSIONS, IFileSystemService_TOKEN, IndexedDbFileSystemService, SYSTEM_OWNERSHIP, ServerFileSystemService, VirtualFsFileTransferService, createFileAccessPolicy, executeScript, filesModule, followUserAccounts, followUserSession };
+export type { CliFileAccessPolicy, CliFilesModuleConfig, IFileNode, IFileSystemService, ServerFileSystemOptions };