pi-response-guard

Auto-recovery for empty, errored, or interrupted model responses in pi.

Features

• Empty response detection — catches stopReason: "stop" with 0 output tokens (rate limit / proxy failures)
• Auto-retry — sends a configurable retry message so the session never stalls
• Rate limit recovery — matches 429, rate limit, usage limit, and other provider error patterns
• Token overflow handling — auto-continues when the model hits max output tokens (stopReason: "length")
• 7 detection cases — covers error patterns, length limits, thinking-only stops, silent stops after user/tool/auto-retry, and zero-token empty responses

Installation

For Humans

npm install pi-response-guard

For AI Agents

Add to your pi settings.json packages array:

{
  "packages": ["npm:pi-response-guard"]
}

Install and configure pi-response-guard by following: https://raw.githubusercontent.com/buihongduc132/pi-response-guard/refs/heads/main/README.md

For pi (git-sourced)

Add to your pi settings.json packages array:

{
  "packages": ["https://github.com/buihongduc132/pi-response-guard"]
}

Usage

pi-response-guard runs automatically once installed — no configuration required. It listens to every assistant message and detects retryable conditions:

#	Condition	Description
1	Error pattern match	stopReason: "error" with a message matching configured error substrings (rate limit, fetch failed, ECONNRESET, etc.)
2	Token overflow	stopReason: "length" — model hit max output tokens
3	Thinking-only stop	Model stopped after emitting only thinking content, with no visible output
4	Silent stop after user	Model stopped after a user message with no visible output
5	Silent stop after tool	Model stopped after a tool result with no visible output
6	Silent stop after auto-retry	Consecutive empty response following an automatic retry
7	Zero-token empty response	stopReason: "stop" with usage.output === 0 — rate limit or proxy failure

When detected, the extension sends a configurable retry message (default: "continue") up to a maximum number of consecutive retries.

Configuration

Default config is bundled. To customize, run:

/pi-response-guard:setup

This copies the default config to ~/.pi/agent/extensions/pi-response-guard/config.json.

Or create a project-level config at .pi-response-guard.json or .pi/pi-response-guard.json.

Config Options

Field	Type	Default	Description
enabled	boolean	true	Enable/disable the extension
retryMessage	string	"continue"	Message sent to trigger retry
maxConsecutiveAutoRetries	number	10	Max retries before stopping
notifyOnAutoContinue	boolean	true	Show UI notification on retry
autoContinueOnLength	boolean	true	Retry on stopReason: "length"
autoContinueOnThinkingOnlyStop	boolean	true	Retry when only thinking emitted
autoContinueOnSilentStopAfterTool	boolean	true	Retry on silent stop after user/tool
autoContinueOnEmptyResponse	boolean	true	Retry on 0 output token responses
errorPatterns	string[]	(see config.json)	Substrings to match in error messages

License

MIT