@piotr-oles/pi-bash-timeout1.0.0
Pi Agent extension: inject a default bash timeout and append timeout policy guidance to the system prompt
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
@piotr-oles/pi-bash-timeout
Pi Agent extension that gives the bash tool a sane default timeout and tells the model about the timeout policy.
It intercepts the host bash tool via the tool_call event and injects a default timeout (in seconds) when the model omits it or passes a non-positive value. It also appends a "Bash Tool Timeout Policy" section to the system prompt via before_agent_start so the model sets explicit timeouts for long-running commands.
Behavior
| Case | Result |
|---|---|
timeout omitted |
inject default |
timeout <= 0 |
treated as missing, inject default |
timeout in range |
preserved |
timeout above max |
capped to max |
Non-bash tool calls are never touched.
Configuration
Both pi flags and env vars are supported. Precedence: flag > env var > built-in default. Invalid or non-positive values are ignored and fall through to the next source.
| Setting | Flag | Env var | Default |
|---|---|---|---|
| Default timeout (s) | pi-bash-timeout-default |
PI_BASH_DEFAULT_TIMEOUT_SECONDS |
120 |
| Maximum timeout (s) | pi-bash-timeout-max |
PI_BASH_MAX_TIMEOUT_SECONDS |
600 |
Explicit timeout values above max are capped. If max resolves lower than default, it is raised to default.
Thanks
Ported from code-yeongyu/pi-bash-timeout and adapted to this repo (pi flags, upstream isToolCallEventType guard, in-place input mutation, colocated tests).
Development
pnpm install
pnpm test
pnpm typecheck
pnpm check
To test changes manually, pass the source entry point directly to pi:
pi -e packages/pi-bash-timeout/src/index.ts