resume_context

Category: sessions
Access: write
Audience: ordinary (an ordinary user normally calls this directly)

Purpose

Session continuity bundle: handoff pack plus unresolved questions, chunks awaiting human input, and recently changed facts. Call it to resume work where the last session left off.

Arguments

Optional: include_open_questions, session_id.

include_open_questions. Note: Defaults true; false skips the open-question scan.
session_id. Note: Malformed ids fail with the session_save vocabulary; unowned ids read as session not found with no owner oracle. Absent means a general handoff with no session data.

Result

Object with session_id (null when absent), open_questions (up to 20 with text, type, priority, chunk title), changed_facts_since_last_session (up to 20), chunks_awaiting_human (up to 10), pack (pack_id, token_usage, freshness_score, body), and a summary string.

Boundaries

A supplied session must be owned by the caller (star bypasses). Open questions, awaiting chunks, and recent facts are global scans inside the selected profile boundary.

Lifecycle / side effects

Builds and persists a handoff pack with a run-history entry, then reads the top 20 open questions, top 10 awaiting chunks, and facts changed in the last 7 days. Read-shaped but persisted through the pack, hence write access.

Errors

Malformed session_id returns a normal session-must-be-UUID error. Unowned sessions return session not found. Backend failures surface as transport errors.

Example

{
  "include_open_questions": true
}

Result shape:

{
  "chunks_awaiting_human": [],
  "open_questions": [],
  "pack": {
    "body": "...",
    "freshness_score": 0.5,
    "pack_id": "<uuid>",
    "token_usage": 400
  },
  "summary": "Session resume: 0 open questions, 0 chunks awaiting human, 0 recently changed facts."
}