Data Structures¶

Core dataclasses used in the agentwatch API.

`SessionState`¶

State for a single tmux session.

Source: agentwatch/service/state_store.py

Fields:

Field	Type	Default
`session_name`	`str`	-
`session_id`	`str`	-
`program`	`Optional[str]`	None
`program_version`	`Optional[str]`	None
`state`	`Optional[str]`	None
`detail`	`Optional[str]`	None
`changed_at`	`Optional[datetime]`	None
`updated_at`	`Optional[datetime]`	None
`previous_program`	`Optional[str]`	None
`previous_state`	`Optional[str]`	None
`previous_detail`	`Optional[str]`	None
`monitor_active`	`bool`	False
`last_error`	`Optional[str]`	None
`capture_count`	`int`	0
`capture_reset_requested`	`bool`	False
`current_viewer_session`	`Optional[str]`	None
`last_detection`	`Optional[dict]`	None
`last_transition`	`Optional[dict]`	None
`last_raw_text`	`Optional[str]`	None
`parsed_history`	`Optional[List[Dict]]`	None
`parsed_prompt`	`Optional[Dict]`	None
`parsed_activity`	`Optional[Dict]`	None
`parse_timestamp`	`Optional[str]`	None
`parsed_summary`	`Optional[Dict]`	None
`summary_timestamp`	`Optional[str]`	None

Result of a detection operation.

Source: agentwatch/detectors/base.py

Fields:

Field	Type	Default
`name`	`str`	-
`version`	`Optional[str]`	-
`confidence`	`float`	-
`state`	`Optional[str]`	None
`detail`	`Optional[str]`	None

When a hook should fire.

Source: agentwatch/service/hooks/base.py

What capture data to include with hook.

Source: agentwatch/service/hooks/base.py

Event data passed to hooks.

Source: agentwatch/service/hooks/base.py

Fields:

Field	Type	Default
`trigger`	`HookTrigger`	-
`session_name`	`str`	-
`session_id`	`str`	-
`timestamp`	`datetime`	-
`program`	`Optional[str]`	-
`program_version`	`Optional[str]`	-
`state`	`Optional[str]`	-
`detail`	`Optional[str]`	-
`previous_program`	`Optional[str]`	-
`previous_state`	`Optional[str]`	-
`previous_detail`	`Optional[str]`	-
`duration_seconds`	`float`	-
`detection`	`Optional[dict]`	None
`transition`	`Optional[dict]`	None
`raw_text`	`Optional[str]`	None
`parsed_prompt`	`Optional[Dict[str, Any]]`	None
`parsed_activity`	`Optional[Dict[str, Any]]`	None
`session_env`	`Optional[Dict[str, str]]`	None

Result of a hook execution.

Source: agentwatch/service/hooks/base.py

Fields:

Field	Type	Default
`success`	`bool`	-
`hook_name`	`str`	-
`error`	`Optional[str]`	None
`response_status`	`Optional[int]`	None
`response_body`	`Optional[str]`	None
`execution_time_ms`	`float`	0