SumoSettings Reference¶

@classmethod
def for_chat(cls, **kwargs) -> "SumoSettings":
    """
    Conversational chat with memory but no planning or tool execution.
    Use this for multi-turn conversations where the model needs to
    remember what was said earlier in the session.
    No committee, no RAG, no tool calls. Fast response times.
    """
    defaults = {
        "committee_enabled": False,
        "rag_enabled": False,
        "memory_enabled": True,
        "execution_enabled": False,
    }
    defaults.update(kwargs)
    return cls(**defaults)

@classmethod
def for_chat_stateless(cls, **kwargs) -> "SumoSettings":
    """
    Pure stateless single-turn inference. Fastest possible response.
    Every message is independent — no memory of previous turns.
    Use for one-shot Q&A, summarisation, or classification tasks
    where conversation history is irrelevant.
    """
    defaults = {
        "committee_enabled": False,
        "rag_enabled": False,
        "memory_enabled": False,
        "execution_enabled": False,
    }
    defaults.update(kwargs)
    return cls(**defaults)

@classmethod
def for_chat_with_context(cls, **kwargs) -> "SumoSettings":
    """
    Conversational chat grounded in your codebase or documents.
    Use this when users ask questions about ingested content —
    'explain this function', 'where is X defined', 'summarise this doc'.
    No committee, no tool execution. RAG + memory enabled.
    """
    defaults = {
        "committee_enabled": False,
        "rag_enabled": True,
        "memory_enabled": True,
        "execution_enabled": False,
    }
    defaults.update(kwargs)
    return cls(**defaults)

@classmethod
def for_coding(cls, **kwargs) -> "SumoSettings":
    """Full pipeline optimised for code tasks."""
    defaults = {
        "committee_enabled": True,
        "committee_mode": "full",
        "rag_enabled": True,
        "rag_top_k_final": 8,
        "shell_sandbox": True,
    }
    defaults.update(kwargs)
    return cls(**defaults)

@classmethod
def for_research(cls, **kwargs) -> "SumoSettings":
    """Planning + web search, no code execution."""
    defaults = {
        "committee_enabled": True,
        "committee_mode": "plan_only",
        "rag_enabled": True,
        "execution_enabled": True,
        "shell_sandbox": True,
    }
    defaults.update(kwargs)
    return cls(**defaults)

@classmethod
def for_review(cls, **kwargs) -> "SumoSettings":
    """Plan and critique only — never executes. Safe for untrusted tasks."""
    defaults = {
        "committee_enabled": True,
        "committee_mode": "full",
        "execution_enabled": False,
    }
    defaults.update(kwargs)
    return cls(**defaults)

@classmethod
def from_file(cls, path: str) -> "SumoSettings":
    """Load settings explicitly from a specific file."""
    return cls(_env_file=path)

def to_kernel_config(self) -> "KernelConfig":
    """
    Compatibility shim for code still using KernelConfig directly.
    Deprecated: Pass SumoSettings to SumoKernel directly instead.
    Will be removed in v1.0.
    """
    from sumospace.kernel import KernelConfig
    return KernelConfig(
        provider=self.provider,
        model=self.model,
        embedding_provider=self.embedding_provider,
        embedding_model=self.embedding_model,
        require_consensus=self.require_consensus,
        max_retries=self.max_retries,
        execution_timeout=self.execution_timeout,
        verbose=self.verbose,
        dry_run=self.dry_run,
        hf_load_in_4bit=self.hf_load_in_4bit,
        secondary_provider=self.secondary_provider,
        secondary_model=self.secondary_model,
        workspace=self.workspace,
        scope_level=self.scope_level,
        user_id=self.user_id,
        session_id=self.session_id,
        project_id=self.project_id,
        chroma_base=self.chroma_base,
        chroma_path=self.chroma_base,
        max_chunks_per_scope=self.max_chunks_per_scope,
    )