Files
openswarm/backend/apps/agents/manager/context_budget.py
T

71 lines
3.0 KiB
Python

"""Token accounting + the context-ratio compaction trigger, lifted out of the agent loop.
Both operate on a passed AgentSession (no manager state). emit_context_update writes the
live token counts onto the session and broadcasts them to the UI; maybe_compact decides,
from the same input_tokens/context_window ratio, whether to mark history for trimming.
Compaction here only MARKS (sets compacted_through_msg_id); it never mutates
session.messages, the originals stay for the UI drawer and only the history sent to the SDK
is trimmed downstream (see backend/CLAUDE.md: "compaction must actually trim, not just mark")."""
from typing import Optional
from typeguard import typechecked
from backend.apps.agents.core.models import AgentSession
from backend.apps.agents.core.ws_manager import ws_manager
from backend.apps.agents.manager.session.history_compaction import get_branch_messages
@typechecked
def maybe_compact(session: AgentSession, force: bool = False) -> bool:
"""Mark history for compaction when ctx_used_pct >= compact_threshold_pct (or force).
Returns True if a NEW summary boundary was set. Summarizes everything up to (but not
including) the last 6 messages so recent intent stays visible to the model. Never
touches session.messages."""
ctx_used = session.tokens.get("input", 0) / max(1, session.context_window)
if not force and ctx_used < session.compact_threshold_pct:
return False
msgs = get_branch_messages(session)
if len(msgs) < 4:
return False
cutoff = max(0, len(msgs) - 6)
if cutoff == 0:
return False
last_id = msgs[cutoff - 1].id
if session.compacted_through_msg_id == last_id and not force:
return False
session.compacted_through_msg_id = last_id
return True
@typechecked
async def emit_context_update(
session_id: str,
session: AgentSession,
*,
input_tokens: Optional[int] = None,
output_tokens: Optional[int] = None,
cache_read_tokens: int = 0,
cache_read_pct: float = 0.0,
) -> None:
"""Persist the live token counts onto the session and broadcast the context-usage meter
to the UI. When input/output aren't supplied, the session's current counts are reused."""
if input_tokens is None:
input_tokens = int(session.tokens.get("input", 0) or 0)
if output_tokens is None:
output_tokens = int(session.tokens.get("output", 0) or 0)
session.tokens["input"] = input_tokens
session.tokens["output"] = output_tokens
ctx_window = max(1, getattr(session, "context_window", 0) or 200_000)
await ws_manager.send_to_session(session_id, "agent:context_update", {
"session_id": session_id,
"input_tokens": input_tokens,
"output_tokens": output_tokens,
"cache_read_tokens": cache_read_tokens,
"cache_read_pct": cache_read_pct,
"ctx_used_pct": round(input_tokens / ctx_window, 4) if input_tokens else 0.0,
"context_window": ctx_window,
"framework_overhead_tokens": session.framework_overhead_tokens,
"active_mcps": list(session.active_mcps),
})