Skip to content

Add agent session store protocols - #1686

Open
theomonnom wants to merge 3 commits into
mainfrom
theo/agent-session-protos
Open

Add agent session store protocols#1686
theomonnom wants to merge 3 commits into
mainfrom
theo/agent-session-protos

Conversation

@theomonnom

Copy link
Copy Markdown
Member

Adds the two protocols the agent session store speaks. Both are new files; nothing existing changes shape.

livekit_agent_session_store.proto is the management API (Twirp AgentSessionStore): CreateSession, GetSession, ListSessions, DeleteSession, and Dump for a pre-authenticated download URL of a session consistent at a commit sequence.

livekit_agent_session_db.proto is the data plane: one SessionStoreRequest / SessionStoreResponse frame pair over a single WebSocket per session, correlated by a client-chosen request_id. It carries exec, query, atomic batch, interactive transactions (begin/commit/rollback), cancel, and ping. Query results stream as SessionRowBatch frames paced by credits the client advertises, so any result size streams with bounded memory at every hop. SessionValue mirrors SQLite's five storage classes exactly.

Why the other files changed

protoc-gen-twirp numbers file descriptors by position within a single protoc invocation, so inserting one service shifts every file after it. The eight *.twirp.go diffs are exactly that rename, two lines each, and magefile.go adds the two protos to the generation lists. Generated with the repo's own mage proto.

Context

This unblocks the session store service, which currently cannot build outside a local checkout of this repo.

livekit_agent_session_store.proto is the management API (Twirp): create, get,
list and delete a session, plus Dump for a consistent download URL.

livekit_agent_session_db.proto is the data plane: a request/response frame pair
over one WebSocket per session, correlated by client-chosen request_id, with
exec, query, atomic batch, interactive transactions, and credit-paced row
batches so any result size streams with bounded memory at every hop.
SessionValue mirrors SQLite's five storage classes.

The other twirp files change only because protoc-gen-twirp numbers file
descriptors by position in the invocation, so inserting one service shifts the
ones after it.
@changeset-bot

changeset-bot Bot commented Jul 27, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 1aeca88

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

github-actions Bot and others added 2 commits July 27, 2026 17:41
Regenerated, so the same lines leave the Go doc comments.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants