Consoles

Tharga.Console writes through an IConsole abstraction instead of System.Console directly. That makes it easy to swap rendering — interactive terminal, event stream, test sink, voice, or even multiple targets at once.

The built-in implementations

Console	Package	When to use
`ClientConsole`	`Tharga.Console`	The default — regular interactive use. Wraps `System.Console`.
`EventConsole`	`Tharga.Console.Standard`	Raise `OutputEvent` events instead of writing to a stream. Useful for forwarding to a UI or logger.
`ActionConsole`	`Tharga.Console.Standard`	Invoke a delegate (`Action<WriteEventArgs>`) for every output. The minimal "plug your own sink" option.
`AggregateConsole`	`Tharga.Console.Standard`	Compose two or more consoles; every write goes to all of them. Pair `ClientConsole` with `EventConsole` to render and forward.
`NullConsole`	`Tharga.Console.Standard`	Drops every write. Useful in tests where you don't want to mock anything.
`VoiceConsole`	`Tharga.Console.Speech`	Extends `ClientConsole` with `System.Speech` voice input. Windows only.

Choosing one

ClientConsole is the right default. The others are useful when you need something specific:

// Forward all output to an event subscriber AND render it on screen.
using var ui = new ClientConsole();
using var stream = new EventConsole();
using var console = new AggregateConsole(ui, stream);

stream.OutputEvent += (sender, e) => _telemetry.Track(e.Message, e.Level);

var command = new RootCommand(console);
var engine = new CommandEngine(command);
engine.Start(args);

Output methods

Every ConsoleBase (and therefore every implementation above) exposes the same set of methods:

console.OutputInformation("Started.");
console.OutputWarning("Cache miss — fetching from upstream.");
console.OutputError("Connection refused.");
console.OutputEvent("User signed in.");
console.OutputHelp("Type 'help' for the command list.");
console.OutputDefault("Plain text, no level.");

The OutputLevel enum (passed via WriteEventArgs to event subscribers) is the same enum the colored output uses, so subscribers can branch on severity.

Disposing

All console implementations implement IDisposable. Wrap them in using (top-level statement) or using (var ...) (classic) — Dispose clears handlers, restores console colors, and releases speech resources where applicable.

Plugging in your own