Models API Reference

Bases: BaseModel

LLM provider configuration.

At minimum, provide a model name. The API key and base URL are read from environment variables by default (ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL).

Parameters:

Name	Type	Description	Default
model		Model identifier (e.g., "claude-sonnet-4-20250514").	required
base_url		API base URL. None uses the SDK default.	required
api_key		API key. Usually read from ANTHROPIC_API_KEY env var.	required
provider		Provider tag for trajectory recording (e.g., "anthropic", "glm").	required
fallback_model		Fallback model identifier for degraded operation.	required

Example

from scrivai import ModelConfig model = ModelConfig(model="claude-sonnet-4-20250514") model = ModelConfig( ... model="glm-5.1", ... base_url="https://gateway.example.com", ... api_key="sk-xxx", ... provider="glm", ... )

Bases: BaseModel

Full PES configuration (loaded from YAML).

Bases: BaseModel

Configuration for a single phase (plan, execute, or summarize).

Bases: BaseModel

Complete state of a single PES execution.

to_prompt_payload()

Return a compact dict suitable for injection into prompt context.

Bases: BaseModel

Complete result for a single phase.

Bases: BaseModel

A single Agent turn (fine-grained trajectory entry).