Struct ListSessionsArgs 

pub struct ListSessionsArgs {
    pub limit: Option<usize>,
    pub cursor: Option<String>,
    pub provider: Option<Provider>,
    pub project_root: Option<String>,
    pub project_hash: Option<String>,
    pub since: Option<String>,
    pub until: Option<String>,
    pub include_children: Option<bool>,
}

List recent AI agent sessions with cursor-based pagination.

Fields

limit: Option<usize>

Maximum number of sessions to return (default: 10, max: 50)

cursor: Option<String>

Pagination cursor from previous response’s next_cursor field. Omit for first page.

provider: Option<Provider>

Filter by provider

project_root: Option<String>

Filter by project root path (e.g., “/Users/me/projects/my-app”). Prefer this over project_hash when the agent knows the current working directory. Server will automatically resolve this to the correct project hash.

project_hash: Option<String>

Filter by project hash (internal ID). Use only when you have the exact hash; prefer project_root for ergonomic filtering.

since: Option<String>

Show sessions after this timestamp (ISO 8601)

until: Option<String>

Show sessions before this timestamp (ISO 8601)

include_children: Option<bool>

Include child sessions (subagents) in the list. By default, only top-level sessions are shown.

Trait Implementations

impl Debug for ListSessionsArgs

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ListSessionsArgs

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ListSessionsArgs

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for ListSessionsArgs

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.