Mindspace (v1)

magick_mind.models.v1.mindspace

V1 mindspace API models.

These models mirror the API types for /v1/magickspaces endpoint.

MindSpace

class MindSpace(BaseModel)

Mindspace schema model.

Represents a mindspace container that can be private (single user) or group (multiple users), with attached corpus for knowledge.

Example:

{

• "id" - "mind-123",
• "name" - "Engineering Team",
• "description" - "Team workspace",
• "project_id" - "proj-456",
• "corpus_ids" - ["corp-1", "corp-2"],
• "participant_ids" - ["user-1", "user-2"],
• "type" - "GROUP",
• "created_by" - "user-1",
• "updated_by" - "user-1",
• "created_at" - "2025-12-16T09:00:00Z",
• "updated_at" - "2025-12-16T09:00:00Z" }

CreateMindSpaceRequest

class CreateMindSpaceRequest(BaseModel)

Request to create a new mindspace.

GetMindSpaceListResponse

class GetMindSpaceListResponse(BaseModel)

Response from listing mindspaces.

Uses standardized pagination format: {data: [], paging: {}}.

GetMindSpaceListResponse.mindspaces

@property
def mindspaces() -> list[MindSpace]

Alias for data field (backward compatibility).

UpdateMindSpaceRequest

class UpdateMindSpaceRequest(BaseModel)

Request to update an existing mindspace.

AddMindSpaceUsersRequest

class AddMindSpaceUsersRequest(BaseModel)

Request to add participants to an existing mindspace.

ChatHistoryParams

class ChatHistoryParams(BaseModel)

Parameters for chat history retrieval.

CorpusParams

class CorpusParams(BaseModel)

Parameters for corpus search.

FetcherParams

class FetcherParams(BaseModel)

Parameters for Pelican episodic memory search.

CorpusChunk

class CorpusChunk(BaseModel)

A chunk of corpus content.

ChatHistoryItem

class ChatHistoryItem(BaseModel)

A single chat history message.

SendMessageRequest

class SendMessageRequest(BaseModel)

Request for sending a message to a mindspace.

ContextPrepareResponse

class ContextPrepareResponse(BaseModel)

Response from composable context retrieval.

LivekitTokenResponse

class LivekitTokenResponse(BaseModel)

Response containing a LiveKit access token.

LivekitJoinResponse

class LivekitJoinResponse(BaseModel)

Response from signalling agents to join LiveKit room.