_Kerman
0348599f04
# Conflicts: # docs/event-producer-consumer.i18n.yaml # docs/event-producer-consumer.md # docs/event-producer-consumer.zh.md # packages/acp/acp/tests/harness.ts # packages/api/session-controller/README.i18n.yaml # packages/api/session-controller/README.md # packages/api/session-controller/README.zh.md # packages/api/session-controller/tests/commands-queue-attachment.host.spec.ts # packages/context/agent-instructions/tests/agent-instructions.e2e.ts # packages/fs/tool-fs/tests/harness.ts # packages/preset/agent-presets/tests/invariant.spec.ts # packages/preset/agent-presets/tests/mount.spec.ts # packages/preset/agent-presets/tests/remote.spec.ts # packages/test-support/agent-loop-testkit/package.json
description, kind
| description | kind |
|---|---|
| Package map for the loop-hygiene guard family: the advisory repeat-tool reminder and the per-call tool-call timeout policy, for users and maintainers choosing or composing the guards. | package-group |
guard/ — loop-hygiene guard family
English | 中文
Summary
The guard/ group keeps the agent loop productive by watching for two common failure patterns. repeat-tool-reminder notices when the model repeats the exact same tool call and reminds it to change approach or finish, so a stuck loop stops burning time and tokens. timeout-policy puts a time limit on tool calls that declare one, so a hung call returns a clear timed-out error to the model instead of stalling the session. Both ship enabled in the dsh base bundle; a composition can tune or remove them.
Table of Contents
Packages
Two small plugins cover the two patterns; each README below explains when to keep, tune, or remove it.
| Package | What it provides |
|---|---|
repeat-tool-reminder/ |
Reminds the model when it repeats the same tool call, so it changes approach or finishes |
timeout-policy/ |
Times out tool calls that declare a limit, so the model gets a clear error instead of waiting forever |
Related documentation
Start with the tools subsystem reference for the tool-call pipeline, then the reminder's configuration and the timeout-library decision behind the policy.
- Tools subsystem reference — the tool-call pipeline and decisions both guards build on.
- Generated configuration catalog — every accepted field of the repeat-call reminder.
- Timeout deadline library Agent Note — the timing/termination split
timeout-policyenforces.
Dev Note
Working context for maintainers — click to expand
None.