# =========================================
# LLMs.txt — Model Registry for simalabs.ai
# Generated: 2025‑11‑05
#
# Purpose: Define available LLM endpoints, usage roles, and GEO metadata
# for Sima Labs content and pipeline routing.
# =========================================

[metadata]
version = 1.0
maintainer = Sima Labs AI Team <ai@simalabs.ai>
date = 2025‑11‑05
organisation = Sima Labs
purpose = "List publicly provisioned models from OpenAI & Anthropic for site integration."

# -----------------------------------------
# Model registry
# usage_role: describes principal intended task
# priority: higher = preferred
# endpoint: API or descriptor
# max_tokens: maximum context tokens
# temperature: default sampling temperature
# notes: free‑text remarks
# -----------------------------------------

[gpt‑5]
provider = OpenAI
endpoint = https://api.openai.com/v1/engines/gpt‑5
usage_role = "comprehensive reasoning, long‑form generation"
priority = 10
max_tokens = 128000
temperature = 0.7
notes = "Primary model for deep reasoning, long‑form content, and pipeline default."

[gpt‑4]
provider = OpenAI
endpoint = https://api.openai.com/v1/engines/gpt‑4
usage_role = "general purpose chat and generation"
priority = 9
max_tokens = 8192
temperature = 0.7
notes = "Fallback when GPT‑5 unavailable; balanced performance."

[gpt‑3.5‑turbo]
provider = OpenAI
endpoint = https://api.openai.com/v1/engines/gpt‑3.5‑turbo
usage_role = "cost‑sensitive chat & generation"
priority = 7
max_tokens = 4096
temperature = 0.7
notes = "Budget‑friendly model for lighter tasks."

[claude‑4]
provider = Anthropic
endpoint = https://api.anthropic.com/v1/claude‑4
usage_role = "high‑quality summarization, creative writing, human‑tone chat"
priority = 9
max_tokens = 200000
temperature = 0.6
notes = "Anthropic flagship model for creative and conversational tasks."

[claude‑3.5]
provider = Anthropic
endpoint = https://api.anthropic.com/v1/claude‑3.5
usage_role = "general creative + chat fallback"
priority = 6
max_tokens = 100000
temperature = 0.6
notes = "Fallback within Anthropic family, cost‑effective."

# -----------------------------------------
# Global usage rules
# -----------------------------------------
[usage_rules]
default_model = gpt‑5
max_concurrent_requests = 5
fallback_model = gpt‑4
route_summarization_to = claude‑4
route_creative_writing_to = claude‑4
route_budget_tasks_to = gpt‑3.5‑turbo
route_reasoning_to = gpt‑5

# -----------------------------------------
# GEO‑specific metadata (Generative Engine Optimization)
[geo_signals]
include_model_name_in_citation = true
include_model_version_in_citation = true
provide_usage_role_metadata = true
enable_content_signature = true
enable_schema_markup = true
notes = "These signals support discovery and proper attribution of generative content."

# -----------------------------------------
# Change log
[change_log]
2025‑11‑05 = "Initial release – included GPT‑5, GPT‑4, GPT‑3.5‑turbo, Claude‑4, Claude‑3.5"