umbra/umbra.example.yml at main · collapseindex/umbra · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
# Umbra configuration
# Copy to umbra.yml and customize

# -- Server --
port: 8400
host: "127.0.0.1"  # Change to "0.0.0.0" to accept connections from other machines

# -- CI-1T API --
# Get your key at https://collapseindex.org/dashboard
# Can also use CI1T_API_KEY env var instead of putting it here
api_key: ""
api_url: "https://collapseindex.org/api"

# -- Policy --
# "enforce" = gate/block at AL3+
# "monitor" = log everything, block nothing
policy: "monitor"

# -- Fleet session --
episode_size: 3  # scores per episode (2-8, default 3)

# -- Risk map (optional overrides) --
# Defaults are sensible for most agent frameworks.
# Only include action types you want to override.
# risk_map:
#   file_read: 0.05
#   file_write: 0.25
#   terminal_exec: 0.50
#   credential_access: 0.90
#   unknown: 0.50

# -- Alerts --
# All alert channels are opt-in. Nothing fires unless configured.
alerts:
  # When to alert (minimum AL that triggers an alert)
  # Options: AL2, AL3, AL4, ghost
  min_level: "AL3"

  # -- Slack --
  # slack:
  #   webhook_url: "https://hooks.slack.com/services/T.../B.../xxx"
  #   channel: "#ci1t-alerts"       # optional override

  # -- Email (SMTP) --
  # email:
  #   smtp_host: "smtp.gmail.com"
  #   smtp_port: 587
  #   smtp_user: "you@gmail.com"
  #   smtp_pass: ""                 # or use CI1T_SMTP_PASS env var
  #   from_addr: "umbra@yourdomain.com"
  #   to_addrs:
  #     - "ops@yourdomain.com"

  # -- SMS (Twilio) --
  # sms:
  #   account_sid: ""               # or CI1T_TWILIO_SID env var
  #   auth_token: ""                # or CI1T_TWILIO_TOKEN env var
  #   from_number: "+15551234567"
  #   to_numbers:
  #     - "+15559876543"

# -- Credits --
credits:
  # Warn when credits drop below this threshold
  low_warning: 100
  # Check balance every N rounds (0 = disabled)
  check_interval: 10

# -- Multi-Agent Coordination (experimental) --
# Track causal relationships across agents and enforce cross-agent governance.
# multi_agent:
#   enabled: true
#   cascade: true              # Propagate instability to upstream agents
#   influence_gating: true     # Block cross-agent actions above triggering agent's AL
#   cascade_decay: 0.5         # Attenuation per hop (50%)
#   cascade_max_hops: 4        # Max causal chain depth
#   causal_edge_ttl: 600       # Seconds before causal edges expire

# -- CI-C1: Curiosity Engine (experimental) --
# Background pattern discovery across agent behavioral trajectories.
# Uses 8-dimensional fingerprints + structural similarity (shape + magnitude).
# curiosity:
#   enabled: true
#   cycle_interval: 60         # Seconds between curiosity cycles
#   window_size: 10            # Episodes per behavioral fingerprint
#   history_depth: 20          # Past windows to keep per agent
#   similarity_threshold: 0.75 # Minimum similarity to surface a discovery
#   cooldown_cycles: 5         # Cycles before re-reporting same match

# -- OpenRouter (optional, for demo scripts) --
# Used by scripts/demo_openrouter.py to test live LLMs through Umbra.
# Can also use OPENROUTER_API_KEY env var instead.
# openrouter_key: "sk-or-..."