Clarify tool result limits apply only in local mode, add notes on unlimited incoming tool calls and dropped tool call detection

This commit is contained in:
2026-02-06 11:28:59 +01:00
parent d554538f50
commit ce0065fe8c
+12 -3
View File
@@ -824,19 +824,28 @@ import BaseLayout from '../layouts/BaseLayout.astro';
<h2 class="section-title">Tool Result Handling</h2>
<div class="info-card">
<p class="info-text">Tool results are automatically truncated if they exceed limits:</p>
<p class="info-text">The 50KB / 2000 line limits apply <strong>only to tool results</strong> — what zblade sends back to the model after executing a tool (e.g., the output of <code>read_file</code>). These limits only apply in <strong>local mode</strong>, when the Zagu&aacute;n Coder Daemon isn't handling storage.</p>
<div class="limits-row">
<div class="limit-box">
<span class="limit-value">50KB</span>
<span class="limit-label">Max size</span>
<span class="limit-label">Result max size</span>
</div>
<div class="limit-box">
<span class="limit-value">2000</span>
<span class="limit-label">Max lines</span>
<span class="limit-label">Result max lines</span>
</div>
</div>
<p class="info-text-secondary">When truncated, the first 100 lines and last 50 lines are shown with a truncation message.</p>
</div>
<div class="info-card" style="margin-top: var(--space-lg);">
<p class="info-text"><strong>There are no size limits on incoming tool calls from the model.</strong> zblade will accept a <code>write_file</code> with any size content. The <code>write_file</code> handler itself has no caps — it writes whatever content string it receives directly to disk.</p>
</div>
<div class="tool-note" style="margin-top: var(--space-lg);">
<span class="note-icon">️</span>
<p class="note-text">zblade includes <strong>dropped tool call detection</strong>. If a tool call from the model never arrives (e.g., streaming progress events complete but the final tool call with arguments is dropped server-side), zblade will catch this and surface a clear error.</p>
</div>
</div>
</section>