Reason (v2)

magick_mind.models.v2.reason

Typed request and response models for the Cortex v2 Reason API.

WireSerializable

class WireSerializable(Protocol)

Object that can serialize itself to the Reason API wire format.

ModelConfig

@dataclass(frozen=True)
class ModelConfig()

Model configuration sent to Cortex.

LLM

@dataclass(frozen=True)
class LLM()

Single LLM node.

RLM

@dataclass(frozen=True)
class RLM()

Recursive language model node.

max_depth is sent to Cortex as the max_iterations wire field; the SDK keeps the max_depth name without changing the Bifrost or proto contracts.

Singular

@dataclass(frozen=True)
class Singular()

Singular Reason algorithm.

MCTS

@dataclass(frozen=True)
class MCTS()

MCTS Reason algorithm.

UsageStats

class UsageStats(BaseModel)

Token, model, and cost metadata returned by Cortex.

ImageResult

class ImageResult(BaseModel)

Image output returned by Cortex.

ReasonResponse

class ReasonResponse(BaseModel)

Non-streaming Reason API response.

ReasonResponse.content

@property
def content() -> str | None

Text answer convenience alias.

ChatMessage

class ChatMessage(BaseModel)

Chat message accepted by the Reason API.