@fnndsc/chili 3.4.0 → 3.5.0

package/dist/pacs/pacsQueryHandler.js

@@ -9,6 +9,7 @@ import { BaseGroupHandler } from "../handlers/baseGroupHandler.js";
 import { border_draw } from "../screen/screen.js";
 import { pacsQueryResult_renderPretty } from "./pacsResultRender.js";
 import { pacsQueryPayload_build } from "./pacsQueryPayload.js";
+import { chiliLog } from "../screen/output.js";
 /**
  * Handler for PACS queries commands.
  */
@@ -69,7 +70,7 @@ export class PACSQueryGroupHandler {
         const listCommand = this.baseGroupHandler.baseListCommand_create(async (options) => {
             const pacsserver = await this.pacsserverContext_resolve(options.pacsserver);
             if (!pacsserver) {
-                console.log(border_draw("No PACS server in context. Use --pacsserver or set via context."));
+                chiliLog(border_draw("No PACS server in context. Use --pacsserver or set via context."));
                 return;
             }
             const mergedOptions = this.options_withPACSFilter(options, pacsserver);
@@ -111,17 +112,17 @@ export class PACSQueryGroupHandler {
             }
             const payload = pacsQueryPayload_build(queryInput, options.title, options.description);
             if (!payload) {
-                console.log(border_draw("Invalid query format. Provide JSON or comma-separated key:value pairs."));
+                chiliLog(border_draw("Invalid query format. Provide JSON or comma-separated key:value pairs."));
                 return;
             }
             const result = await pacsQueries_create(pacsserver, payload);
             if (!result.ok) {
                 const errors = errorStack_getAllOfType("error");
                 if (errors.length) {
-                    errors.forEach((msg) => console.log(border_draw(msg)));
+                    errors.forEach((msg) => chiliLog(border_draw(msg)));
                 }
                 else {
-                    console.log(border_draw("Failed to create PACS query."));
+                    chiliLog(border_draw("Failed to create PACS query."));
                 }
                 return;
             }
@@ -133,7 +134,7 @@ export class PACSQueryGroupHandler {
                 `pacs=${pacsserver}`,
                 `title="${created.title ?? options.title ?? ""}"`,
             ].join(" ");
-            console.log(border_draw(msg.trim()));
+            chiliLog(border_draw(msg.trim()));
         });
     }
     /**
@@ -149,17 +150,17 @@ export class PACSQueryGroupHandler {
             .action(async (queryId, options) => {
             const idNum = Number(queryId);
             if (Number.isNaN(idNum)) {
-                console.log(border_draw("queryId must be a number."));
+                chiliLog(border_draw("queryId must be a number."));
                 return;
             }
             const result = await pacsQuery_resultDecode(idNum);
             if (!result.ok) {
                 const errors = errorStack_getAllOfType("error");
                 if (errors.length) {
-                    errors.forEach((msg) => console.log(border_draw(msg)));
+                    errors.forEach((msg) => chiliLog(border_draw(msg)));
                 }
                 else {
-                    console.log(border_draw(`Failed to decode PACS query result for ${idNum}.`));
+                    chiliLog(border_draw(`Failed to decode PACS query result for ${idNum}.`));
                 }
                 return;
             }
@@ -167,23 +168,23 @@ export class PACSQueryGroupHandler {
             // Prefer JSON, then text, else indicate base64 length
             if (decoded.json !== undefined) {
                 if (options.raw) {
-                    console.log(border_draw(JSON.stringify(decoded.json, null, 2)));
+                    chiliLog(border_draw(JSON.stringify(decoded.json, null, 2)));
                     return;
                 }
                 const pretty = this.pacsResult_renderPretty(decoded.json);
                 if (pretty) {
-                    console.log(border_draw(pretty));
+                    chiliLog(border_draw(pretty));
                 }
                 else {
-                    console.log(border_draw(JSON.stringify(decoded.json, null, 2)));
+                    chiliLog(border_draw(JSON.stringify(decoded.json, null, 2)));
                 }
             }
             else if (decoded.text) {
-                console.log(border_draw(decoded.text));
+                chiliLog(border_draw(decoded.text));
             }
             else {
                 const len = decoded.raw.length;
-                console.log(border_draw(`Decoded payload available (base64 length ${len}), but not printable.`));
+                chiliLog(border_draw(`Decoded payload available (base64 length ${len}), but not printable.`));
             }
         });
     }

package/dist/pacs/pacsRetrieveHandler.js

@@ -6,6 +6,7 @@
 import { errorStack_getAllOfType, } from "@fnndsc/cumin";
 import { pacsRetrieve_create, pacsRetrieve_delete, pacsRetrieve_statusForQuery, } from "@fnndsc/salsa";
 import { border_draw } from "../screen/screen.js";
+import { chiliLog } from "../screen/output.js";
 /**
  * Handler for PACS retrieve commands.
  */
@@ -52,17 +53,17 @@ export class PACSRetrieveGroupHandler {
     async retrieve_pull(queryIdStr) {
         const queryId = Number(queryIdStr);
         if (Number.isNaN(queryId)) {
-            console.log(border_draw("Query ID must be a number."));
+            chiliLog(border_draw("Query ID must be a number."));
             return;
         }
         const result = await pacsRetrieve_create(queryId);
         if (!result.ok) {
             const errors = errorStack_getAllOfType("error");
             if (errors.length) {
-                errors.forEach((msg) => console.log(border_draw(msg)));
+                errors.forEach((msg) => chiliLog(border_draw(msg)));
             }
             else {
-                console.log(border_draw(`Failed to create PACS retrieve for query ${queryId}.`));
+                chiliLog(border_draw(`Failed to create PACS retrieve for query ${queryId}.`));
             }
             return;
         }
@@ -73,7 +74,7 @@ export class PACSRetrieveGroupHandler {
             `query=${queryId}`,
             `status=${record.status || "created"}`,
         ].join(" ");
-        console.log(border_draw(msg));
+        chiliLog(border_draw(msg));
     }
     /**
      * Handle the 'report' command - show detailed status.
@@ -83,23 +84,23 @@ export class PACSRetrieveGroupHandler {
     async retrieve_report(queryIdStr) {
         const queryId = Number(queryIdStr);
         if (Number.isNaN(queryId)) {
-            console.log(border_draw("Query ID must be a number."));
+            chiliLog(border_draw("Query ID must be a number."));
             return;
         }
         const result = await pacsRetrieve_statusForQuery(queryId);
         if (!result.ok) {
             const errors = errorStack_getAllOfType("error");
             if (errors.length) {
-                errors.forEach((msg) => console.log(border_draw(msg)));
+                errors.forEach((msg) => chiliLog(border_draw(msg)));
             }
             else {
-                console.log(border_draw(`Failed to generate status report for query ${queryId}.`));
+                chiliLog(border_draw(`Failed to generate status report for query ${queryId}.`));
             }
             return;
         }
         const report = result.value;
         const rendered = this.report_render(report);
-        console.log(border_draw(rendered));
+        chiliLog(border_draw(rendered));
     }
     /**
      * Handle the 'cancel' command - delete a retrieve.
@@ -109,21 +110,21 @@ export class PACSRetrieveGroupHandler {
     async retrieve_cancel(retrieveIdStr) {
         const retrieveId = Number(retrieveIdStr);
         if (Number.isNaN(retrieveId)) {
-            console.log(border_draw("Retrieve ID must be a number."));
+            chiliLog(border_draw("Retrieve ID must be a number."));
             return;
         }
         const result = await pacsRetrieve_delete(retrieveId);
         if (!result.ok) {
             const errors = errorStack_getAllOfType("error");
             if (errors.length) {
-                errors.forEach((msg) => console.log(border_draw(msg)));
+                errors.forEach((msg) => chiliLog(border_draw(msg)));
             }
             else {
-                console.log(border_draw(`Failed to cancel PACS retrieve ${retrieveId}.`));
+                chiliLog(border_draw(`Failed to cancel PACS retrieve ${retrieveId}.`));
             }
             return;
         }
-        console.log(border_draw(`PACS retrieve ${retrieveId} cancelled.`));
+        chiliLog(border_draw(`PACS retrieve ${retrieveId} cancelled.`));
     }
     /**
      * Determine overall completion status from series statuses.

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.js

@@ -8,6 +8,7 @@ import { options_toParams } from "../utils/cli.js";
 import { PluginContextController } from "../controllers/pluginContextController.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);
@@ -53,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);
@@ -62,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}`);
         }
     }
     /**

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));
+}