vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-08-23 23:37:05 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
agent-zero/plugins/_context_window/AGENTS.md
Alessandro f8c96860c2
Some checks are pending
Build And Publish Docker Images / plan (push) Waiting to run
Details
Build And Publish Docker Images / build (push) Blocked by required conditions
Details
Add context window usage indicator 
Add a bundled context-window plugin with a composer usage ring, responsive breakdown popover, token counts, percentages, and free-space reporting.

Keep accounting plugin-owned, reuse existing history token counts, cache bounded prompt fragments by content, and expose independent mobile and desktop visibility controls.
2026-08-23 06:08:41 +02:00

2 KiB
Raw Permalink Blame History

Context Window Plugin DOX

Purpose

  • Own context-window token accounting, the usage API, the composer indicator, its popover, and its Interface visibility row.

Ownership

  • helpers/usage.py owns per-prompt bucket measurement and reconciliation.
  • extensions/python/ records prompt parts at their source extension points.
  • api/context_window.py exposes the active chat's token usage and effective model limit without returning prompt content.
  • webui/ and extensions/webui/ own the Alpine store, indicator, popover, model-override refresh, and Interface visibility row.

Local Contracts

  • The six used-token buckets are messages, system_tools, skills, mcp_tools, system_prompt, and extras.
  • Tools, MCP tools, and the available-skills catalog are measured from their extensible prompt builders, never inferred from rendered headings.
  • Loaded skill instructions are removed from Messages and added to Skills.
  • Protocol and prompt extras are reported together as Extras.
  • Messages reuse the history record token ledger; independently rendered fragments use a bounded, content-addressed, runtime-only cache.
  • Bucket totals reconcile to the already-stored prompt token total; the unclaimed remainder belongs to System prompt.
  • Older chats without a stored breakdown show the explanatory empty state.
  • _model_config supplies the effective model limit and the model-context-strip-end WebUI slot; it does not own this feature's state.
  • The contextWindowUsage Interface setting defaults to visible on mobile and desktop.

Work Guidance

  • Keep prompt accounting out of rendered-text heuristics.
  • Keep the API response limited to counts needed by the UI.
  • Preserve the upward, right-aligned popover geometry used beside the model and profile selectors.

Verification

  • Run conda run -n a0 pytest plugins/_context_window/tests.
  • Smoke-test the indicator, popover, chat switching, post-run refresh, and mobile/desktop visibility against the live WebUI.

Child DOX Index

No child DOX files.