Summary

Adds pre_context_compress hook that fires before context compression, enabling alternative context management strategies (LCM, RAG, vector DB, etc.).

Install:

No installation required — hook is available immediately for extensions to register.

Usage:

Extensions register the hook in their register() function:

def register(ctx):
    ctx.register_hook("pre_context_compress", my_context_handler)

The handler receives session_id, messages, token_budget, model, platform and can return an alternative messages array. Falls back to default compression if no extension handles it.

Files

Tests

Handler loads correctly when no extensions registered, runs without error, falls back to default compression, receives correct parameters. pytest tests/test_plugins.py -v (19 tests pass, 4.06s).