Documentation Index
Fetch the complete documentation index at: https://docs.sundew.sh/llms.txt
Use this file to discover all available pages before exploring further.
Complete schema
# ─── Trap surfaces ────────────────────────────────
traps:
mcp_server: true # MCP server trap
rest_api: true # REST API trap with OpenAPI
ai_discovery: true # .well-known, robots.txt, sitemap
# ─── Persona ──────────────────────────────────────
persona: auto # "auto" | path to persona.yaml
# ─── LLM (for persona generation) ────────────────
llm:
provider: ollama # ollama | anthropic | openai | bedrock | none
model: llama3 # Model name
base_url: null # Custom API base URL
api_key: null # API key (prefer env vars)
region: null # AWS region for Bedrock
temperature: 0.7 # Generation temperature
max_tokens: 2048 # Max tokens per generation
# ─── Server ───────────────────────────────────────
server:
host: 0.0.0.0 # Listen address
port: 8080 # Listen port
# ─── Storage ──────────────────────────────────────
storage:
database: ./data/sundew.db # SQLite path
log_file: ./data/events.jsonl # JSONL event log path
# ─── Logging ──────────────────────────────────────
logging:
level: info # debug | info | warning | error
output: stdout # stdout | file path
Field details
traps
| Field | Type | Default | Description |
|---|
mcp_server | bool | true | Enable the MCP server trap |
rest_api | bool | true | Enable the REST API trap |
ai_discovery | bool | true | Enable AI discovery endpoints |
persona
| Value | Behavior |
|---|
auto | Generate a random persona using configured LLM or fallback packs |
| File path | Load a custom persona from the specified YAML file |
llm
| Field | Type | Default | Description |
|---|
provider | string | ollama | LLM provider: ollama, anthropic, openai, bedrock, none |
model | string | llama3 | Model name |
base_url | string | null | Custom API endpoint |
api_key | string | null | API key (prefer environment variables) |
region | string | null | AWS region for Bedrock provider |
temperature | float | 0.7 | Generation randomness |
max_tokens | int | 2048 | Maximum output tokens |
server
| Field | Type | Default | Description |
|---|
host | string | 0.0.0.0 | Listen address |
port | int | 8080 | Listen port |
storage
| Field | Type | Default | Description |
|---|
database | string | ./data/sundew.db | SQLite database file path |
log_file | string | ./data/events.jsonl | JSONL event log file path |
logging
| Field | Type | Default | Description |
|---|
level | string | info | Log level: debug, info, warning, error |
output | string | stdout | Log output: stdout or a file path |
Environment variables
| Variable | Overrides |
|---|
ANTHROPIC_API_KEY | llm.api_key when provider is anthropic |
OPENAI_API_KEY | llm.api_key when provider is openai |
AWS_DEFAULT_REGION | llm.region when provider is bedrock |
SUNDEW_LOG_LEVEL | logging.level |
