soulfire.logs_connect.LogsService

class soulfire.logs_connect.LogsService[source]

Bases: Protocol

Service for accessing SoulFire server logs. Provides both historical log retrieval and real-time log streaming capabilities. All methods require appropriate authentication and permissions based on the requested scope.

async get_previous(request: soulfire.logs_pb2.PreviousLogRequest, ctx: connectrpc.request.RequestContext[soulfire.logs_pb2.PreviousLogRequest, soulfire.logs_pb2.PreviousLogResponse], /) → soulfire.logs_pb2.PreviousLogResponse[source]

Retrieves historical log entries from the server’s in-memory log buffer. The server maintains a rolling buffer of the last 300 log entries. Only returns non-personal logs that match the specified scope.

Permissions required: - GlobalLogScope: GLOBAL_SUBSCRIBE_LOGS - InstanceLogScope/BotLogScope/InstanceScriptLogScope: INSTANCE_SUBSCRIBE_LOGS for the instance - PersonalLogScope: No special permissions (but returns empty since personal logs are not stored)

Errors: - PERMISSION_DENIED: User lacks required permission for the requested scope - INVALID_ARGUMENT: Scope not set or invalid UUID format - INTERNAL: Server error while retrieving logs

subscribe(request: soulfire.logs_pb2.LogRequest, ctx: connectrpc.request.RequestContext[soulfire.logs_pb2.LogRequest, soulfire.logs_pb2.LogResponse], /) → collections.abc.AsyncIterator[soulfire.logs_pb2.LogResponse][source]

Subscribes to a real-time stream of log entries matching the specified scope. The stream remains open until cancelled by the client or the connection is lost. Permissions are re-validated periodically (every 1 second) to handle permission changes.

For PersonalLogScope: Receives personal messages directed to the authenticated user. Personal messages are transient and only delivered to active subscribers.

Permissions required: - GlobalLogScope: GLOBAL_SUBSCRIBE_LOGS - InstanceLogScope/BotLogScope/InstanceScriptLogScope: INSTANCE_SUBSCRIBE_LOGS for the instance - PersonalLogScope: No special permissions required

Errors: - PERMISSION_DENIED: User lacks required permission for the requested scope - INVALID_ARGUMENT: Scope not set or invalid UUID format - INTERNAL: Server error while setting up subscription