session_end
Idempotent
Finalize and persist session findings, with optional mishap reporting, for future briefings.
Instructions
Complete the current session, persisting its findings for future briefings. Uses the bound session unless you pass one.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mishaps | No | Self-report mishaps this session caused: an action a warning or convention said not to take, live state touched by mistake, a command that hit the wrong target. Pass an array with one short entry per incident; omit when none happened. When a mishap violated a stored memory, name that memory by its exact slug in the entry (e.g. "violated chroma-boot-race by ...") -- the report is then linked to it. Recorded for recurrence review, not blame -- report them even when fully recovered. | |
| session | No | Session name to operate on: the cc/<id> or cx/<id> on your briefing's 'Seam session' line, or a sess/* name. Defaults to the bound session; pass it whenever you have not run session_start and several agents are active -- the bare call is then ambiguous and fails rather than guesses | |
| findings | Yes | Final findings: what was learned, decided, or left open. Prefer a tight summary (briefings show a short preview), but long findings are stored in full -- they are not rejected. | |
| session_id | No | Session ULID to operate on; takes precedence over session and the bound session |