[theomonnom]

Adds LiveKitAPI.threads and LiveKitAPI.databases (agent threads and agent databases on the LiveKit Cloud Public API), mirroring livekit/rust-sdks#1379.

from livekit import api

async with api.LiveKitAPI() as lkapi:
    thread = await lkapi.threads.create_thread(api.CreateThreadRequest(scope="user_42"))
    items = await lkapi.threads.get_thread_items(api.GetThreadItemsRequest(thread_id=thread.thread_id))
    await lkapi.threads.delete_thread(thread_id=thread.thread_id)

    dbs = await lkapi.databases.list_databases(api.ListDatabasesRequest())

Errors are the same ServerError as the other services. Twirp and Public API services now share one BaseService, and the error types moved to livekit.api.errors.

livekit/api/_generated/ is generated by livekit-api/public-api/generate.sh from the vendored openapi.yaml (OpenAPI Generator, aiohttp). The spec is from public-api-server@e273831, since livekit/public-api-server#150 hid these operations.

[devin-ai-integration]

Note

Newer findings are available below. Devin Review posted a newer report on this PR, in addition to the findings presented here.

Devin Review found 1 new potential issue.

1 flag not posted on this PR by your GitHub settings — view it in Devin Review. (Configure)

[devin-ai-integration]

🟡 Negative page sizes break list requests

For a negative list limit or page_size, _call sends that value instead of leaving the page size unset. The server receives an invalid page.pageSize, so the list request fails rather than using its default size.

Learn more

The four list methods pass protobuf integer page sizes through list, which forwards them as page_page_size to _call. The filter omits zero but preserves negative sizes, while the earlier page_size helper omitted every nonpositive size. The generated list operations serialize any present integer into page.pageSize, so a negative size reaches the server.

Example: With AgentThread.ListRequest(limit=-1), list_threads now sends page.pageSize=-1. Previously it omitted page.pageSize, letting the server apply its default page size.

Recommended fix: Normalize page_page_size in PublicApiClient.list with limit if limit > 0 else None, while preserving _call filtering for optional strings and zero-valued fields.

---

Was this helpful? React with 👍 or 👎 to provide feedback.