Agent session registry
DreamLakeClient().sessions reads the shared Codex/Claude/DreamLake agent registry
through the existing account-authenticated REST API. It does not start, resume,
attach, send input, upload transcripts, or create users/services.
list(namespace, ...) and search(namespace, query, ...) return one page with
sessions, hasMore, and nextCursor. Options are q (list), search_in
(title or all, omitted means the existing broad search), provider,
machine_id, page_size (1–100), cursor, sort (recent/created), and
archived (exclude/include/only). Title filtering runs before pagination.
Start a new cursor sequence when filters change. available(owner=..., team=..., ...) explicitly searches readable sessions across owners; these filters grant
no access. Query/permission failures are not retried against another namespace.
get(namespace, registry_id) returns metadata without execution authority.
The ID is the DreamLake 24-character registry ID, not a native provider UUID;
vendorSessionId identifies the provider conversation. Descriptors retain
server-provided host/enrollment/machine/Unix-user binding, archiveOnly,
canManage, observation timestamps, fresh runState and durable attention.
A binding is not proof that transport is connected. Silence makes live runtime
unknown; it does not prove a process stopped or resolve waiting/error attention.
attention(namespace) is the personal owner's durable summary: total
needsInput/error counts and at most 20 newest previews. Organization/foreign
owner access is denied. reference(namespace, registry_id) returns a native
memo directive :session[namespace/id] without a network request.
targets(namespace) reads authorized enrolled SSH targets; target(namespace, registry_id)
resolves one exact saved binding under the existing execution-read authorization.
Neither issues a ticket nor attaches/starts a process.
No host default is inferred. Multiple Unix-user enrollment under one existing host name is not currently supported by the enrollment path. Nymph discovery stays within its enrolled Unix user and configured provider roots.
These methods use the configured client token, remote and borrowed transport.
SessionError carries a sanitized code and HTTP status (or None for
transport failures). No PTY, GraphQL session wrapper, or MCP server is provided
by this SDK. Existing CLI/GUI terminal operations remain separate.
Source: Python SDK guide.