@fnndsc/chili 3.3.0 → 3.5.0

package/dist/path/pathCommand.js

@@ -16,6 +16,7 @@ import open from "open";
 import { execFile } from "child_process";
 import os from "os";
 import { files_downloadWithProgress } from "../commands/fs/download.js";
+import { chiliErrLog, chiliLog } from "../screen/output.js";
 /**
  * Creates a summary table for file transfer details.
  *
@@ -166,7 +167,7 @@ async function mermaid_renderServerSide(mermaidDefinition, outputFile) {
     return new Promise((resolve, reject) => {
         execFile("npx", ["mmdc", "-i", inputFile, "-o", outputFile], (error) => {
             if (error) {
-                console.error(`Mermaid render failed. Ensure @mermaid-js/mermaid-cli is available (npx mmdc): ${error.message}`);
+                chiliErrLog(`Mermaid render failed. Ensure @mermaid-js/mermaid-cli is available (npx mmdc): ${error.message}`);
                 reject(error);
                 return;
             }
@@ -412,10 +413,10 @@ async function scanResult_render(scanResult, options) {
             try {
                 const outputFile = path.resolve(options.save);
                 const savedFilePath = await mermaid_renderServerSide(mermaidDefinition, outputFile);
-                console.log(`Mermaid diagram saved to: ${savedFilePath}`);
+                chiliLog(`Mermaid diagram saved to: ${savedFilePath}`);
             }
             catch (error) {
-                console.error(`Failed to save Mermaid diagram: ${error}`);
+                chiliErrLog(`Failed to save Mermaid diagram: ${error}`);
             }
         }
         else {
@@ -424,16 +425,16 @@ async function scanResult_render(scanResult, options) {
         return;
     }
     if (options.tree) {
-        console.log(archyTree_create(scanResult.fileInfo));
+        chiliLog(archyTree_create(scanResult.fileInfo));
         return;
     }
     if (!options.silent) {
         for (const file of scanResult.fileInfo) {
             if (file.isLink && !options.follow) {
-                console.log(`${file.chrisPath} -> ${file.linkTarget}`);
+                chiliLog(`${file.chrisPath} -> ${file.linkTarget}`);
             }
             else {
-                console.log(`${file.chrisPath}`);
+                chiliLog(`${file.chrisPath}`);
             }
         }
     }
@@ -447,24 +448,24 @@ async function scanResult_render(scanResult, options) {
 export async function scan_do(options) {
     const chrisFolder = await chrisContext.current_get(Context.ChRISfolder);
     if (!chrisFolder) {
-        console.error(chalk.red("No ChRIS folder context set. Use 'folder=' to set a context."));
+        chiliErrLog(chalk.red("No ChRIS folder context set. Use 'folder=' to set a context."));
         return null;
     }
     if (!options.silent) {
-        console.log(chalk.cyan(`Scanning for ${options.dirsOnly ? "directories" : "all files"} recursively from ${chrisFolder}`));
+        chiliLog(chalk.cyan(`Scanning for ${options.dirsOnly ? "directories" : "all files"} recursively from ${chrisFolder}`));
     }
     const hostBasePath = options.hostpath || process.cwd();
     const scanResult = await chrisFS_scan(chrisFolder, hostBasePath, options.follow, options.dirsOnly);
     if (!scanResult) {
-        console.error(chalk.red("Failed to scan ChRIS filesystem."));
+        chiliErrLog(chalk.red("Failed to scan ChRIS filesystem."));
         return null;
     }
     const filtered = scanResult_filter(scanResult, options);
     await scanResult_render(filtered, options);
     if (!options.silent) {
-        console.log(chalk.green(`Total size: ${bytes_format(filtered.totalSize)}`));
+        chiliLog(chalk.green(`Total size: ${bytes_format(filtered.totalSize)}`));
         if (options.filter || options.endsWith) {
-            console.log(chalk.cyan(`Filtered results: ${filtered.fileInfo.length} items`));
+            chiliLog(chalk.cyan(`Filtered results: ${filtered.fileInfo.length} items`));
         }
     }
     return filtered;
@@ -517,25 +518,25 @@ async function localFS_scan(options) {
     await chrisContext.currentContext_update();
     const folder = chrisContext.singleContext.folder;
     if (!folder) {
-        console.error("ChRIS folder context is undefined, cannot initialize chrisIO.");
+        chiliErrLog("ChRIS folder context is undefined, cannot initialize chrisIO.");
         return null;
     }
     // Validate that the folder context exists in CUBE before proceeding
     try {
         const testGroup = await objContext_create("ChRISDirsContext", `folder:${folder}`);
         if (!testGroup) {
-            console.error(chalk.red(`Folder context '${folder}' does not exist in CUBE. Please specify an existing directory.`));
+            chiliErrLog(chalk.red(`Folder context '${folder}' does not exist in CUBE. Please specify an existing directory.`));
             return null;
         }
     }
     catch (error) {
-        console.error(chalk.red(`Folder context '${folder}' does not exist in CUBE. Please specify an existing directory.`));
+        chiliErrLog(chalk.red(`Folder context '${folder}' does not exist in CUBE. Please specify an existing directory.`));
         return null;
     }
     // Folder exists, so just set chrisFolder without calling init()
     // (init() tries to CREATE the folder which will fail if it already exists)
     chrisIO.chrisFolder = folder;
-    console.log(border_draw(chalk.cyan("Scanning files to upload...")));
+    chiliLog(border_draw(chalk.cyan("Scanning files to upload...")));
     const filesToUpload = await filesToUpload_get(options.hostpath, folder);
     let totalSize = 0;
     for (const file of filesToUpload) {
@@ -643,12 +644,12 @@ async function chris_pull(scanRecord, progressBar) {
             }
             else {
                 summary.failedCount++;
-                console.log(chalk.yellow(`Failed to download: ${file.hostPath}`));
+                chiliLog(chalk.yellow(`Failed to download: ${file.hostPath}`));
             }
         }
         catch (error) {
             summary.failedCount++;
-            console.log(chalk.red(`Error downloading ${file.hostPath}: ${error instanceof Error ? error.message : String(error)}`));
+            chiliLog(chalk.red(`Error downloading ${file.hostPath}: ${error instanceof Error ? error.message : String(error)}`));
         }
         progressBar.update(index + 1, {
             bytes: bytes_format(summary.transferSize), // Renamed
@@ -685,12 +686,12 @@ async function chris_push(scanRecord, progressBar) {
             }
             else {
                 summary.failedCount++;
-                console.log(chalk.yellow(`Failed to upload: ${file.hostPath}`));
+                chiliLog(chalk.yellow(`Failed to upload: ${file.hostPath}`));
             }
         }
         catch (error) {
             summary.failedCount++;
-            console.log(chalk.red(`Error uploading ${file.hostPath}: ${error instanceof Error ? error.message : String(error)}`));
+            chiliLog(chalk.red(`Error uploading ${file.hostPath}: ${error instanceof Error ? error.message : String(error)}`));
         }
         progressBar.update(index + 1, {
             bytes: bytes_format(summary.transferSize), // Renamed
@@ -713,7 +714,7 @@ async function download_handle(options) {
     await chrisContext.currentContext_update();
     const folder = chrisContext.singleContext.folder;
     if (!folder) {
-        console.error(chalk.red("No ChRIS folder context set. Use 'connect' to establish a session."));
+        chiliErrLog(chalk.red("No ChRIS folder context set. Use 'connect' to establish a session."));
         return false;
     }
     const localTarget = path.resolve(options.hostpath || process.cwd());
@@ -728,7 +729,7 @@ async function download_handle(options) {
     }
     catch (error) {
         const msg = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`Download failed: ${msg}`));
+        chiliErrLog(chalk.red(`Download failed: ${msg}`));
         return false;
     }
 }
@@ -788,7 +789,7 @@ export async function pathCommand_setup(program) {
             hostpath: hostpath || process.cwd(),
             force: options.force,
         });
-        console.log(result);
+        chiliLog(result);
     });
     pathCommand
         .command("scan")

package/dist/plugins/pluginGroupHandler.d.ts

@@ -5,6 +5,7 @@
  */
 import { Command } from "commander";
 import { CLIoptions } from "../utils/cli.js";
+import { type CommandEnvelope } from "@fnndsc/cumin";
 /**
  * Handles commands related to groups of plugin contexts (computes, instances, parameters).
  */
@@ -33,6 +34,23 @@ export declare class PluginContextGroupHandler {
      * Lists available fields for the current plugin context resource.
      */
     parameters_fieldsList(): Promise<void>;
+    /**
+     * Renders plugin parameters in "man page" style as an envelope.
+     *
+     * Sans-I/O counterpart to {@link parameters_listMan}.
+     *
+     * @param options - CLI options for filtering.
+     * @returns An envelope carrying the rendered parameters or an error.
+     */
+    parameters_listManRender(options: CLIoptions): Promise<CommandEnvelope>;
+    /**
+     * Renders available fields for the current plugin context resource as an envelope.
+     *
+     * Sans-I/O counterpart to {@link parameters_fieldsList}.
+     *
+     * @returns An envelope carrying the field listing.
+     */
+    parameters_fieldsRender(): Promise<CommandEnvelope>;
     /**
      * Sets up the Commander.js commands for plugin context group operations.
      *

package/dist/plugins/pluginGroupHandler.js

@@ -6,7 +6,9 @@
 import { BaseGroupHandler } from "../handlers/baseGroupHandler.js";
 import { options_toParams } from "../utils/cli.js";
 import { PluginContextController } from "../controllers/pluginContextController.js";
-import { pluginParameters_renderMan } from "../views/pluginParameters.js";
+import { pluginParameters_renderMan, pluginParameters_manRender } from "../views/pluginParameters.js";
+import { envelope_ok, envelope_error } from "@fnndsc/cumin";
+import { chiliErrLog, chiliLog } from "../screen/output.js";
 class InitializationError extends Error {
     constructor(message) {
         super(message);
@@ -52,7 +54,7 @@ export class PluginContextGroupHandler {
             // We access the asset directly from the controller
             const asset = this.controller.chrisObject.asset;
             if (!asset || typeof asset.resources_listAndFilterByOptions !== 'function') {
-                console.error("Underlying resource does not support listing.");
+                chiliErrLog("Underlying resource does not support listing.");
                 return;
             }
             const params = options_toParams(options);
@@ -61,11 +63,11 @@ export class PluginContextGroupHandler {
                 pluginParameters_renderMan(results);
             }
             else {
-                console.log("No parameters found.");
+                chiliLog("No parameters found.");
             }
         }
         catch (error) {
-            console.error(`Error listing parameters: ${error}`);
+            chiliErrLog(`Error listing parameters: ${error}`);
         }
     }
     /**
@@ -76,6 +78,44 @@ export class PluginContextGroupHandler {
             await this.baseGroupHandler.resourceFields_list();
         }
     }
+    /**
+     * Renders plugin parameters in "man page" style as an envelope.
+     *
+     * Sans-I/O counterpart to {@link parameters_listMan}.
+     *
+     * @param options - CLI options for filtering.
+     * @returns An envelope carrying the rendered parameters or an error.
+     */
+    async parameters_listManRender(options) {
+        try {
+            const asset = this.controller.chrisObject.asset;
+            if (!asset || typeof asset.resources_listAndFilterByOptions !== 'function') {
+                return envelope_error('', undefined, "Underlying resource does not support listing.\n");
+            }
+            const params = options_toParams(options);
+            const results = await asset.resources_listAndFilterByOptions(params);
+            if (results) {
+                return envelope_ok(`${pluginParameters_manRender(results)}\n`);
+            }
+            return envelope_ok("No parameters found.\n");
+        }
+        catch (error) {
+            return envelope_error('', undefined, `Error listing parameters: ${error}\n`);
+        }
+    }
+    /**
+     * Renders available fields for the current plugin context resource as an envelope.
+     *
+     * Sans-I/O counterpart to {@link parameters_fieldsList}.
+     *
+     * @returns An envelope carrying the field listing.
+     */
+    async parameters_fieldsRender() {
+        if (this.baseGroupHandler) {
+            return this.baseGroupHandler.resourceFields_render();
+        }
+        return envelope_ok('');
+    }
     /**
      * Sets up the Commander.js commands for plugin context group operations.
      *

package/dist/plugins/pluginHandler.js

@@ -13,6 +13,7 @@ import { pluginIds_resolve } from "../commands/plugin/search.js";
 import { pluginRun_render } from "../views/plugin.js"; // Still needed for pluginRun_render
 import chalk from "chalk";
 import { pluginReadme_render } from "../commands/plugin/readme.js";
+import { chiliErrLog, chiliLog } from "../screen/output.js";
 /**
  * Handles commands related to groups of ChRIS plugins.
  */
@@ -34,10 +35,10 @@ export class PluginGroupHandler {
     // async plugins_list(options: CLIoptions): Promise<void> {
     //   try {
     //     const { plugins, selectedFields } = await plugins_fetchList(options);
-    //     console.log(pluginList_render(plugins, selectedFields, { table: options.table, csv: options.csv }));
+    //     chiliLog(pluginList_render(plugins, selectedFields, { table: options.table, csv: options.csv }));
     //   } catch (error: unknown) {
     //     const msg = error instanceof Error ? error.message : String(error);
-    //     console.error(msg);
+    //     chiliErrLog(msg);
     //   }
     // }
     /**
@@ -50,11 +51,11 @@ export class PluginGroupHandler {
                 table_display(fields, ["fields"]);
             }
             else {
-                console.log(`No resource fields found for ${this.assetName}.`);
+                chiliLog(`No resource fields found for ${this.assetName}.`);
             }
         }
         catch (error) {
-            console.log(errorStack.stack_search(this.assetName)[0]);
+            chiliLog(errorStack.stack_search(this.assetName)[0]);
         }
     }
     /**
@@ -67,12 +68,12 @@ export class PluginGroupHandler {
         for (const search of searchables) {
             const items = await plugins_searchByTerm(search.raw);
             if (items.length === 0) {
-                console.log(`No plugins found matching: ${search.raw}`);
+                chiliLog(`No plugins found matching: ${search.raw}`);
                 continue;
             }
             for (const item of items) {
                 // Show item info - reusing table_display for single item details if possible, or simple log
-                console.log(`Preparing to delete Plugin: ID=${item.id}, Name=${item.name}, Version=${item.version}`);
+                chiliLog(`Preparing to delete Plugin: ID=${item.id}, Name=${item.name}, Version=${item.version}`);
                 if (!options.force) {
                     const confirmed = await prompt_confirm(`Are you sure you want to delete plugin ${item.name} (ID: ${item.id})?`);
                     if (!confirmed)
@@ -80,10 +81,10 @@ export class PluginGroupHandler {
                 }
                 const success = await plugin_deleteById(item.id);
                 if (success) {
-                    console.log(`Deleted plugin ${item.id}`);
+                    chiliLog(`Deleted plugin ${item.id}`);
                 }
                 else {
-                    console.error(`Failed to delete plugin ${item.id}`);
+                    chiliErrLog(`Failed to delete plugin ${item.id}`);
                 }
             }
         }
@@ -161,11 +162,11 @@ export class PluginMemberHandler {
     async readme_print(repoUrl) {
         const content = await this.controller.readmeContent_fetch(repoUrl);
         if (content) {
-            console.log(chalk.green.bold("\nREADME Content:"));
-            console.log(pluginReadme_render(content));
+            chiliLog(chalk.green.bold("\nREADME Content:"));
+            chiliLog(pluginReadme_render(content));
         }
         else {
-            console.log(chalk.red("README not found in the repository."));
+            chiliLog(chalk.red("README not found in the repository."));
         }
     }
     /**
@@ -176,21 +177,21 @@ export class PluginMemberHandler {
      */
     async plugin_readme(pluginId) {
         try {
-            console.log(`Fetching info for plugin with ID: ${pluginId}`);
+            chiliLog(`Fetching info for plugin with ID: ${pluginId}`);
             const documentation = await this.controller.documentationUrl_get(pluginId);
             if (!documentation) {
                 return null;
             }
-            console.log(documentation);
+            chiliLog(documentation);
             await this.readme_print(documentation);
             return documentation;
         }
         catch (error) {
             if (error instanceof Error) {
-                console.error(`Error fetching plugin info: ${error.message}`);
+                chiliErrLog(`Error fetching plugin info: ${error.message}`);
             }
             else {
-                console.error("An unknown error occurred while fetching plugin info");
+                chiliErrLog("An unknown error occurred while fetching plugin info");
             }
         }
         return null;
@@ -214,15 +215,15 @@ export class PluginMemberHandler {
         try {
             const instance = await plugin_execute(searchable, params);
             if (!instance) {
-                console.log(errorStack.messagesOfType_search("error", "plugin"));
+                chiliLog(errorStack.messagesOfType_search("error", "plugin"));
                 return null;
             }
-            console.log(pluginRun_render(instance));
+            chiliLog(pluginRun_render(instance));
             return instance.id;
         }
         catch (e) {
             const message = e instanceof Error ? e.message : String(e);
-            console.error(message);
+            chiliErrLog(message);
             return null;
         }
     }
@@ -234,7 +235,7 @@ export class PluginMemberHandler {
         if (!hits) {
             return null;
         }
-        console.log(hits);
+        chiliLog(hits);
         return hits;
     }
     /**
@@ -270,10 +271,10 @@ export class PluginMemberHandler {
                 else {
                     const warnings = errorStack_getAllOfType('warning');
                     if (warnings && warnings.length > 0) {
-                        warnings.forEach(warning => console.error(chalk.yellow(warning)));
+                        warnings.forEach(warning => chiliErrLog(chalk.yellow(warning)));
                     }
                     else {
-                        console.error(chalk.red("Plugin not found."));
+                        chiliErrLog(chalk.red("Plugin not found."));
                     }
                 }
             });
@@ -297,7 +298,7 @@ export class PluginMemberHandler {
             });
         }
         else {
-            console.error(`Failed to find '${this.assetName}' command. The 'readme' subcommand was not added.`);
+            chiliErrLog(`Failed to find '${this.assetName}' command. The 'readme' subcommand was not added.`);
         }
     }
 }

package/dist/run.d.ts

@@ -9,6 +9,7 @@
  *
  * @module
  */
+import { type ChiliCaptured } from "./screen/output.js";
 /**
  * Executes a single chili command in the current process.
  *
@@ -22,3 +23,15 @@
  *   the leading `node`/script entries).
  */
 export declare function run(argv: string[]): Promise<void>;
+/**
+ * Executes a single chili command with its output captured instead of printed.
+ *
+ * Runs {@link run} inside {@link chili_capture}, so everything the command
+ * would have written to the output and error channels is collected and
+ * returned. This is how an in-process host (the brasa engine) drives chili
+ * headless and carries the result in an envelope, with no console monkeypatch.
+ *
+ * @param argv - The chili arguments, e.g. `["feeds", "list", "-s"]`.
+ * @returns The captured output and error text.
+ */
+export declare function run_capture(argv: string[]): Promise<ChiliCaptured>;

package/dist/run.js

@@ -27,6 +27,7 @@ import { PACSQueryGroupHandler } from "./pacs/pacsQueryHandler.js";
 import { PACSRetrieveGroupHandler } from "./pacs/pacsRetrieveHandler.js";
 import { chrisConnection_init, NodeStorageProvider, errorStack_getAllOfType, } from "@fnndsc/cumin";
 import { FileGroupHandler } from "./filesystem/fileGroupHandler.js";
+import { chiliErrLog, chiliLog, chili_capture } from "./screen/output.js";
 /**
  * Suppress the DEP0169 (`url.parse()`) warning emitted transitively by
  * axios -> proxy-from-env, which we do not control. Installed once at import.
@@ -84,14 +85,14 @@ async function handlers_initialize(program) {
         const err = e instanceof Error ? e.message : String(e);
         const errors = errorStack_getAllOfType("error");
         const warnings = errorStack_getAllOfType("warning");
-        console.log(`Note: File group commands (files, dirs, links) are unavailable. Reason: ${err}`);
+        chiliLog(`Note: File group commands (files, dirs, links) are unavailable. Reason: ${err}`);
         if (errors.length > 0) {
-            console.log("Errors:");
-            errors.forEach((msg) => console.log(`  - ${msg}`));
+            chiliLog("Errors:");
+            errors.forEach((msg) => chiliLog(`  - ${msg}`));
         }
         if (warnings.length > 0) {
-            console.log("Warnings:");
-            warnings.forEach((msg) => console.log(`  - ${msg}`));
+            chiliLog("Warnings:");
+            warnings.forEach((msg) => chiliLog(`  - ${msg}`));
         }
     }
     try {
@@ -106,14 +107,14 @@ async function handlers_initialize(program) {
         const err = e instanceof Error ? e.message : String(e);
         const errors = errorStack_getAllOfType("error");
         const warnings = errorStack_getAllOfType("warning");
-        console.log(`Note: Plugin context commands are unavailable. Reason: ${err}`);
+        chiliLog(`Note: Plugin context commands are unavailable. Reason: ${err}`);
         if (errors.length > 0) {
-            console.log("Errors:");
-            errors.forEach((msg) => console.log(`  - ${msg}`));
+            chiliLog("Errors:");
+            errors.forEach((msg) => chiliLog(`  - ${msg}`));
         }
         if (warnings.length > 0) {
-            console.log("Warnings:");
-            warnings.forEach((msg) => console.log(`  - ${msg}`));
+            chiliLog("Warnings:");
+            warnings.forEach((msg) => chiliLog(`  - ${msg}`));
         }
     }
 }
@@ -155,7 +156,7 @@ export async function run(argv) {
     if (context) {
         const contextSetSuccess = await connection.context_set(context);
         if (!contextSetSuccess) {
-            console.error("Failed to set context.");
+            chiliErrLog("Failed to set context.");
             return;
         }
         fullArgv = newArgs;
@@ -174,8 +175,8 @@ export async function run(argv) {
     program.parseOptions(fullArgv);
     const options = program.opts();
     if (!options.nosplash) {
-        console.log(figlet.textSync("ChILI"));
-        console.log("ChILI handles Intelligent Line Interactions");
+        chiliLog(figlet.textSync("ChILI"));
+        chiliLog("ChILI handles Intelligent Line Interactions");
     }
     try {
         await program.parseAsync(fullArgv);
@@ -190,3 +191,17 @@ export async function run(argv) {
         throw err;
     }
 }
+/**
+ * Executes a single chili command with its output captured instead of printed.
+ *
+ * Runs {@link run} inside {@link chili_capture}, so everything the command
+ * would have written to the output and error channels is collected and
+ * returned. This is how an in-process host (the brasa engine) drives chili
+ * headless and carries the result in an envelope, with no console monkeypatch.
+ *
+ * @param argv - The chili arguments, e.g. `["feeds", "list", "-s"]`.
+ * @returns The captured output and error text.
+ */
+export async function run_capture(argv) {
+    return chili_capture(() => run(argv));
+}

package/dist/screen/output.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @file chili's output seam.
+ *
+ * chili historically printed straight to `console.log`/`console.error`, which
+ * fused its command layer to a terminal and forced any in-process host (the
+ * brasa engine, which drives chili headless) to capture output with a console
+ * monkeypatch. This seam inverts that: command output is written to whatever
+ * writer is installed, and by default that writer simply delegates to the
+ * process console — so chili's standalone CLI behaves exactly as it always has.
+ *
+ * A host captures a run's output with {@link chili_capture}, which swaps in a
+ * buffering writer for the duration of a call and returns the collected text.
+ * This is explicit dependency injection through a module seam, not a runtime
+ * override of the global `console`: the default writer calls `console.log`
+ * normally, and capture bypasses the console entirely.
+ *
+ * @module
+ */
+/**
+ * Destination for chili's command output.
+ */
+export interface ChiliWriter {
+    /**
+     * Writes to the output channel with `console.log` semantics.
+     *
+     * @param args - The values to format, exactly as passed to `console.log`.
+     */
+    log(...args: unknown[]): void;
+    /**
+     * Writes to the error channel with `console.error` semantics.
+     *
+     * @param args - The values to format, exactly as passed to `console.error`.
+     */
+    errLog(...args: unknown[]): void;
+    /**
+     * Writes raw text or bytes to the output channel without adding a newline.
+     *
+     * @param chunk - The text or bytes to write.
+     */
+    write(chunk: string | Buffer): void;
+}
+/**
+ * Installs a writer as the active output destination.
+ *
+ * @param writer - The writer to install.
+ * @returns The previously installed writer, so callers can restore it.
+ */
+export declare function chiliWriter_set(writer: ChiliWriter): ChiliWriter;
+/**
+ * Writes to the output channel with `console.log` semantics.
+ *
+ * @param args - The values to format, exactly as passed to `console.log`.
+ */
+export declare function chiliLog(...args: unknown[]): void;
+/**
+ * Writes to the error channel with `console.error` semantics.
+ *
+ * @param args - The values to format, exactly as passed to `console.error`.
+ */
+export declare function chiliErrLog(...args: unknown[]): void;
+/**
+ * Writes raw text or bytes to the output channel without adding a newline —
+ * the replacement for direct `process.stdout.write` calls.
+ *
+ * @param chunk - The text or bytes to write.
+ */
+export declare function chiliWrite(chunk: string | Buffer): void;
+/**
+ * The text captured from a run, one string per channel.
+ */
+export interface ChiliCaptured {
+    /** Everything written to the output channel. */
+    out: string;
+    /** Everything written to the error channel. */
+    err: string;
+}
+/**
+ * Runs `fn` with both channels captured into memory and returns the collected
+ * text, restoring the previous writer afterwards even if `fn` throws.
+ *
+ * Formatting matches `console.log`: arguments are rendered with `util.format`
+ * and each `log`/`errLog` call contributes a trailing newline, exactly as the
+ * console would have written.
+ *
+ * @param fn - The work whose output should be captured.
+ * @returns The captured output and error text.
+ */
+export declare function chili_capture(fn: () => Promise<void>): Promise<ChiliCaptured>;