stacklok / stacklok/mecatl

Expose context-size summaries for subagent runs

Open
#951 0 comments 0 reactions 1 assignee View on GitHub

@jbeda is already working on this.

Since Sep 2, 2026.

Dominant language
Go
Stars
152
Forks
16
Avg merge
14h 48m
Merged PRs (30d)
536

Description

Problem\n\nThe main run exposes context-window information, but delegated subagent activity does not provide comparable context-size summaries. Operators cannot tell how much context a subagent is using or how close it is to its resolved window.\n\n## Desired behavior\n\nReport concise per-subagent context summaries through the existing delegation observability surface, so clients can display context usage/window information while a subagent runs and/or at its terminal outcome.\n\n## Scope to determine\n\n- Define the summary fields, including estimated current request tokens, resolved context-window size, and whether estimates are live or terminal-only.\n- Thread the data through subagent lifecycle events without leaking child conversation content into the parent.\n- Cover foreground, background, resumed, direct-write, and model-override subagents; specify whether Parallel branches and team members should share the same projection.\n- Keep the context-window source consistent with the existing per-model, live-resolved context-window closure.\n\n## Acceptance idea\n\nOffline child-run coverage proves a subagent lifecycle projection contains the expected context summary for its resolved model, and client rendering shows it without altering the parent conversation.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.