MagickMind
PythonResources

Runtime (v1)

Reference for magick_mind.resources.v1.runtime.

magick_mind.resources.v1.runtime

V1 runtime resource implementation.

RuntimeResourceV1

class RuntimeResourceV1(BaseResource)

Runtime resource client for V1 API.

Provides access to effective personality computation and cache management.

Example:

Get effective personality (global)

personality = await client.v1.runtime.get_effective_personality("persona-123")

Get effective personality (dyadic — for a specific user)

personality = await client.v1.runtime.get_effective_personality( "persona-123", user_id="user-456" )

Invalidate cached personality

await client.v1.runtime.invalidate_cache("persona-123")

RuntimeResourceV1.get_effective_personality

async def get_effective_personality(
        persona_id: str,
        user_id: Optional[str] = None) -> EffectivePersonality

Get the effective (blended) personality of a persona.

Merges authored traits with globally and dyadically learned values.

Arguments:

  • persona_id - Persona ID
  • user_id - Optional user ID for dyadic mode

Returns:

EffectivePersonality with blended trait values and source breakdown

RuntimeResourceV1.invalidate_cache

async def invalidate_cache(persona_id: str,
                           user_id: Optional[str] = None) -> None

Invalidate the cached effective personality for a persona.

Arguments:

  • persona_id - Persona ID
  • user_id - Optional user ID to invalidate a specific dyad cache

On this page