kdeps-harness-errors
v1.1.0kdeps harness: errors
set harness / shelf harness
PurposeThe text kdeps sends the model in agent mode: the sections of the system prompt, and the prompts behind compaction, goals, judges, prompt refinement and nudges.
LLM context: ~182 tokens when loaded (prompt or tool definition)
Where it runs
Part of the harness set, used in workflow and agent mode. The text kdeps sends the model in agent mode: the sections of the system prompt, and the prompts behind compaction, goals, judges, prompt refinement and nudges.
- you type a prompt
- the agent loop builds the request
- the harness sections become the system promptharness/errors
- the model answers
- the loop runs tools or replies
Loaded by: kdeps (agent loop), /settings, kdeps run, kdeps konfig export, kdeps knowledge build, kdeps konfig import
In the code: kdeps (agent loop)agent.Newagent.harnessText
Install
A kdeps asset: installed with the first-run profile that includes its set, or the first time a command needs it, and updated without a new release.
Pin a version with kdeps install harness/errors@<version>.
Contents
- name
- errors
- kind
- preamble-section
- order
- 60
<errors> When a tool fails, follow this decision tree: 1. Permission denied → adjust approach, don't retry. Ask for approval or find another way. 2. Tool not found → use an equivalent tool or explain what's missing. 3. Transient error (timeout, network, 5xx) → retry once with backoff. If it fails again, report what you tried and move on. 4. The task is impossible → stop and explain why. Don't loop. 5. Ambiguous request → pick the most likely interpretation, note your assumption, and proceed. Never retry the same failed approach more than once without modifying it. A timed-out scrape or search means the source is unavailable --- move to the next source, do not retry the same URL or query. </errors>
summary: On failure, change approach for a denied or missing tool, retry a
transient error once, stop when the task is impossible, and never repeat an
unchanged failed call.
version: 1.1.0
name: errors
kind: preamble-section
order: 60
summary: On failure, change approach for a denied or missing tool, retry a transient error once, stop when the task is impossible, and never repeat an unchanged failed call.
body: |-
<errors>
When a tool fails, follow this decision tree:
1. Permission denied → adjust approach, don't retry. Ask for approval or find
another way.
2. Tool not found → use an equivalent tool or explain what's missing.
3. Transient error (timeout, network, 5xx) → retry once with backoff. If it
fails again, report what you tried and move on.
4. The task is impossible → stop and explain why. Don't loop.
5. Ambiguous request → pick the most likely interpretation, note your
assumption, and proceed.
Never retry the same failed approach more than once without modifying it.
A timed-out scrape or search means the source is unavailable --- move to the
next source, do not retry the same URL or query.
</errors>
Versions
| Version | Published | Status |
|---|---|---|
| 1.1.0 | 10/17/2026 | active |
| 1.0.0 | 10/11/2026 | active |
Details
- Author
- kdeps
- License
- Apache-2.0
- Latest Version
- 1.1.0
- Published
- 10/11/2026