briefing
Generate session briefing ·read-only · non-destructive · non-idempotent · closed-world
Return a single structured briefing covering commitments, blockers, overdue,
stale commitments, recent decisions, and preferences. Collapses the per-section
resource-read sequence (engram://commitments etc.) into one tool call.
Returns a dict shaped as BriefingResponse:
{project, commitments, blockers, overdue, stale, recent_decisions, preferences}. Each memory list contains MemoryHit objects
(id, topic, content, status, due_date, …).
The structured payload is surfaced verbatim as MCP
structuredContent alongside the human-readable text.
Returns: dict[str, Any] | ToolResult | str
Source: backend/src/engram/mcp/tools/briefing.py
Parameters
Optional project name to scope every section.
If True, return a compact representation — drops
content from every MemoryHit in the structured payload and emits a one-line- per-memory text block instead of serialized JSON. Recommended as the default for agent workflows: the full mode returns ~50KB per call (Claude Code persists tool output over ~20KB to disk), while brief mode typically lands under 10KB. Follow up with get_memories(ids=[...]) when you need the full content of specific items.Optional whitelist of sections to include. Valid values:
commitments, blockers, overdue, stale, recent_decisions. Omitted sections return as empty lists in the structured payload and are skipped from text output. Preferences are always included (cheap). None (default) returns every section.