Module session_status 

Where an agent session stands: what the runtime-provided session-status tool reports, the hard deadline a session runs under, and the one notice an agent is given before it.

[SessionStatus] holds no number of its own. It is fed at the funnels that already produce each one — the trace writer’s inference, task_start and task_end writes, and the http agent loop’s compaction check — and a call reads the spend meter as it stands. So every field a call returns agrees with the trace written before it.

Structs

SessionDeadline

The hard limit a session runs under: its own mur run --deadline, or the moment it inherited from the formation or capsule that launched it.

Enums

DeadlineSource

Where a session’s deadline came from.

Constants

INHERITED_DEADLINE_FLAG

The hidden mur run flag a formation launcher and a child launcher pass a deadline down with: the deadline’s wall moment in milliseconds since the Unix epoch.

INPUT_SCHEMA

session-status’s input schema: no input.

MAX_DEADLINE_SECS

The longest deadline a session runs under: ten years. A larger one overflows the clocks the deadline is read against.

SESSION_STATUS_TOOL

The runtime-provided tool every agent capsule has, on both transports, with no grant.

Functions

default_notice_secs

The notice margin a deadline of deadline_secs gets when lifecycle.deadline_notice_secs is not declared: five minutes, or a tenth of the deadline when that is shorter, and at least one second.

description_http

session-status’s description under transport: http. Fixed, so the tool array’s bytes do not change from one request to the next.

description_process

session-status’s description under transport: process. Fixed, as description_http is.

notice_secs

The margin in force: the declared lifecycle.deadline_notice_secs, or the default for the deadline. 0 sends no notice.