Model Types

from mutual_dissent.models import DebateTranscript

transcript.transcript_id    # str — UUID4
transcript.short_id         # str — first 8 characters of transcript_id
transcript.query            # str — original user query
transcript.panel            # list[str] — model aliases
transcript.synthesizer_id   # str — alias of synthesis model
transcript.max_rounds       # int — configured reflection round count
transcript.rounds           # list[DebateRound]
transcript.synthesis        # ModelResponse | None
transcript.created_at       # datetime (UTC)
transcript.metadata         # dict[str, Any]

round.round_number   # int — 0=initial, 1+=reflection
round.round_type     # str — "initial", "reflection", "synthesis"
round.responses      # list[ModelResponse]

response.model_id       # str — full OpenRouter or vendor model ID
response.model_alias    # str — short alias (e.g. "claude")
response.agent_id       # str — unique agent identity (e.g. "claude-2"), empty if not set
response.display_label  # property — returns agent_id if set, else model_alias
response.round_number   # int
response.role           # str — "initial", "reflection", or "synthesis"
response.content        # str — response text
response.timestamp      # datetime (UTC)
response.token_count    # int | None
response.input_tokens   # int | None
response.output_tokens  # int | None
response.latency_ms     # int | None
response.error          # str | None — set on failure, None on success
response.routing        # dict | None — RoutingDecision serialized
response.analysis       # dict — scoring metadata

from mutual_dissent.models import ExperimentMetadata

meta = ExperimentMetadata(
    experiment_id="study-2-run-001",
    source_tool="countersignal",       # "countersignal", "counteragent", or "manual"
    campaign_id="cs-campaign-abc",     # optional
    condition="unicode tag injection",
    variables={"technique": "unicode_tag", "target_model": "claude"},
    finding_ref="MD-003",              # optional
)

from mutual_dissent.types import RoutingDecision, Vendor

decision.vendor           # Vendor enum — e.g. Vendor.ANTHROPIC
decision.mode             # str — "auto", "direct", or "openrouter"
decision.via_openrouter   # bool

from mutual_dissent.types import Vendor

Vendor.ANTHROPIC    # "anthropic"
Vendor.OPENAI       # "openai"
Vendor.GOOGLE       # "google"
Vendor.XAI          # "xai"
Vendor.NVIDIA       # "nvidia"
Vendor.GROQ         # "groq"
Vendor.OPENROUTER   # "openrouter"
Vendor.OLLAMA       # "ollama"