session_recall

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

Purpose

Recalls recent session snapshots, newest first. The resume path: pick up project, summary, active files, and timestamps from earlier runs.

Arguments

Optional: last_n.

last_n. Note: How many sessions to return (default 5). Integers, integral floats, and booleans are accepted; other types are rejected.

Result

JSON object with sessions (session_id, project, summary, active_files as a list or null, started_at, ended_at, each null where unset) and count. No visible scope returns sessions [] with count 0.

Boundaries

Only sessions inside the caller's project grants are returned, and callers without star scope see only sessions owned by their own principal. Anything else reads as an empty list, never a denial.

Lifecycle / side effects

Pure read; recalling changes nothing about the sessions returned.

Errors

Bad last_n types are rejected (strict validator). Unknown arguments are rejected.

Example

{
  "last_n": 5
}

Result shape:

{
  "count": 1,
  "sessions": [
    {
      "active_files": null,
      "ended_at": "<iso-8601>",
      "project": "shared-ops",
      "session_id": "<uuid>",
      "started_at": "<iso-8601>",
      "summary": "Pack README drafted; left proofing for next run."
    }
  ]
}