Session

Field	Type	Behavior	Description
name	string	OUTPUT_ONLY	Resource name (agents/{agent}/sessions/{session})
associated_resources	string[]		Resource names linked to this session (e.g. objectives/abc, incidents/xyz)
incognito	bool		Hidden from normal listings; write operations (issues, notes, slack) are skipped
automated	bool		Started by automation (scheduled runs, triggers). The bash tool auto-denies any domain-approval request instead of pausing — there’s no human to click Approve/Deny
title	string		Human-readable title for chat history and session pickers
created_by	string	OUTPUT_ONLY	ID of the user who started this session; empty for system-created automation and credentials-based callers without a user identity
nxl_plan_sha256	string	OUTPUT_ONLY	SHA-256 of the compiled NXLPlan that bootstrapped this session. Empty for non-NXL sessions and historical NXL sessions created before this field was stamped
create_time	timestamp	OUTPUT_ONLY	When the session was created
update_time	timestamp	OUTPUT_ONLY	When the session was last modified
delete_time	timestamp	OUTPUT_ONLY	When the session was soft-deleted (null if active)

Example

{
  "name": "agents/objectives-evaluator/sessions/ses-00ab12cd34ef",
  "associatedResources": [
    "objectives/obj-daily-uptime",
    "objectives/obj-daily-uptime/evaluations/eval-56gh78ij"
  ],
  "createTime": "2026-02-13T01:02:36.105551Z",
  "updateTime": "2026-02-13T01:02:36.105551Z"
}

Session Description

A richer, read-only view of a session including runtime state from the execution engine.

Field	Type	Behavior	Description
session	Session	OUTPUT_ONLY	The session being described
status	Session Status	OUTPUT_ONLY	Current execution status of the session
session_length	integer	OUTPUT_ONLY	Number of messages in the session
last_message	timestamp	OUTPUT_ONLY	Timestamp of the last message in the session
conclusion	SessionConclusion	OUTPUT_ONLY	Conclusion of the session, if the agent has concluded
trigger	Trigger	OUTPUT_ONLY	The trigger that started this session, if any. Resolved at read time from session.associated_resources. Reflects the trigger’s current configuration, not its state at fire time. Absent for manual / non-trigger-driven sessions.

Session Status

Value	Description
STATUS_UNSPECIFIED	Session state is undefined (session has no objects)
STATUS_EXECUTING	Agent is currently executing
STATUS_WAITING	Agent is waiting (paused or idle)

Session Conclusion

The conclusion of a completed session. Exactly one of done or abort will be set.

Field	Type	Description
done	Done	The agent completed its task
abort	Abort	The agent aborted before completing

Done

Field	Type	Description
message	string	Summary of what the agent accomplished
issues	ConclusionIssue[]	Issues discovered during the session

Abort

Field	Type	Description
message	string	Explanation of why the agent aborted

Conclusion Issue

An issue discovered by the agent during a session.

Field	Type	Description
title	string	Short title for the issue
description	string	Detailed description of the issue

Trigger

A trigger fires sessions automatically — on a cron schedule, when a Slack message is posted, after a deploy, when a row matches a predicate, etc. When a trigger fires a session, that session’s SessionDescription.trigger carries the trigger resource so consumers know what kicked the session off.

Field	Type	Behavior	Description
name	string	OUTPUT_ONLY	Resource name (triggers/{trigger})
display_name	string		Human-readable name shown in the UI
description	string		Optional longer description
agent	string		Resource name of the agent this trigger targets (agents/{agent})
enabled	bool		Whether the trigger is currently active
configuration	TriggerConfiguration		Type-specific configuration (cron schedule, Slack channels, etc.)

Trigger Configuration

Exactly one of the configuration fields is set, identifying the trigger type:

Field	Description
cron	Fires on a cron schedule. Carries schedule and timezone.
manual	User-driven via webhook. Carries optional webhook_address.
post_deploy	Fires after a deploy completes. Carries repository, environment, sha, delay.
row	Fires when a row matching a predicate appears in a table. Carries table_name, predicate, cooldown.
slack_message_posted	Fires on any message posted to one of the listed channels.
slack_agent_mentioned	Fires when the agent’s Slack user-group handle is @mentioned.

See proto/firetiger/triggers/v1/triggers.proto for the full field-level schema of each configuration variant.

Artifact

Field	Type	Description
contents	bytes	Raw bytes of the artifact