Python
"""`context_snapshot` — the window-occupancy readout behind the GUI's Context panel (FB-015).
The split (system / tools / messages) is always a chars/4 estimate; `used` prefers the
provider-reported prompt-side total from the latest round trip and says when it had to
fall back to the estimate.
"""
from __future__ import annotations
import pytest
from coworker.engine import EventType, TurnEngine
from coworker.permissions import Mode, PermissionEngine
from coworker.providers import (
AssistantTurn,
ModelCapabilities,
ProviderClient,
)
from coworker.providers.base import TokenUsage
from coworker.tools import ToolRegistry
class OneReplyProvider(ProviderClient):
def __init__(self, usage: TokenUsage | None = None):
self.usage = usage
def complete(self, *, model, messages, tools=None, **settings):
return AssistantTurn(text="done", tool_calls=[], usage=self.usage)
def capabilities(self, model):
return ModelCapabilities(tools=True)
def _engine(tmp_path, provider):
return TurnEngine(
provider=provider,
registry=ToolRegistry(),
permissions=PermissionEngine(workspace_root=tmp_path, mode=Mode.INTERACTIVE),
model="m",
)
def test_estimate_fallback_splits_system_tools_and_messages(tmp_path):
engine = _engine(tmp_path, OneReplyProvider())
engine.messages.append({"role": "system", "content": "s" * 400})
engine.messages.append({"role": "user", "content": "u" * 800})
snap = engine.context_snapshot()
assert snap["estimated"] is True
b = snap["breakdown"]
# chars/4 over the serialized message: at least the content's share, in each bucket.
assert b["system"] >= 100
assert b["messages"] >= 200
assert b["tools"] == 0 # a bare registry carries no schemas
assert snap["used"] == b["system"] + b["tools"] + b["messages"]
# An unlisted model has no window; the GUI shows "window unknown" (UX-048).
assert snap["window"] is None
assert "compaction" not in snap # never compacted
@pytest.mark.asyncio
async def test_reported_usage_wins_and_rides_the_assistant_message(tmp_path):
usage = TokenUsage(input=900, output=10, cache_read=2100, cache_write=0)
engine = _engine(tmp_path, OneReplyProvider(usage))
events = [e async for e in engine.run("hello")]
replies = [e for e in events if e.type is EventType.ASSISTANT_MESSAGE]
snap = replies[-1].data["context"]
assert snap["used"] == usage.context_tokens # 900 + 2100
assert snap["estimated"] is False
assert set(snap["breakdown"]) == {"system", "tools", "messages"}