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
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

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

Artifact

Field	Type	Description
contents	bytes	Raw bytes of the artifact