# 🚀 @anna-ai/cli v0.1.23-\>v0.1.26 — Agent Session Listing (agent.session.list)

**URL:** <https://forum.anna.partners/t/anna-ai-cli-v0-1-23-v0-1-26-agent-session-listing-agent-session-list/79>\
**Category:** Changelog\
**Created:** [June 6, 2026, 10:45am UTC](https://forum.anna.partners/t/anna-ai-cli-v0-1-23-v0-1-26-agent-session-listing-agent-session-list/79 "2026-06-06T10:45:24Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![hunter](https://yyz1.discourse-cdn.com/flex033/user_avatar/forum.anna.partners/hunter/32/8_2.png) [@hunter](https://forum.anna.partners/u/hunter)\
**Post date:** [June 6, 2026, 10:45am UTC](https://forum.anna.partners/t/anna-ai-cli-v0-1-23-v0-1-26-agent-session-listing-agent-session-list/79/1 "2026-06-06T10:45:24Z")

</div>

Following the latest matrix-nexus host API, this release adds support for **listing an Agent’s sub-sessions** — completing the session-management surface alongside the existing `history` / `delete` flows.

Upgrade: `npm i -g @anna-ai/cli@0.1.26` (or `pnpm add -g @anna-ai/cli@0.1.26`)

### **✨ New `agent.session.list` host API**

- Bumped `@anna-ai/app-schema` to **0.9.0** , which adds the `agent.session.list` host method. Parameters:
  - `include_expired` (boolean, default `false`) — include expired-but-not-revoked sessions.
  - `limit` (integer, default `50`, max `100`) — newest first.

- `anna-app dev`’s local harness now **emulates** `agent.session.list`, so you can drive the full `session.list → session.history → session.delete` loop entirely offline. It returns the Agent sessions minted during the current harness run, each carrying `app_session_uuid`, `kind`, `submode`, `expires_at`, and friends.
  - Heads-up: the local harness has no shared DB and no `sampling_token`, so it can only report sessions this run minted. True cross-process session recovery still requires a live nexus — the emulation is enough to build and test your UI offline.

### **⚙ Under the hood**

- Browser SDK bumped `@anna-ai/app-runtime` **0.5.0 → 0.7.0**.
- Pinned runtime `0.2.0a7 → 0.2.0a8`.

If you build anything on top of Agent sessions, this is the one to grab — `session.list` lets your app enumerate and manage its own sub-sessions, and the dev harness mirrors it so you can iterate without a live backend.