Host shellware

Host shellware runs scripts in a fresh terminal job selected by a CPS workspace path. It is intended for checks, builds, and other command-line work.

Tools

exec runs a multiline script. Give it a cwd, a short intention, and a practical timeoutMs. The timeout starts when the job begins, not while it waits for a shared terminal.

read can inspect a terminal or job URI after execution. It returns a compact tail for a terminal and supports output slices when a smaller range is needed.

Boundaries

Each exec call creates a new job. Its combined output is capped; oversized output keeps the beginning and end and marks the omitted middle. The host requires an attached terminal environment and a path it is allowed to serve.