You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maka.apache.org by "colaforniaw (via GitHub)" <gi...@apache.org> on 2026/09/05 16:55:58 UTC
[I] feat(desktop): tailor tool result rendering to the content [maka]
colaforniaw opened a new issue, #4863:
URL: https://github.com/apache/maka/issues/4863
## Problem
Maka currently renders most tool details through the same generic text and JSON presentation. This makes useful results harder to scan and gives long, low-value output the same visual treatment as diffs, errors, and actionable status messages.
`WebFetch` is the clearest example. Runtime converts HTML to readable Markdown, but the UI still presents the fetched page as a generic text result. A reader must open a large block of content to find basic information such as the URL, page title, or a short summary.
Other tools have the same mismatch:
- Retrieval tools can return many lines or matches.
- Large JSON results can dominate an expanded detail panel.
- Status-only results can expose redundant detail controls.
- Subagent results are more useful as a status, summary, and navigation target.
- Shell, diff, search, workflow, and media results already need their own presentation.
## Desired outcome
Each tool result should show the smallest useful summary by default and keep complete content available through an explicit, bounded detail view.
The presentation should depend on the tool and the result content:
- `WebFetch` shows the URL, status, and a short page summary. Fetched Markdown remains available on demand.
- `Read`, `Grep`, `Glob`, and `Find` show a bounded initial result and a count when available.
- Large text and JSON results show a compact summary before their full content.
- Diffs, shell output, search results, workflows, media, and agent results continue to use specialized previews.
- Status-only results show the actionable state without an empty or redundant detail panel.
- Unknown results use a safe, bounded fallback.
Astryx `ChatToolCalls` remains responsible for group summaries, collapse behavior, row disclosure, keyboard interaction, and accessibility semantics. Maka supplies the appropriate summary and optional `resultDetail`; it should not hide or reimplement Astryx controls.
## Scope and implementation direction
- Extend the existing `standardToolCall` and `ToolResultPreview` paths.
- Add a WebFetch-specific presentation without adding another HTML parser. Runtime already converts HTML to Markdown.
- Add shared bounds for long text, JSON, retrieval results, shell output, and diffs.
- Provide a clear way to view complete content when a preview is truncated.
- Only provide `resultDetail` when the result has meaningful content to inspect.
- Preserve chronological grouping, existing output redaction, durable results, and current specialized renderers.
- Avoid a new renderer registry until the existing dispatch paths become difficult to maintain.
- Avoid CSS selectors that depend on Astryx internal DOM nesting. Use stable component hooks or props when layout access is required.
## Acceptance criteria
A reader can understand what each tool did from its collapsed row or compact preview without opening a large raw result. Detailed content remains available when needed, but no single result or tool group overwhelms the conversation. Astryx disclosure and accessibility behavior remain intact.
## Out of scope
- Tool execution, provider responses, or event persistence.
- Changes to chronological tool grouping.
- Replacing Astryx `ChatToolCalls`.
- User-configurable rendering policies.
- Side inspectors, virtualization, or transcript-level group scrolling. The group layout work is tracked separately in #4773.
## Related work
- #4773 — Bound expanded tool activity in the conversation.
- `docs/tool-result-rendering-strategy-reference.md` — Research on tool-specific result renderers and default output boundaries.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org
For additional commands, e-mail: commits-help@maka.apache.org
Re: [I] feat(desktop): tailor tool result rendering to the content [maka]
Posted by "colaforniaw (via GitHub)" <gi...@apache.org>.
colaforniaw commented on issue #4863:
URL: https://github.com/apache/maka/issues/4863#issuecomment-5553343375
take
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org
For additional commands, e-mail: commits-help@maka.apache.org
Re: [I] feat(desktop): tailor tool result rendering to the content [maka]
Posted by "Colafornia (via GitHub)" <gi...@apache.org>.
Colafornia commented on issue #4863:
URL: https://github.com/apache/maka/issues/4863#issuecomment-6057785147
First slice split out as #5997: provide `resultDetail` only when a tool row's detail adds information, and render `summary` results instead of the `[summary]` placeholder. The rest of this issue's scope stays here.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@maka.apache.org
For additional commands, e-mail: commits-help@maka.apache.org