Skip to content

agentic-wiki-writer tries to call push_wiki multiple times #281

@mrjf

Description

@mrjf

Here's a description of a failed generation:

Root Cause: Safe-outputs validation rejected 4 of 5 push_wiki calls

The agent split the wiki pages across 5 separate push_wiki tool calls (batches), but the safe-outputs infrastructure only allows 1 push_wiki item per run. The validation logs show:

Validation errors found:
- Line 2: Too many items of type 'push_wiki'. Maximum allowed: 1.
- Line 3: Too many items of type 'push_wiki'. Maximum allowed: 1.
- Line 4: Too many items of type 'push_wiki'. Maximum allowed: 1.
- Line 5: Too many items of type 'push_wiki'. Maximum allowed: 1.
Successfully parsed 2 valid output items

Only the first batch (4 files: Home.md, Architecture.md, Control-Plane.md, Session-Runtime.md) was actually pushed. The remaining 11 pages + _Sidebar.md were silently dropped.

So Home.md has a documentation index with wiki links to all 15 pages ([[Getting-Started|Getting Started]], [[CLI-Reference|CLI Reference]], etc.), but 11 of those target pages never made it to the wiki — they're all dead links.

Secondary issue: The backslash-escaped pipes in links ([[Control-Plane\|Control Plane]]) may also render incorrectly on GitHub wiki, since GitHub expects a bare | as the display-text separator.

Fix options:

  1. Have the agent send all wiki pages in a single push_wiki call instead of batching
  2. Increase the max limit for the push_wiki output type in the workflow configuration so multiple batches are accepted

Which is better? Allow more wiki pushes, or allow only one and prompt accordingly?

Also investigate and fixe the backslash pipe escape issue, if need be.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions