Universal.Operative.Sdk.Compression 2.0.0

About

Universal.Operative.Sdk.Compression adds two IShellHook implementations for Universal.Operative.Sdk's BashTool/PowerShellTool, so large shell output doesn't reach the model as-is:

• CommandCompressionHook — an AfterExecute hook backed by Universal.GenerativeAI.CommandCompression: parses captured stdout/stderr for recognized command families (git, docker, kubectl, test runners, package managers, and more) and compresses them, run in-process, no external dependency.
• RtkProxyHook — a BeforeExecute hook that proxies a call through the external rtk CLI when it's on PATH: rtk spawns the target command itself and compresses its output before this SDK ever captures anything. Only applies to a command that parses as one simple invocation with no shell operators, redirects, backgrounding, or command substitution — anything else is left to run through the shell unchanged, since rtk's contract is a plain argv, not a shell string.

Both are opt-in and safe by default: each declines (returns null / leaves the command alone) rather than forcing output through a shape it doesn't recognize. RtkProxyHook additionally verifies, at construction time, that whatever answers to the configured executable name is actually rtk-ai/rtk — there's a documented, unrelated project also named "rtk" ("Rust Type Kit") — by checking that its --help output mentions token compression. No binary on PATH at all is the ordinary case and stays quiet; a name match that fails that check throws InvalidOperationException instead of silently doing nothing, since a wrong tool sitting where rtk was expected is a misconfiguration worth surfacing loudly.

How to Use

Installation

dotnet add package Universal.Operative.Sdk.Compression

Usage

using Universal.Operative.Sdk.Compression;
using Universal.Operative.Sdk.Tools.Shell;

var shellTools = new ShellToolBuilder()
    .WithRtkProxy()             // no-ops if `rtk` isn't installed
    .WithCommandCompression();  // in-process fallback/complement

IEngine engine = EngineBuilder.FromDefaults(model)
    .AddBaselineToolSet(shellTools: shellTools)
    .Build();

Both hooks can be constructed and added directly too (shellTools.AddBeforeExecuteHook(new RtkProxyHook())), or passed a custom CommandCompressor/tokenizer for finer control.

License

Free for noncommercial use under the Universal.Operative Noncommercial License. Source is closed; commercial use requires a separate license from Andrew Ong.