@flowscripter/dynamic-cli-framework 2.0.0 → 2.2.0

package/dist/src/service/spawn/SpawnServiceProvider.d.ts

@@ -0,0 +1,12 @@
+import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context } from "@flowscripter/dynamic-cli-framework-api";
+import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
+export default class SpawnServiceProvider implements ServiceProvider {
+    #private;
+    readonly serviceId: string;
+    readonly servicePriority: number;
+    constructor(servicePriority: number);
+    getServiceInfo(_cliConfig: CLIConfig): Promise<ServiceInfo>;
+    initService(context: Context): Promise<void>;
+}
+//# sourceMappingURL=SpawnServiceProvider.d.ts.map

package/dist/src/service/spawn/SpawnServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpawnServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/spawn/SpawnServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,MAAM,CAAC,OAAO,OAAO,oBAAqB,YAAW,eAAe;;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAoB;IAC9C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAGd,eAAe,EAAE,MAAM;IAInC,cAAc,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ3D,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAMpD"}

package/dist/src/service/spawn/SpawnServiceProvider.js

@@ -0,0 +1,24 @@
+import { PRINTER_SERVICE_ID, SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { SPAWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import DefaultSpawnService from "./DefaultSpawnService.js";
+export default class SpawnServiceProvider {
+    serviceId = SPAWN_SERVICE_ID;
+    servicePriority;
+    #spawnService;
+    constructor(servicePriority) {
+        this.servicePriority = servicePriority;
+    }
+    getServiceInfo(_cliConfig) {
+        this.#spawnService = new DefaultSpawnService();
+        return Promise.resolve({
+            service: this.#spawnService,
+            commands: [],
+        });
+    }
+    initService(context) {
+        const printerService = context.getServiceById(PRINTER_SERVICE_ID);
+        const shutdownService = context.getServiceById(SHUTDOWN_SERVICE_ID);
+        this.#spawnService.setDependencies(printerService, shutdownService);
+        return Promise.resolve();
+    }
+}

package/dist/src/terminal/NonTtyTerminal.d.ts

@@ -0,0 +1,14 @@
+import type Terminal from "./Terminal.ts";
+export default class NonTtyTerminal implements Terminal {
+    #private;
+    constructor(writeStream: NodeJS.WritableStream);
+    write(text: string): Promise<void>;
+    columns(): number;
+    rows(): number;
+    clearLine(): Promise<void>;
+    clearUpLines(_count: number): Promise<void>;
+    hideCursor(): Promise<void>;
+    showCursor(): Promise<void>;
+    isTty(): boolean;
+}
+//# sourceMappingURL=NonTtyTerminal.d.ts.map

package/dist/src/terminal/NonTtyTerminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NonTtyTerminal.d.ts","sourceRoot":"","sources":["../../../src/terminal/NonTtyTerminal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C,MAAM,CAAC,OAAO,OAAO,cAAe,YAAW,QAAQ;;gBAIzC,WAAW,EAAE,MAAM,CAAC,cAAc;IAQ9C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,OAAO,IAAI,MAAM;IAIjB,IAAI,IAAI,MAAM;IAId,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,KAAK,IAAI,OAAO;CAGjB"}

package/dist/src/terminal/NonTtyTerminal.js

@@ -0,0 +1,36 @@
+import { WriteStream } from "node:tty";
+export default class NonTtyTerminal {
+    #writeStream;
+    #encoder = new TextEncoder();
+    constructor(writeStream) {
+        if (writeStream.isTTY === true) {
+            throw new Error("The provided WriteStream is a TTY");
+        }
+        this.#writeStream = writeStream;
+    }
+    write(text) {
+        this.#writeStream.write(this.#encoder.encode(text));
+        return Promise.resolve();
+    }
+    columns() {
+        return 80;
+    }
+    rows() {
+        return 24;
+    }
+    clearLine() {
+        return Promise.reject(new Error("clearLine() is not supported on a non-TTY terminal"));
+    }
+    clearUpLines(_count) {
+        return Promise.reject(new Error("clearUpLines() is not supported on a non-TTY terminal"));
+    }
+    hideCursor() {
+        return Promise.reject(new Error("hideCursor() is not supported on a non-TTY terminal"));
+    }
+    showCursor() {
+        return Promise.reject(new Error("showCursor() is not supported on a non-TTY terminal"));
+    }
+    isTty() {
+        return false;
+    }
+}

package/dist/src/terminal/Terminal.d.ts

@@ -6,5 +6,6 @@ export default interface Terminal {
     write(text: string): Promise<void>;
     columns(): number;
     rows(): number;
+    isTty(): boolean;
 }
 //# sourceMappingURL=Terminal.d.ts.map

package/dist/src/terminal/Terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../../../src/terminal/Terminal.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,WAAW,QAAQ;IAC/B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,MAAM,CAAC;IAClB,IAAI,IAAI,MAAM,CAAC;CAChB"}
+{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../../../src/terminal/Terminal.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,WAAW,QAAQ;IAC/B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,MAAM,CAAC;IAClB,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,OAAO,CAAC;CAClB"}

package/dist/src/terminal/TtyStyler.d.ts

@@ -6,6 +6,7 @@ export default class TtyStyler implements Styler {
     /**
      * The color level in use.
      *
+     * 0 = no color
      * 1 = 16 color
      * 2 = 256 color
      * 3 = 16 million color

package/dist/src/terminal/TtyStyler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TtyStyler.d.ts","sourceRoot":"","sources":["../../../src/terminal/TtyStyler.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,SAAU,YAAW,MAAM;IAC9C,YAAY,EAAE,OAAO,CAAQ;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAE3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;OAMG;gBACS,UAAU,GAAE,MAAU,EAAE,iBAAiB,GAAE,OAAc;IAKrE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAgBnD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAyB7D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAM7C"}
+{"version":3,"file":"TtyStyler.d.ts","sourceRoot":"","sources":["../../../src/terminal/TtyStyler.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,SAAU,YAAW,MAAM;IAC9C,YAAY,EAAE,OAAO,CAAQ;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAE3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;;OAOG;gBACS,UAAU,GAAE,MAAU,EAAE,iBAAiB,GAAE,OAAc;IAKrE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAgBnD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAyB7D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAOhC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAM7C"}

package/dist/src/terminal/TtyStyler.js

@@ -6,6 +6,7 @@ export default class TtyStyler {
     /**
      * The color level in use.
      *
+     * 0 = no color
      * 1 = 16 color
      * 2 = 256 color
      * 3 = 16 million color
@@ -15,7 +16,7 @@ export default class TtyStyler {
         this.hyperlinksEnabled = hyperlinksEnabled;
     }
     colorText(text, colorValue) {
-        if (!this.colorEnabled) {
+        if (!this.colorEnabled || this.colorLevel === 0) {
             return text;
         }
         if (this.colorLevel === 3) {
@@ -27,7 +28,7 @@ export default class TtyStyler {
         return Bun.color(colorValue, "ansi-16") + text + FOREGROUND_COLOR_END;
     }
     backgroundColorText(text, colorValue) {
-        if (!this.colorEnabled) {
+        if (!this.colorEnabled || this.colorLevel === 0) {
             return text;
         }
         if (this.colorLevel === 3) {
@@ -44,6 +45,9 @@ export default class TtyStyler {
             BACKGROUND_COLOR_END);
     }
     italicText(text) {
+        if (!this.colorEnabled || this.colorLevel === 0) {
+            return text;
+        }
         return ITALIC_START + text + ITALIC_END;
     }
     hyperlink(text, url) {

package/dist/src/terminal/TtyTerminal.d.ts

@@ -10,5 +10,6 @@ export default class TtyTerminal implements Terminal {
     write(text: string): Promise<void>;
     columns(): number;
     rows(): number;
+    isTty(): boolean;
 }
 //# sourceMappingURL=TtyTerminal.d.ts.map

package/dist/src/terminal/TtyTerminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TtyTerminal.d.ts","sourceRoot":"","sources":["../../../src/terminal/TtyTerminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAI1C,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,QAAQ;;gBAItC,cAAc,EAAE,WAAW;IAcvC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAM1B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,OAAO,IAAI,MAAM;IAQjB,IAAI,IAAI,MAAM;CAOf"}
+{"version":3,"file":"TtyTerminal.d.ts","sourceRoot":"","sources":["../../../src/terminal/TtyTerminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAI1C,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,QAAQ;;gBAItC,cAAc,EAAE,WAAW;IAcvC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAM1B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,OAAO,IAAI,MAAM;IAQjB,IAAI,IAAI,MAAM;IAQd,KAAK,IAAI,OAAO;CAGjB"}

package/dist/src/terminal/TtyTerminal.js

@@ -49,4 +49,7 @@ export default class TtyTerminal {
             return 24;
         }
     }
+    isTty() {
+        return true;
+    }
 }

package/index.ts

@@ -78,6 +78,15 @@ export type { ShutdownService } from "@flowscripter/dynamic-cli-framework-api";
 export { default as DefaultShutdownService } from "./src/service/shutdown/DefaultShutdownService.ts";
 export { default as ShutdownServiceProvider } from "./src/service/shutdown/ShutdownServiceProvider.ts";
 
+export { SPAWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+export type {
+  SpawnOptions,
+  SpawnResult,
+  SpawnService,
+} from "@flowscripter/dynamic-cli-framework-api";
+export { default as DefaultSpawnService } from "./src/service/spawn/DefaultSpawnService.ts";
+export { default as SpawnServiceProvider } from "./src/service/spawn/SpawnServiceProvider.ts";
+
 export { SYNTAX_HIGHLIGHTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 export type { SyntaxHighlighterService } from "@flowscripter/dynamic-cli-framework-api";
 export type { ColorScheme } from "@flowscripter/dynamic-cli-framework-api";
@@ -192,7 +201,7 @@ export { default as TtyKeyReader } from "./src/terminal/TtyKeyReader.ts";
 
 // Convenience functions
 export {
+  launchDynamicPluginMultiCommandCLI,
   launchMultiCommandCLI,
   launchSingleCommandCLI,
-  launchDynamicPluginMultiCommandCLI,
 } from "./src/launcher.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "A framework for developing CLI applications which supports dynamic discovery and installation of new commands",
   "keywords": [
     "bun",
@@ -48,8 +48,8 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@flowscripter/dynamic-cli-framework-api": "^1.0.1",
-    "@flowscripter/dynamic-plugin-framework": "1.10.1",
+    "@flowscripter/dynamic-cli-framework-api": "^1.1.1",
+    "@flowscripter/dynamic-plugin-framework": "1.11.0",
     "emphasize": "^7.0.0",
     "fastest-levenshtein": "^1.0.16",
     "figlet": "^1.11.0",

package/src/cli/BaseCLI.ts

@@ -51,6 +51,7 @@ import ArgumentPrompterServiceProvider from "../service/argumentPrompter/Argumen
 import DefaultCompletionService from "../service/completion/DefaultCompletionService.ts";
 import CompletionServiceProvider from "../service/completion/CompletionServiceProvider.ts";
 import ImagePrinterServiceProvider from "../service/imagePrinter/ImagePrinterServiceProvider.ts";
+import SpawnServiceProvider from "../service/spawn/SpawnServiceProvider.ts";
 const logger = getLogger("BaseCLI");
 
 /**
@@ -69,6 +70,13 @@ const logger = getLogger("BaseCLI");
  * Optionally enabled via {@link BaseCLIFeatureOptions}:
  *
  * * {@link ImagePrinterServiceProvider}
+ * * {@link SpawnServiceProvider}
+ *
+ * `keyReader` is optional. If omitted, or if the stderr {@link Terminal} is not a TTY, prompting is
+ * unavailable: {@link PrompterServiceProvider} (and {@link ArgumentPrompterServiceProvider}, if
+ * enabled) are simply not registered. If `promptingEnabled` is `true` in that situation, {@link run}
+ * throws rather than failing later inside a prompt. Similarly {@link ImagePrinterServiceProvider} is
+ * only registered if the stdout {@link Terminal} is a TTY.
  *
  * By default the following commands are added:
  *
@@ -80,7 +88,7 @@ const logger = getLogger("BaseCLI");
 export default class BaseCLI implements CLI {
   readonly #cliConfig: CLIConfig;
   readonly #options: Required<BaseCLIFeatureOptions>;
-  readonly #keyReader: KeyReader;
+  readonly #keyReader: KeyReader | undefined;
   readonly #stderrTerminal: Terminal;
   readonly #addedNonModifierCommands: Array<Command>;
   readonly #serviceProviderRegistry: DefaultServiceProviderRegistry;
@@ -98,7 +106,7 @@ export default class BaseCLI implements CLI {
     stdoutTerminal: Terminal,
     stderrTerminal: Terminal,
     styler: Styler,
-    keyReader: KeyReader,
+    keyReader: KeyReader | undefined,
     options?: BaseCLIFeatureOptions,
   ) {
     if (cliConfig.name.length === 0) {
@@ -124,6 +132,7 @@ export default class BaseCLI implements CLI {
       argumentPrompterServiceEnabled: false,
       completionServiceEnabled: false,
       imagePrinterServiceEnabled: false,
+      spawnServiceEnabled: false,
       validateAllCommands: false,
       promptingEnabled: true,
       ...options,
@@ -210,22 +219,54 @@ export default class BaseCLI implements CLI {
     this.addServiceProvider(new PrinterServiceProvider(80, this.#printerService));
     this.addServiceProvider(new TableGeneratorServiceProvider(70));
 
-    const prompterService = new DefaultPrompterService(
-      DEFAULT_PROMPTER_CONFIG,
-      this.#stderrTerminal,
-      this.#keyReader,
-      this.#printerService,
-    );
-    prompterService.promptEnabled = this.#options.promptingEnabled;
-    this.addServiceProvider(new PrompterServiceProvider(75, prompterService));
+    const canPrompt = this.#keyReader !== undefined && this.#stderrTerminal.isTty();
+
+    if (this.#options.promptingEnabled && !canPrompt) {
+      throw new Error("promptingEnabled requires a keyReader and a TTY stderr terminal");
+    }
+
+    let prompterService: DefaultPrompterService | undefined;
+    if (canPrompt) {
+      prompterService = new DefaultPrompterService(
+        DEFAULT_PROMPTER_CONFIG,
+        this.#stderrTerminal,
+        this.#keyReader!,
+        this.#printerService,
+      );
+      prompterService.promptEnabled = this.#options.promptingEnabled;
+      this.addServiceProvider(new PrompterServiceProvider(75, prompterService));
+    } else {
+      logger.debug(
+        () =>
+          `Skipping PrompterServiceProvider: keyReader present: ${
+            this.#keyReader !== undefined
+          }, stderr isTty: ${this.#stderrTerminal.isTty()}`,
+      );
+    }
 
     if (this.#options.argumentPrompterServiceEnabled) {
-      const argumentPrompterService = new DefaultArgumentPrompterService(prompterService);
-      this.addServiceProvider(new ArgumentPrompterServiceProvider(65, argumentPrompterService));
+      if (prompterService !== undefined) {
+        const argumentPrompterService = new DefaultArgumentPrompterService(prompterService);
+        this.addServiceProvider(new ArgumentPrompterServiceProvider(65, argumentPrompterService));
+      } else {
+        logger.debug(
+          "Skipping ArgumentPrompterServiceProvider: argumentPrompterServiceEnabled is true but prompting is unavailable",
+        );
+      }
     }
 
     if (this.#options.imagePrinterServiceEnabled) {
-      this.addServiceProvider(new ImagePrinterServiceProvider(55, this.#stdoutTerminal));
+      if (this.#stdoutTerminal.isTty()) {
+        this.addServiceProvider(new ImagePrinterServiceProvider(55, this.#stdoutTerminal));
+      } else {
+        logger.debug(
+          "Skipping ImagePrinterServiceProvider: imagePrinterServiceEnabled is true but stdout is not a TTY",
+        );
+      }
+    }
+
+    if (this.#options.spawnServiceEnabled) {
+      this.addServiceProvider(new SpawnServiceProvider(58));
     }
 
     if (this.#options.completionServiceEnabled) {

package/src/cli/BaseCLIFeatureOptions.ts

@@ -6,6 +6,7 @@ export default interface BaseCLIFeatureOptions {
   readonly argumentPrompterServiceEnabled?: boolean;
   readonly completionServiceEnabled?: boolean;
   readonly imagePrinterServiceEnabled?: boolean;
+  readonly spawnServiceEnabled?: boolean;
   readonly validateAllCommands?: boolean;
   readonly promptingEnabled?: boolean;
 }

package/src/cli/DefaultRuntimeCLI.ts

@@ -5,30 +5,74 @@ import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
 import type BaseCLIFeatureOptions from "./BaseCLIFeatureOptions.ts";
 import { Writable } from "node:stream";
 import TtyTerminal from "../terminal/TtyTerminal.ts";
+import NonTtyTerminal from "../terminal/NonTtyTerminal.ts";
 import TtyKeyReader from "../terminal/TtyKeyReader.ts";
 import TtyStyler from "../terminal/TtyStyler.ts";
 import supportsColor from "supports-color";
 import supportsHyperlinks from "../terminal/supportsHyperlinks.ts";
+import getLogger from "../util/logger.ts";
+
+const logger = getLogger("DefaultRuntimeCLI");
 
 /**
  * Default Bun implementation of a {@link CLI} using `process.stdout`, `process.stderr` and `process.argv`.
+ *
+ * Degrades gracefully when `stdin`, `stdout` or `stderr` are not TTYs (e.g. piped or redirected):
+ * color and hyperlinks are disabled, prompting is disabled, and non-TTY streams are wrapped in a
+ * {@link NonTtyTerminal} rather than the usual {@link TtyTerminal}.
  */
 export default class DefaultRuntimeCLI extends BaseCLI {
   constructor(cliConfig: CLIConfig, options?: BaseCLIFeatureOptions) {
+    const stdinIsTty = process.stdin.isTTY === true;
+    const stdoutIsTty = process.stdout.isTTY === true;
+    const stderrIsTty = process.stderr.isTTY === true;
+
+    logger.debug(
+      () =>
+        `stdin isTTY: ${stdinIsTty}, stdout isTTY: ${stdoutIsTty}, stderr isTTY: ${stderrIsTty}`,
+    );
+
+    const stdoutTerminal = stdoutIsTty
+      ? new TtyTerminal(process.stdout)
+      : new NonTtyTerminal(process.stdout);
+    const stderrTerminal = stderrIsTty
+      ? new TtyTerminal(process.stderr)
+      : new NonTtyTerminal(process.stderr);
+
+    logger.debug(
+      () =>
+        `stdout terminal: ${
+          stdoutIsTty ? "TtyTerminal" : "NonTtyTerminal"
+        }, stderr terminal: ${stderrIsTty ? "TtyTerminal" : "NonTtyTerminal"}`,
+    );
+
+    const colorLevel = stderrIsTty
+      ? supportsColor.stderr === false
+        ? 1
+        : supportsColor.stderr.level
+      : 0;
+
+    logger.debug(() => `color level: ${colorLevel}`);
+
+    const keyReader = stdinIsTty ? new TtyKeyReader(process.stdin) : undefined;
+
+    logger.debug(() => `keyReader constructed: ${keyReader !== undefined}`);
+
+    const promptingEnabled = stdinIsTty && stderrIsTty;
+
+    logger.debug(() => `promptingEnabled default: ${promptingEnabled}`);
+
     super(
       cliConfig,
       Writable.toWeb(process.stdout),
       Writable.toWeb(process.stderr),
       supportsColor.stdout !== false,
       supportsColor.stderr !== false,
-      new TtyTerminal(process.stdout),
-      new TtyTerminal(process.stderr),
-      new TtyStyler(
-        supportsColor.stderr === false ? 1 : supportsColor.stderr.level,
-        supportsHyperlinks(process.stderr),
-      ),
-      new TtyKeyReader(process.stdin),
-      { promptingEnabled: process.stdin.isTTY === true, ...options },
+      stdoutTerminal,
+      stderrTerminal,
+      new TtyStyler(colorLevel, supportsHyperlinks(process.stderr)),
+      keyReader,
+      { promptingEnabled, ...options },
     );
   }
 

package/src/service/plugin/DefaultPluginService.ts

@@ -1,8 +1,8 @@
 import type { PluginService } from "@flowscripter/dynamic-cli-framework-api";
 import type {
   MarketplacePluginManager,
-  VersionedPluginDescriptor,
   SearchQuery,
+  VersionedPluginDescriptor,
 } from "@flowscripter/dynamic-plugin-framework";
 
 export default class DefaultPluginService implements PluginService {

package/src/service/plugin/DefaultPluginServiceProvider.ts

@@ -1,20 +1,37 @@
 import type { ServiceInfo, ServiceProvider } from "@flowscripter/dynamic-cli-framework-api";
 import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
-import type { MarketplacePluginManager } from "@flowscripter/dynamic-plugin-framework";
+import type { PrinterService, SpawnService } from "@flowscripter/dynamic-cli-framework-api";
+import { PRINTER_SERVICE_ID, SPAWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import type {
+  MarketplacePluginManager,
+  SpawnCapable,
+} from "@flowscripter/dynamic-plugin-framework";
 import { PLUGIN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import DefaultPluginService from "./DefaultPluginService.ts";
 import { PluginGroupCommand } from "./command/PluginGroupCommand.ts";
+import SpawnInterfaceAdapter, {
+  type SpawnInterfaceAdapterOptions,
+} from "./SpawnInterfaceAdapter.ts";
+import getLogger from "../../util/logger.ts";
+
+const logger = getLogger("DefaultPluginServiceProvider");
 
 export default class DefaultPluginServiceProvider implements ServiceProvider {
   readonly serviceId = PLUGIN_SERVICE_ID;
   readonly servicePriority: number;
   readonly #pluginManager: MarketplacePluginManager;
+  readonly #spawnInterfaceAdapterOptions: SpawnInterfaceAdapterOptions;
   #pluginService: DefaultPluginService | undefined;
 
-  constructor(pluginManager: MarketplacePluginManager, servicePriority = 50) {
+  constructor(
+    pluginManager: MarketplacePluginManager,
+    servicePriority = 50,
+    spawnInterfaceAdapterOptions: SpawnInterfaceAdapterOptions = {},
+  ) {
     this.#pluginManager = pluginManager;
     this.servicePriority = servicePriority;
+    this.#spawnInterfaceAdapterOptions = spawnInterfaceAdapterOptions;
   }
 
   async getServiceInfo(_cliConfig: CLIConfig): Promise<ServiceInfo> {
@@ -25,5 +42,24 @@ export default class DefaultPluginServiceProvider implements ServiceProvider {
     };
   }
 
-  async initService(_context: Context): Promise<void> {}
+  initService(context: Context): Promise<void> {
+    if (!context.doesServiceExist(SPAWN_SERVICE_ID)) {
+      logger.debug("SpawnService not available, plugin manager will spawn processes directly");
+      return Promise.resolve();
+    }
+    if (!("setSpawn" in this.#pluginManager)) {
+      logger.debug("Plugin manager does not support SpawnCapable, skipping spawn injection");
+      return Promise.resolve();
+    }
+
+    const spawnService = context.getServiceById(SPAWN_SERVICE_ID) as SpawnService;
+    const printerService = context.getServiceById(PRINTER_SERVICE_ID) as PrinterService;
+    const adapter = new SpawnInterfaceAdapter(
+      spawnService,
+      printerService,
+      this.#spawnInterfaceAdapterOptions,
+    );
+    (this.#pluginManager as unknown as SpawnCapable).setSpawn(adapter);
+    return Promise.resolve();
+  }
 }

package/src/service/plugin/SpawnInterfaceAdapter.ts

@@ -0,0 +1,62 @@
+import type { PrinterService, SpawnService } from "@flowscripter/dynamic-cli-framework-api";
+import type { SpawnInterface, SpawnResult } from "@flowscripter/dynamic-plugin-framework";
+
+export interface SpawnInterfaceAdapterOptions {
+  quoteColor?: string;
+  markMinimumDisplayTimeMs?: number;
+}
+
+/**
+ * Adapts a {@link SpawnService} to dynamic-plugin-framework's {@link SpawnInterface}, wrapping
+ * spawned process output in a quoted, marked block via {@link PrinterService} that is cleared
+ * again once the process exits (subject to {@link SpawnInterfaceAdapterOptions.markMinimumDisplayTimeMs}).
+ */
+export default class SpawnInterfaceAdapter implements SpawnInterface {
+  readonly #spawnService: SpawnService;
+  readonly #printerService: PrinterService;
+  readonly #quoteColor: string | undefined;
+  readonly #markMinimumDisplayTimeMs: number;
+
+  public constructor(
+    spawnService: SpawnService,
+    printerService: PrinterService,
+    options: SpawnInterfaceAdapterOptions = {},
+  ) {
+    this.#spawnService = spawnService;
+    this.#printerService = printerService;
+    this.#quoteColor = options.quoteColor;
+    this.#markMinimumDisplayTimeMs = options.markMinimumDisplayTimeMs ?? 1000;
+  }
+
+  public async spawn(
+    command: ReadonlyArray<string>,
+    options: { cwd: string },
+  ): Promise<SpawnResult> {
+    this.#printerService.startQuote(this.#quoteColor);
+    this.#printerService.startMark();
+
+    // onOutput is synchronous and may be called concurrently for stdout/stderr lines, but
+    // printerService.info() is async and must not be invoked concurrently with itself - queue
+    // writes so they're applied one at a time, in call order.
+    let writeQueue: Promise<void> = Promise.resolve();
+    const onOutput = (line: string): void => {
+      writeQueue = writeQueue.then(() => this.#printerService.info(`${line}\n`));
+    };
+
+    const result = await this.#spawnService.spawn(command, {
+      cwd: options.cwd,
+      stdio: "wrapped",
+      onOutput,
+    });
+
+    await writeQueue;
+
+    this.#printerService.endQuote();
+    this.#printerService.endMark();
+    await this.#printerService.clearMarked(this.#markMinimumDisplayTimeMs);
+
+    return result.ok
+      ? { ok: true, exitCode: result.exitCode }
+      : { ok: false, exitCode: result.exitCode, error: result.error };
+  }
+}