agentlighthouse-core 0.4.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- agentlighthouse_core-0.4.0.dist-info/METADATA +358 -0
- agentlighthouse_core-0.4.0.dist-info/RECORD +78 -0
- agentlighthouse_core-0.4.0.dist-info/WHEEL +4 -0
- agentlighthouse_core-0.4.0.dist-info/entry_points.txt +2 -0
- agentlighthouse_core-0.4.0.dist-info/licenses/LICENSE +21 -0
- al_core/__init__.py +12 -0
- al_core/_bundled/configs/audit.yaml +12 -0
- al_core/_bundled/configs/balanced.yaml +36 -0
- al_core/_bundled/configs/strict.yaml +32 -0
- al_core/_bundled/dashboard/assets/index-CN2LU6nV.css +1 -0
- al_core/_bundled/dashboard/assets/index-DX6cZzRi.js +40 -0
- al_core/_bundled/dashboard/index.html +15 -0
- al_core/_bundled/policies/default-deny.yaml +37 -0
- al_core/a2a/__init__.py +25 -0
- al_core/a2a/envelope.py +60 -0
- al_core/a2a/mediator.py +221 -0
- al_core/app.py +427 -0
- al_core/audit/__init__.py +149 -0
- al_core/audit/db.py +481 -0
- al_core/audit/pg.py +350 -0
- al_core/audit/pool.py +260 -0
- al_core/audit/siem.py +97 -0
- al_core/capability/__init__.py +28 -0
- al_core/capability/budget.py +56 -0
- al_core/capability/gate.py +334 -0
- al_core/capability/hitl.py +331 -0
- al_core/capability/policy.py +270 -0
- al_core/capability/store.py +209 -0
- al_core/capability/taint.py +79 -0
- al_core/cli/__init__.py +1 -0
- al_core/cli/main.py +1275 -0
- al_core/config/__init__.py +436 -0
- al_core/config/watch.py +51 -0
- al_core/detect/__init__.py +23 -0
- al_core/detect/base.py +131 -0
- al_core/detect/bip39_words.py +267 -0
- al_core/detect/budget.py +92 -0
- al_core/detect/detect_secrets_adapter.py +110 -0
- al_core/detect/engine.py +270 -0
- al_core/detect/scanners.py +454 -0
- al_core/egress/__init__.py +27 -0
- al_core/egress/nftables.py +59 -0
- al_core/egress/selftest.py +94 -0
- al_core/embed.py +51 -0
- al_core/gateway/__init__.py +29 -0
- al_core/gateway/content.py +154 -0
- al_core/gateway/decision.py +124 -0
- al_core/gateway/dnspin.py +131 -0
- al_core/gateway/forward.py +261 -0
- al_core/gateway/policy.py +66 -0
- al_core/gateway/ssrf.py +178 -0
- al_core/gateway/vkeys.py +205 -0
- al_core/gateway/web.py +801 -0
- al_core/identity/__init__.py +209 -0
- al_core/jsonstore.py +73 -0
- al_core/keys/__init__.py +141 -0
- al_core/killswitch.py +130 -0
- al_core/learn/__init__.py +17 -0
- al_core/learn/bundle.py +76 -0
- al_core/learn/miner.py +156 -0
- al_core/learn/scanner.py +77 -0
- al_core/learn/testgen.py +107 -0
- al_core/mcp/__init__.py +25 -0
- al_core/mcp/chain.py +147 -0
- al_core/mcp/descriptors.py +111 -0
- al_core/mcp/mediator.py +150 -0
- al_core/mcp/proxy.py +161 -0
- al_core/mcp/session.py +537 -0
- al_core/memory/__init__.py +15 -0
- al_core/memory/guard.py +330 -0
- al_core/memory/store.py +80 -0
- al_core/normalize/__init__.py +254 -0
- al_core/principal.py +59 -0
- al_core/receipt/__init__.py +192 -0
- al_core/resources.py +33 -0
- al_core/runtime.py +471 -0
- al_core/skills/__init__.py +30 -0
- al_core/skills/guard.py +218 -0
|
@@ -0,0 +1,358 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: agentlighthouse-core
|
|
3
|
+
Version: 0.4.0
|
|
4
|
+
Summary: AgentLighthouse core: proxies, scanners, policy engine, receipts, CLI
|
|
5
|
+
Project-URL: Homepage, https://github.com/neural-nomad1709/agentlighthouse
|
|
6
|
+
Project-URL: Repository, https://github.com/neural-nomad1709/agentlighthouse
|
|
7
|
+
Author: Amit Kala
|
|
8
|
+
License-Expression: MIT
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Requires-Python: >=3.12
|
|
11
|
+
Requires-Dist: agentlighthouse-verify
|
|
12
|
+
Requires-Dist: cryptography>=43
|
|
13
|
+
Requires-Dist: fastapi>=0.111
|
|
14
|
+
Requires-Dist: httpx>=0.27
|
|
15
|
+
Requires-Dist: pydantic-settings>=2.3
|
|
16
|
+
Requires-Dist: pydantic>=2.7
|
|
17
|
+
Requires-Dist: pyyaml>=6
|
|
18
|
+
Requires-Dist: regex>=2024.11.6
|
|
19
|
+
Requires-Dist: typer>=0.12
|
|
20
|
+
Requires-Dist: uvicorn>=0.30
|
|
21
|
+
Requires-Dist: watchfiles>=0.22
|
|
22
|
+
Provides-Extra: postgres
|
|
23
|
+
Requires-Dist: psycopg[binary]>=3.2; extra == 'postgres'
|
|
24
|
+
Provides-Extra: scanners
|
|
25
|
+
Requires-Dist: detect-secrets>=1.5; extra == 'scanners'
|
|
26
|
+
Description-Content-Type: text/markdown
|
|
27
|
+
|
|
28
|
+
# agentlighthouse-core
|
|
29
|
+
|
|
30
|
+
**The runtime security and governance plane for AI agents.**
|
|
31
|
+
|
|
32
|
+
AgentLighthouse is a mediator that sits *outside* the agent. Every network
|
|
33
|
+
call, tool call, memory operation and inter-agent message goes through it. It
|
|
34
|
+
screens what comes in, authorizes what goes out, and writes a **signed,
|
|
35
|
+
hash-chained, independently verifiable receipt** for every decision it takes.
|
|
36
|
+
|
|
37
|
+
`agentlighthouse-core` is the mediator itself: the proxies, the scanners, the
|
|
38
|
+
policy engine, the evidence ledger and the `al` command line.
|
|
39
|
+
|
|
40
|
+
- **Source and full documentation:** <https://github.com/neural-nomad1709/agentlighthouse>
|
|
41
|
+
- **License:** MIT
|
|
42
|
+
- **Python:** 3.12 or newer
|
|
43
|
+
|
|
44
|
+
## Contents
|
|
45
|
+
|
|
46
|
+
- [Why a mediator](#why-a-mediator)
|
|
47
|
+
- [Install](#install)
|
|
48
|
+
- [Quick start](#quick-start)
|
|
49
|
+
- [What it does](#what-it-does)
|
|
50
|
+
- [Architecture](#architecture)
|
|
51
|
+
- [Putting an agent behind it](#putting-an-agent-behind-it)
|
|
52
|
+
- [Evidence](#evidence)
|
|
53
|
+
- [Configuration](#configuration)
|
|
54
|
+
- [Command reference](#command-reference)
|
|
55
|
+
- [Running in production](#running-in-production)
|
|
56
|
+
- [Related packages](#related-packages)
|
|
57
|
+
- [Scope and limitations](#scope-and-limitations)
|
|
58
|
+
- [Security reporting](#security-reporting)
|
|
59
|
+
- [License](#license)
|
|
60
|
+
|
|
61
|
+
## Why a mediator
|
|
62
|
+
|
|
63
|
+
An AI agent reads untrusted text (a web page, a tool response, another agent's
|
|
64
|
+
message) and then acts on it: it calls tools, writes memory and sends data
|
|
65
|
+
out. A guardrail placed inside the agent shares the agent's trust boundary, so
|
|
66
|
+
a successful prompt injection is already past it.
|
|
67
|
+
|
|
68
|
+
AgentLighthouse takes the control point out of the agent. The agent talks to
|
|
69
|
+
the mediator, and the mediator decides. Three properties follow:
|
|
70
|
+
|
|
71
|
+
- **A choke-point.** In the container topology the agent has no other road
|
|
72
|
+
out.
|
|
73
|
+
- **Identity-bound least privilege.** Every agent has an identity, and a tool
|
|
74
|
+
runs only when that identity is explicitly allowed to run it.
|
|
75
|
+
- **Evidence an auditor can check.** Each decision is an Ed25519-signed
|
|
76
|
+
receipt, chained to the one before it. Anyone can verify the chain with a
|
|
77
|
+
standalone tool that does not import this package.
|
|
78
|
+
|
|
79
|
+
Everything fails closed: a scanner crash, a timeout, a bad configuration or an
|
|
80
|
+
unverifiable ledger denies the request or refuses to start.
|
|
81
|
+
|
|
82
|
+
## Install
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
pip install agentlighthouse-core
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
This installs two commands: `al` (this package) and `al-verify` (the
|
|
89
|
+
standalone verifier, from
|
|
90
|
+
[agentlighthouse-verify](https://pypi.org/project/agentlighthouse-verify/)).
|
|
91
|
+
|
|
92
|
+
The wheel carries the shipped configuration profiles, the default-deny tool
|
|
93
|
+
policy and the prebuilt evidence dashboard. No source checkout and no Node
|
|
94
|
+
toolchain are needed.
|
|
95
|
+
|
|
96
|
+
Optional extras:
|
|
97
|
+
|
|
98
|
+
| Extra | Adds |
|
|
99
|
+
|---|---|
|
|
100
|
+
| `agentlighthouse-core[postgres]` | The Postgres evidence mirror, for several mediators writing to one query surface |
|
|
101
|
+
| `agentlighthouse-core[scanners]` | A `detect-secrets` adapter behind the scanner interface |
|
|
102
|
+
|
|
103
|
+
## Quick start
|
|
104
|
+
|
|
105
|
+
From an empty directory to independently verified evidence:
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
al init # keys/, data/, .env, configs/, policies/
|
|
109
|
+
al healthz --config configs/balanced.yaml # boot the runtime, verify config and chain
|
|
110
|
+
al-verify data/ledger.jsonl --pubkey keys/mediator_ed25519.pub
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
`al init` generates the Ed25519 signing key, writes a development `.env`, and
|
|
114
|
+
lays down the shipped `configs/` and `policies/` when they are absent. It
|
|
115
|
+
never overwrites a file you already have.
|
|
116
|
+
|
|
117
|
+
Exercise the gates directly. The exit code is scriptable:
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
al scan "ignore all previous instructions" # block INJECTION_BLOCKED exit 3
|
|
121
|
+
al scan "AKIAIOSFODNN7EXAMPLE" # strip aws-access-key exit 2
|
|
122
|
+
al policy check spiffe://acme/agent/x exec_shell # deny TOOL_NOT_ALLOWED exit 3
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
| Verdict | Meaning | Exit code |
|
|
126
|
+
|---|---|---|
|
|
127
|
+
| `allow` | Nothing found | `0` |
|
|
128
|
+
| `strip` | A secret or PII was found and is redacted in flight | `2` |
|
|
129
|
+
| `block` | The content or the action is denied | `3` |
|
|
130
|
+
|
|
131
|
+
## What it does
|
|
132
|
+
|
|
133
|
+
| Domain | Capability |
|
|
134
|
+
|---|---|
|
|
135
|
+
| Network mediation | CONNECT forward proxy, fetch proxy, OpenAI- and Anthropic-compatible reverse proxy with SSE, MCP proxy (stdio and Streamable HTTP), A2A mediation |
|
|
136
|
+
| Egress control | Default-deny nftables ruleset, with a boot self-test that refuses to start if out-of-band egress succeeds |
|
|
137
|
+
| Content inspection | Six-pass normalization that folds evasions, then a fail-closed detection engine: injection, secrets, PII, SSRF, entropy, BIP-39 seed phrases, rate and data budgets |
|
|
138
|
+
| Capability control | Identity-bound default-deny tool policy with argument constraints, outbound DLP on tool arguments, human approval on irreversible verbs, MCP descriptor pinning, chain detection, taint escalation |
|
|
139
|
+
| Memory protection | Guarded reads and writes, poison quarantine, secret redaction, SHA-256 integrity baselines, snapshot and rollback |
|
|
140
|
+
| Instruction-file protection | Screening and pinning of `SKILL.md`, `CLAUDE.md`, `AGENTS.md` and `.cursorrules` |
|
|
141
|
+
| Evidence | Append-only signed ledger, SQLite or Postgres mirror, ECS/MITRE SIEM export |
|
|
142
|
+
| Control | A kill switch with four independent sources that drills to full deny-all |
|
|
143
|
+
| Learning | A human-gated loop that ships only signed rule bundles and can only tighten the gate |
|
|
144
|
+
|
|
145
|
+
## Architecture
|
|
146
|
+
|
|
147
|
+
Seven layers, operated as four gates. The control plane is segregated from the
|
|
148
|
+
agent network.
|
|
149
|
+
|
|
150
|
+
| Gate | Layers | Owns |
|
|
151
|
+
|---|---|---|
|
|
152
|
+
| Edge Gate | L0 + L1 | Egress choke-point, proxy modes, DNS pinning, SSRF controls, MCP and A2A wrapping |
|
|
153
|
+
| Content Gate | L2 + L3 | Normalization, injection, DLP and secrets, PII, entropy, rate and budget |
|
|
154
|
+
| Action Gate | L4 + L5 | Identity-bound tool policy, argument constraints, chain detection, human approval, taint, memory guard |
|
|
155
|
+
| Evidence and Control Gate | L6 + operations | Signed receipts, ledger and mirror, kill switch, RBAC, configuration validation, dashboard |
|
|
156
|
+
|
|
157
|
+
A request passes the layers in order:
|
|
158
|
+
|
|
159
|
+
```
|
|
160
|
+
agent -> L0 egress -> L1 mediation -> L2 normalize -> L3 detect
|
|
161
|
+
-> L4 policy -> L5 memory guard -> world
|
|
162
|
+
-> L6 signed receipt (every path, allow or deny)
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
The full design is in the
|
|
166
|
+
[architecture document](https://github.com/neural-nomad1709/agentlighthouse/blob/main/docs/architecture.md).
|
|
167
|
+
|
|
168
|
+
## Putting an agent behind it
|
|
169
|
+
|
|
170
|
+
Most paths need no change to the agent's code.
|
|
171
|
+
|
|
172
|
+
| Traffic | How to route it |
|
|
173
|
+
|---|---|
|
|
174
|
+
| LLM API calls | Point the client's base URL at the gateway (`http://127.0.0.1:8443/v1`) and use a virtual key as the API key |
|
|
175
|
+
| Web and tool egress | Set `HTTPS_PROXY=http://127.0.0.1:8080` with the agent's identity as proxy credentials, or call `GET /fetch?url=` |
|
|
176
|
+
| An MCP server | Wrap its command: `al mcp proxy --actor <spiffe-id> -- <server command>` |
|
|
177
|
+
|
|
178
|
+
Issue an agent identity and a virtual LLM key, then start the gateway:
|
|
179
|
+
|
|
180
|
+
```bash
|
|
181
|
+
al identity issue acme research-agent # spiffe://acme/agent/research-agent + a token, shown once
|
|
182
|
+
al vkey issue alice --max-requests 200 --max-tokens 200000
|
|
183
|
+
al gateway --host 127.0.0.1 --config configs/balanced.yaml
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
The gateway serves the fetch and reverse proxies on port 8443 and the CONNECT
|
|
187
|
+
forward proxy on port 8080. Agents reach only the hosts you list under
|
|
188
|
+
`gateway.allow_hosts`; an empty list denies everything.
|
|
189
|
+
|
|
190
|
+
Mediating an MCP server:
|
|
191
|
+
|
|
192
|
+
```bash
|
|
193
|
+
al mcp proxy --actor spiffe://acme/agent/research-agent -- npx some-mcp-server
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
The tool catalog is pinned and scanned for poisoning. Each tool call is
|
|
197
|
+
authorized against the identity's policy, and only for a tool the agent was
|
|
198
|
+
actually shown. Every server reply is scanned before the agent sees it. Every
|
|
199
|
+
decision is receipted.
|
|
200
|
+
|
|
201
|
+
Other surfaces:
|
|
202
|
+
|
|
203
|
+
```bash
|
|
204
|
+
al skill check ./my-skills/ # screen and pin agent instruction files
|
|
205
|
+
al memory put notes/todo "..." # screened write; a poisoned value is blocked and quarantined
|
|
206
|
+
al memory verify # check protected keys against their integrity baselines
|
|
207
|
+
al memory rollback # restore the last known-good snapshot
|
|
208
|
+
al killswitch engage # deny everything, at every ingress
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
## Evidence
|
|
212
|
+
|
|
213
|
+
Every mediated decision produces a receipt: canonicalized with RFC 8785 (JCS),
|
|
214
|
+
SHA-256 chained to its predecessor, and signed with the mediator's Ed25519
|
|
215
|
+
key.
|
|
216
|
+
|
|
217
|
+
```json
|
|
218
|
+
{
|
|
219
|
+
"v": 1,
|
|
220
|
+
"seq": 42,
|
|
221
|
+
"ts": "2026-07-10T12:00:00.000Z",
|
|
222
|
+
"actor": "spiffe://acme/agent/claude-code",
|
|
223
|
+
"action": "mcp_tool_call",
|
|
224
|
+
"target": "tool:send_email",
|
|
225
|
+
"verdict": "block",
|
|
226
|
+
"findings": [
|
|
227
|
+
{ "scanner": "tool_policy", "rule_id": "policy.default_deny", "severity": "high", "owasp": "ASI03", "mitre": "T1078" }
|
|
228
|
+
],
|
|
229
|
+
"block_reason": "TOOL_NOT_ALLOWED",
|
|
230
|
+
"policy_hash": "sha256:...",
|
|
231
|
+
"redaction": { "aws-access-key": 1 },
|
|
232
|
+
"prev_hash": "sha256:...",
|
|
233
|
+
"record_hash": "sha256:...",
|
|
234
|
+
"sig": "ed25519:..."
|
|
235
|
+
}
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
- Redaction is recorded as a class-to-count map. Plaintext never reaches the
|
|
239
|
+
ledger.
|
|
240
|
+
- The append-only JSONL ledger is the source of truth. The SQLite or Postgres
|
|
241
|
+
mirror is a query surface built from it.
|
|
242
|
+
- `al export --verdict block` writes ECS-shaped events with MITRE ATT&CK
|
|
243
|
+
technique tags for a SIEM. Each event carries the receipt's `record_hash`
|
|
244
|
+
and `sig`, so an alert traces back to a receipt that can be verified.
|
|
245
|
+
|
|
246
|
+
The receipt format is a published specification:
|
|
247
|
+
[receipt-v1](https://github.com/neural-nomad1709/agentlighthouse/blob/main/spec/receipt-v1.md).
|
|
248
|
+
|
|
249
|
+
## Configuration
|
|
250
|
+
|
|
251
|
+
Configuration is a YAML file chosen with `--config`. Three profiles ship in
|
|
252
|
+
the wheel and are written to `configs/` by `al init`.
|
|
253
|
+
|
|
254
|
+
| | `audit` | `balanced` (default) | `strict` |
|
|
255
|
+
|---|---|---|---|
|
|
256
|
+
| Scan verdicts | Observed and receipted, not enforced | Enforced | Enforced |
|
|
257
|
+
| Permissive settings | Allowed (the only mode that allows them) | Refused at validation | Refused at validation |
|
|
258
|
+
| Egress | As configured | Default-deny | Default-deny, HTTPS only |
|
|
259
|
+
|
|
260
|
+
Enforced in every mode, including `audit`: a scanner crash or timeout blocks,
|
|
261
|
+
the memory guard's own checks, the key policy, signed rules only, the kill
|
|
262
|
+
switch, and full evidence chaining.
|
|
263
|
+
|
|
264
|
+
Validate a profile before using it:
|
|
265
|
+
|
|
266
|
+
```bash
|
|
267
|
+
al check --config configs/strict.yaml
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
Secrets never live in YAML. The admin token, the signing key and upstream
|
|
271
|
+
provider keys come from the environment or from mounted secrets. Environment
|
|
272
|
+
variables use the `AL_` prefix, with `__` between nested keys, for example
|
|
273
|
+
`AL_GATEWAY__UPSTREAM__ANTHROPIC_API_KEY`.
|
|
274
|
+
|
|
275
|
+
The annotated configuration reference is in the
|
|
276
|
+
[implementation guide](https://github.com/neural-nomad1709/agentlighthouse/blob/main/implementation.md).
|
|
277
|
+
|
|
278
|
+
## Command reference
|
|
279
|
+
|
|
280
|
+
| Command | Purpose |
|
|
281
|
+
|---|---|
|
|
282
|
+
| `al init` | Create a workspace: keys, data directory, `.env`, configs and policy |
|
|
283
|
+
| `al check` | Validate configuration; exits non-zero on any error |
|
|
284
|
+
| `al healthz` | Boot the runtime and print the health payload |
|
|
285
|
+
| `al scan` | Run the content gate over text and print the verdict |
|
|
286
|
+
| `al gateway` | Run the data-plane gateway |
|
|
287
|
+
| `al run` | Run the control-plane API |
|
|
288
|
+
| `al dashboard` | Serve the read-only evidence dashboard |
|
|
289
|
+
| `al identity` | Issue, list and revoke agent identities |
|
|
290
|
+
| `al vkey` | Issue, list and revoke virtual LLM keys with budgets |
|
|
291
|
+
| `al policy` | Inspect and check the identity-bound tool policy |
|
|
292
|
+
| `al mcp` | Mediate an MCP server; review its advertised tools |
|
|
293
|
+
| `al memory` | Guarded memory reads and writes, snapshot and rollback |
|
|
294
|
+
| `al skill` | Screen and pin agent instruction files |
|
|
295
|
+
| `al hitl` | List and resolve pending human approvals |
|
|
296
|
+
| `al killswitch` | Engage or disengage full deny-all |
|
|
297
|
+
| `al export` | Export the ledger as SIEM events |
|
|
298
|
+
| `al verify-receipt` | Verify a receipt or a ledger |
|
|
299
|
+
| `al egress` | The egress bypass self-test and the nftables ruleset |
|
|
300
|
+
| `al learn` | Mine candidate rules, approve and sign them, generate tests |
|
|
301
|
+
| `al db` | Initialize and query the evidence mirror |
|
|
302
|
+
| `al keygen` | Generate or rotate the signing key |
|
|
303
|
+
|
|
304
|
+
Run any command with `--help` for its options.
|
|
305
|
+
|
|
306
|
+
## Running in production
|
|
307
|
+
|
|
308
|
+
A process started with `al gateway` on a workstation mediates and receipts
|
|
309
|
+
what agents send through it, and nothing at the operating-system level stops
|
|
310
|
+
an agent from going around it. The mediator says so: startup logs `advisory
|
|
311
|
+
mode`, and the signed boot receipt carries the finding
|
|
312
|
+
`egress.advisory_mode`.
|
|
313
|
+
|
|
314
|
+
Enforcement comes from the container topology. The repository ships a hardened
|
|
315
|
+
container image and a Docker Compose file that places the agent on a network
|
|
316
|
+
whose only route out is the mediator, keeps the control plane on a separate
|
|
317
|
+
network, and runs two boot probes that must pass before any agent starts.
|
|
318
|
+
|
|
319
|
+
- **Image:** `ghcr.io/neural-nomad1709/agentlighthouse`, signed with cosign,
|
|
320
|
+
with an SBOM attestation
|
|
321
|
+
- **Deployment guides:**
|
|
322
|
+
[deployment](https://github.com/neural-nomad1709/agentlighthouse/tree/main/deployment)
|
|
323
|
+
- **Rollout from audit to strict:**
|
|
324
|
+
[rollout guide](https://github.com/neural-nomad1709/agentlighthouse/blob/main/docs/rollout.md)
|
|
325
|
+
|
|
326
|
+
## Related packages
|
|
327
|
+
|
|
328
|
+
| Package | What it is |
|
|
329
|
+
|---|---|
|
|
330
|
+
| [agentlighthouse-verify](https://pypi.org/project/agentlighthouse-verify/) | The standalone receipt verifier. Its only dependency is `cryptography`. Installed with this package. |
|
|
331
|
+
| [agentlighthouse-governance](https://pypi.org/project/agentlighthouse-governance/) | Organizations, role-based access, budgets and signed posture attestation, on top of this package. |
|
|
332
|
+
|
|
333
|
+
## Scope and limitations
|
|
334
|
+
|
|
335
|
+
Read this before relying on the mediator.
|
|
336
|
+
|
|
337
|
+
- The detection engine is pattern matching and heuristics behind a scanner
|
|
338
|
+
interface. It makes no machine-learning judgement.
|
|
339
|
+
- The forward proxy tunnels TLS opaquely. It enforces on destination host,
|
|
340
|
+
port and pinned IP address, and does not inspect content inside a CONNECT
|
|
341
|
+
tunnel.
|
|
342
|
+
- The identity of an A2A peer is asserted, not cryptographically proven. The
|
|
343
|
+
mediator pins agent cards and binds sessions to their peer pair.
|
|
344
|
+
- Outside the container topology the mediator is advisory, as described under
|
|
345
|
+
[Running in production](#running-in-production).
|
|
346
|
+
|
|
347
|
+
The complete statement is in the repository's
|
|
348
|
+
[README](https://github.com/neural-nomad1709/agentlighthouse#what-this-does-not-do).
|
|
349
|
+
|
|
350
|
+
## Security reporting
|
|
351
|
+
|
|
352
|
+
Please do not open a public issue for a suspected vulnerability. The reporting
|
|
353
|
+
process is in
|
|
354
|
+
[SECURITY.md](https://github.com/neural-nomad1709/agentlighthouse/blob/main/SECURITY.md).
|
|
355
|
+
|
|
356
|
+
## License
|
|
357
|
+
|
|
358
|
+
MIT. See the `LICENSE` file shipped with this package.
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
al_core/__init__.py,sha256=M8qsN76ydNnXLlFoCgqO1uB7rOWLaOK8mYIORSPqLIw,487
|
|
2
|
+
al_core/app.py,sha256=oVblcxVLcDlLuyk1GR2uSUnEs4Cr3C-EoC4tOo6YqdQ,18131
|
|
3
|
+
al_core/embed.py,sha256=g1WDNap1xpguUoPWA6j_QSh5APSliadTn14CgrhDeek,1748
|
|
4
|
+
al_core/jsonstore.py,sha256=mYcdT7vJnJ5AS41CQAemuy48A8vzbAETMP6dw8zLrxw,2668
|
|
5
|
+
al_core/killswitch.py,sha256=kNc1TeJYTKwSuacsbNwMNuLZi8Qo7L9D7_wlo7-uK8E,5646
|
|
6
|
+
al_core/principal.py,sha256=C1tovC6AQsQKwcmDQgh4SDeKUgDcrE6BL50MA3zhpAM,2054
|
|
7
|
+
al_core/resources.py,sha256=U2XZQNczIlW8k_k5XSNowCmMf7fIeiQXIZQy0SXzFp0,981
|
|
8
|
+
al_core/runtime.py,sha256=Iezh_G9f74Ox1YHRymlWmY6tTelmbchYZGh9RRa3cuk,20723
|
|
9
|
+
al_core/a2a/__init__.py,sha256=gi3VwtGLyEG_DNtxLt12HZUwBoDAHSFXUQIm_hNyb-U,979
|
|
10
|
+
al_core/a2a/envelope.py,sha256=by3szoCjz1CvQjS011m3Xj7CdOOt1T0YEJaGzIf0oMY,2064
|
|
11
|
+
al_core/a2a/mediator.py,sha256=vs5QF3sNc71ml5bDoYUANn_ssD-MJy4mCQntcCwczuQ,8823
|
|
12
|
+
al_core/audit/__init__.py,sha256=pUy7n6FjwhjoDSYAJcsvV1qQp4KpX_P_TmHISJLHBh0,5061
|
|
13
|
+
al_core/audit/db.py,sha256=EBX9KOgrgekhwMhEukuxteW4NOlUZUKNAvr5RmjTESc,20051
|
|
14
|
+
al_core/audit/pg.py,sha256=6BSrPf4FBY6-2qJWzFYYoFILEo7gMbT7mrA28p4csjg,14273
|
|
15
|
+
al_core/audit/pool.py,sha256=PYZ0P13pDWiLToBKp5KG5jh_S-kjHkhjQ--V8YAID08,11266
|
|
16
|
+
al_core/audit/siem.py,sha256=VvC1P7Oev809RWJcyMdn8cW7lVu9fBzsM0_X9sn_UrQ,3702
|
|
17
|
+
al_core/capability/__init__.py,sha256=smBlc6BdDv_K6BU5nlsjyA-GrloaYWHUItwqxmFqd7I,565
|
|
18
|
+
al_core/capability/budget.py,sha256=JR44JerEhqydW078gkyIC6w8mPMK2SNahBun3lI9If8,2108
|
|
19
|
+
al_core/capability/gate.py,sha256=r-eXUeWQmUIKSC5BJu2q2HHOZqMTMshR-9C-Sp67IZg,15851
|
|
20
|
+
al_core/capability/hitl.py,sha256=ZMSib7X6My9sfGbWmId4DmSdbTYYSAvVaS3hExilWUQ,14562
|
|
21
|
+
al_core/capability/policy.py,sha256=RqXg7fm_t-phIiyua4cXUmUawT_VcHHdCsPBiZYyfdw,10022
|
|
22
|
+
al_core/capability/store.py,sha256=InIwPKb3i0nF74ZIycP3aa_oLlEHFs0UaMibIzm3ji0,9575
|
|
23
|
+
al_core/capability/taint.py,sha256=6ED8nS3iDfIwlXEl2GBoZL4yG1vnkOuNpsKlQcVONHQ,3108
|
|
24
|
+
al_core/cli/__init__.py,sha256=t6tqfuj2xrnqnINxkmeqXVo9eCLwIHtOILXIJbHhKS0,35
|
|
25
|
+
al_core/cli/main.py,sha256=U8fwLto7ksq6pqCaS8roZBlwvAYqt3gRJv52k1DBkhk,52137
|
|
26
|
+
al_core/config/__init__.py,sha256=TNltShu4d7OhIRAiURbq4ZpNkxIKAco2LPkC_l18ozA,15968
|
|
27
|
+
al_core/config/watch.py,sha256=ZYouiZmcGRH-6rEQMB-8-bI2s6l4gT7mOOEQbX1sVSE,1718
|
|
28
|
+
al_core/detect/__init__.py,sha256=VaWa0N9bPHpm5tIFFvkWi7Jm9OU0uffmopiWDMpgjAk,407
|
|
29
|
+
al_core/detect/base.py,sha256=nKxm_L9DM4LA1x84ZOf9e5Dvgs6dWo4rzDKKDvUZYTI,4570
|
|
30
|
+
al_core/detect/bip39_words.py,sha256=LsAz1Qhaqe5Cemd_vexx-ElXDdD14Zsg-NBRAghMV0w,20903
|
|
31
|
+
al_core/detect/budget.py,sha256=BkfOC-GFiqy8EMT2p1n4pbB6sCTIUpxcEyZAfAGX6tU,3638
|
|
32
|
+
al_core/detect/detect_secrets_adapter.py,sha256=f1LDMEBTjXGnu2TFB9UY5Js8tkJEZitiRNL0QPA34nw,4595
|
|
33
|
+
al_core/detect/engine.py,sha256=57qDwbCGHRlonhAebGE0-rLJITcBuyD8X_jYlkicCSY,11363
|
|
34
|
+
al_core/detect/scanners.py,sha256=bYcDEyrqvsuS21aMIfaT_ZU6KFwvfx2cdI-irBonUnw,19269
|
|
35
|
+
al_core/egress/__init__.py,sha256=9-bJp5jQJ0nNxckdFO82B2XYNnuvkEEKQTz3yDn9OHw,869
|
|
36
|
+
al_core/egress/nftables.py,sha256=jGBebxmPtE75LlsMeZXNiFuc_CsUzmwGlvKKg8LLfIA,1964
|
|
37
|
+
al_core/egress/selftest.py,sha256=Us3zFQCpxTDcIUAHXRTG91VHnFZHmqraaNPl6hQByks,3264
|
|
38
|
+
al_core/gateway/__init__.py,sha256=3d2n5ItsDRn2l68V0mbPxIBKtpFCQrTnF7zj8tmpF_I,860
|
|
39
|
+
al_core/gateway/content.py,sha256=NUx420tK1p2kAf7P03QxKN-C2bsJAjWZomT1ZuAF-g0,5907
|
|
40
|
+
al_core/gateway/decision.py,sha256=EcJD9OeB0MkZ04uUcv8qMp9OFUsCzhb9z_cZTVcJw7I,7045
|
|
41
|
+
al_core/gateway/dnspin.py,sha256=Isdgg-lB5-wBHL9zqo4defI-ll9Ij4FKHcTxMDIdJYo,4902
|
|
42
|
+
al_core/gateway/forward.py,sha256=Qkigb4PC9fd0HGRV9GwgomFKepeJpj7NUjrDBQmy9xY,9633
|
|
43
|
+
al_core/gateway/policy.py,sha256=GXhm86o4pE6pI9uiHolhAHIaN2RV8DYQVeiHnxSzIs0,2353
|
|
44
|
+
al_core/gateway/ssrf.py,sha256=ConJtPVvlsaVSApO4N-O9m2IUnJrOIQa-Z8h_meKDGo,6599
|
|
45
|
+
al_core/gateway/vkeys.py,sha256=b5Yoa4vzuQ1lrAVse-KkODVL2QpXe5Vij7TvF58hFXc,7107
|
|
46
|
+
al_core/gateway/web.py,sha256=jRKW9m7D4E_h0_hZ6ne6avemQEhCrMkgU8vPErkSjJI,36137
|
|
47
|
+
al_core/identity/__init__.py,sha256=NjP9gphW5uESV8eC3vXo-x5amdWBuGG5fpRsymVf2As,6744
|
|
48
|
+
al_core/keys/__init__.py,sha256=RpPjqKycDih_yjDeywWWUdLbcbkqXcf9L0M64VupqjA,4639
|
|
49
|
+
al_core/learn/__init__.py,sha256=_Nnp6ZOMUAEd3PAfXWSxaek3-GtzL9lqEjkaNqE5v88,488
|
|
50
|
+
al_core/learn/bundle.py,sha256=l19Z2rDvm-3vYUJYEu7FckEO4r_oGfzFJpPL5-5rqKQ,2695
|
|
51
|
+
al_core/learn/miner.py,sha256=nK7Nv9BKBkLWdn3HD_QEjdOVBAMFvYbMI3qcC1CJxB0,5716
|
|
52
|
+
al_core/learn/scanner.py,sha256=3Jf2EyjnpJEV0GTxE2uEexH1rqV-uuCcN85VjtEckto,2912
|
|
53
|
+
al_core/learn/testgen.py,sha256=j5ZtnM1BQx2u4lv6y4_pw3qU8_ejAmdthLiancl6nRY,3645
|
|
54
|
+
al_core/mcp/__init__.py,sha256=HcYHokI4HloOoI3hyyawLB6MPW7MhhInagfPxzczX0I,652
|
|
55
|
+
al_core/mcp/chain.py,sha256=KgT9tWZ3QcYTh_aTqhMICQsO8CY4lYBg7lAB8WgEies,5690
|
|
56
|
+
al_core/mcp/descriptors.py,sha256=6b2y5wIJmfy2QRxT-9uuNiKIpd8UCLjeix72UEk-yWU,4270
|
|
57
|
+
al_core/mcp/mediator.py,sha256=OII0tvba_KK2e7B-OfZNqWOT6mDEY49MWvsoqlr-Awo,6609
|
|
58
|
+
al_core/mcp/proxy.py,sha256=WUR-G8YNyH5u5An1safZ88Q3yGqO6RAuMtXkKLE-60M,6039
|
|
59
|
+
al_core/mcp/session.py,sha256=EEHCcR0NiNIrZxomR26fq4ZJGgkijEgAiAqVoxf1WJU,25896
|
|
60
|
+
al_core/memory/__init__.py,sha256=BHosIweo7DDOwSjw6d5Di7Tdnni35Qq7YYkSggsDrwk,390
|
|
61
|
+
al_core/memory/guard.py,sha256=j4NS671HTeuh5CYgT5k8siDVYEG7OsSN7J6UEsnHupU,15192
|
|
62
|
+
al_core/memory/store.py,sha256=mg42-jw_1qldq6ej5CqugEP9q2C68-bSUbLQfDxr6a0,2740
|
|
63
|
+
al_core/normalize/__init__.py,sha256=hMVb6usM2-oHSui-wXTMlB_Y63n-JnnoWouwn0GsnXM,9153
|
|
64
|
+
al_core/receipt/__init__.py,sha256=FRL_lUd3g65AoJWlHeGOShERl9jXbDTaUs2T059Nx14,6116
|
|
65
|
+
al_core/skills/__init__.py,sha256=AMg4A3o6Zv8GYvBIdlS6Ls9o7k4qXMCJGvYtTuRnqyU,1496
|
|
66
|
+
al_core/skills/guard.py,sha256=omvl7_t6tvI34FU8pyIK18KmXpbw8fNrSCUxTvRD5Hs,8602
|
|
67
|
+
al_core/_bundled/configs/audit.yaml,sha256=GDVIaf_VKd8AuctlA9eGY6hlH-JurlIkIFiPHL_TGeo,381
|
|
68
|
+
al_core/_bundled/configs/balanced.yaml,sha256=h_Bxnf-MshoZb6OKZHz-GuacN_sKkW_woW86w2oqAVU,1158
|
|
69
|
+
al_core/_bundled/configs/strict.yaml,sha256=tozoN9nLStKq2d0WfWPArX2NhJLSM1QwhGBUqJBXJYQ,892
|
|
70
|
+
al_core/_bundled/dashboard/index.html,sha256=pBeR438v5MOPCoLqjtvhK6BSRCff782w_A0tpNGMY4c,547
|
|
71
|
+
al_core/_bundled/dashboard/assets/index-CN2LU6nV.css,sha256=1FvjGfzaCjVzZu-s88eiHjjq-HiMtoW87tQbTAsw2As,15704
|
|
72
|
+
al_core/_bundled/dashboard/assets/index-DX6cZzRi.js,sha256=7CiBLvZ5S5HYtCJEExvIn140hoh_KWCv2jqw8iTjVAI,172840
|
|
73
|
+
al_core/_bundled/policies/default-deny.yaml,sha256=F_Q3x9-n89y6FicsfLLsaC_aiWc5hvYp4MyRU8f15zM,1264
|
|
74
|
+
agentlighthouse_core-0.4.0.dist-info/METADATA,sha256=JV7ItCCwRLJEPTJVOHsd1EzN950xhcvCxReZk6DD6D8,15315
|
|
75
|
+
agentlighthouse_core-0.4.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
|
|
76
|
+
agentlighthouse_core-0.4.0.dist-info/entry_points.txt,sha256=zWzh6ysLBTC6Qc7imbmJD2fMf5IiHb7D4OwPaK_C8D4,44
|
|
77
|
+
agentlighthouse_core-0.4.0.dist-info/licenses/LICENSE,sha256=QvwVREpwY5_cU3N3-4FtDaQNdnQg7IzyLxrIsxdcNlE,1066
|
|
78
|
+
agentlighthouse_core-0.4.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Amit Kala
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
al_core/__init__.py
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
"""al-core — AgentLighthouse data + control plane (MIT)."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
from importlib.metadata import PackageNotFoundError, version as _dist_version
|
|
6
|
+
|
|
7
|
+
# The version lives in pyproject.toml (scripts/bump-version.sh); read it back
|
|
8
|
+
# from the installed distribution so the two cannot drift.
|
|
9
|
+
try:
|
|
10
|
+
__version__ = _dist_version("agentlighthouse-core")
|
|
11
|
+
except PackageNotFoundError: # running from a source tree that is not installed
|
|
12
|
+
__version__ = "0+unknown"
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Audit mode — observe and record, do not break workflows. The ONLY mode in
|
|
2
|
+
# which permissive settings (e.g. disabling a protection) are allowed, so teams
|
|
3
|
+
# can tune false positives before enforcing. Never run audit mode in production.
|
|
4
|
+
mode: audit
|
|
5
|
+
env: dev
|
|
6
|
+
listen: "0.0.0.0:8888"
|
|
7
|
+
scanner:
|
|
8
|
+
dlp:
|
|
9
|
+
enabled: true
|
|
10
|
+
ssrf:
|
|
11
|
+
block_private: true
|
|
12
|
+
dns_rebind_protection: true
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Balanced mode — the default. Protections on; block-wins verdict precedence.
|
|
2
|
+
# Secrets (admin_api_token) come from env / Docker secrets, never this file.
|
|
3
|
+
mode: balanced
|
|
4
|
+
env: dev
|
|
5
|
+
listen: "0.0.0.0:8888"
|
|
6
|
+
scanner:
|
|
7
|
+
dlp:
|
|
8
|
+
enabled: true
|
|
9
|
+
ssrf:
|
|
10
|
+
block_private: true
|
|
11
|
+
dns_rebind_protection: true
|
|
12
|
+
entropy:
|
|
13
|
+
path_threshold: 4.0
|
|
14
|
+
subdomain_threshold: 3.5
|
|
15
|
+
rate_limit:
|
|
16
|
+
per_domain_rps: 10
|
|
17
|
+
data_budget:
|
|
18
|
+
per_domain_bytes: 10485760
|
|
19
|
+
url_max_len: 8192
|
|
20
|
+
gateway:
|
|
21
|
+
# Default-deny: agents reach ONLY these hosts ("*.example.com" = subdomains).
|
|
22
|
+
allow_hosts: []
|
|
23
|
+
allow_ports: [80, 443]
|
|
24
|
+
require_identity: true
|
|
25
|
+
# forward_listen defaults to "127.0.0.1:8080". Left unset here so deployments
|
|
26
|
+
# can override via env (AL_GATEWAY__FORWARD_LISTEN) — explicit YAML beats env.
|
|
27
|
+
fetch_max_bytes: 5242880
|
|
28
|
+
max_redirects: 3
|
|
29
|
+
request_timeout_s: 30.0
|
|
30
|
+
pin_ttl_s: 300.0
|
|
31
|
+
# Upstream provider keys come ONLY from env/secrets:
|
|
32
|
+
# AL_GATEWAY__UPSTREAM__OPENAI_API_KEY / AL_GATEWAY__UPSTREAM__ANTHROPIC_API_KEY
|
|
33
|
+
egress:
|
|
34
|
+
bypass_self_test: auto # auto = enforced when env: prod
|
|
35
|
+
probe_targets: ["1.1.1.1:443", "8.8.8.8:53"]
|
|
36
|
+
probe_timeout_s: 3.0
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Strict mode — tightest thresholds. No permissive settings permitted here.
|
|
2
|
+
mode: strict
|
|
3
|
+
env: dev
|
|
4
|
+
listen: "0.0.0.0:8888"
|
|
5
|
+
scanner:
|
|
6
|
+
dlp:
|
|
7
|
+
enabled: true
|
|
8
|
+
ssrf:
|
|
9
|
+
block_private: true
|
|
10
|
+
dns_rebind_protection: true
|
|
11
|
+
entropy:
|
|
12
|
+
path_threshold: 3.5
|
|
13
|
+
subdomain_threshold: 3.0
|
|
14
|
+
rate_limit:
|
|
15
|
+
per_domain_rps: 5
|
|
16
|
+
data_budget:
|
|
17
|
+
per_domain_bytes: 5242880
|
|
18
|
+
url_max_len: 4096
|
|
19
|
+
gateway:
|
|
20
|
+
allow_hosts: [] # default-deny; add hosts deliberately
|
|
21
|
+
allow_ports: [443] # strict: HTTPS only
|
|
22
|
+
require_identity: true
|
|
23
|
+
fetch_max_bytes: 1048576
|
|
24
|
+
max_redirects: 1
|
|
25
|
+
request_timeout_s: 15.0
|
|
26
|
+
pin_ttl_s: 120.0
|
|
27
|
+
egress:
|
|
28
|
+
# auto = enforced when env: prod. ("enabled" would refuse to boot on any dev
|
|
29
|
+
# laptop with direct internet — set it only inside an isolated agent netns.)
|
|
30
|
+
bypass_self_test: auto
|
|
31
|
+
probe_targets: ["1.1.1.1:443", "8.8.8.8:53"]
|
|
32
|
+
probe_timeout_s: 3.0
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
:root{--bg: #0a0e14;--bg-1: #0f141c;--bg-2: #141b25;--bg-3: #1a2330;--line: #24303f;--line-2: #2f3d4f;--fg: #e7edf5;--fg-dim: #9fb0c3;--fg-mut: #6b7c91;--accent: #5ac8fa;--accent-2: #7aa2ff;--ok: #0ca30c;--bad: #e66767;--crit: #ff7a6b;--v-allow: #3987e5;--v-strip: #d95926;--v-warn: #c98500;--v-ask: #9085e9;--v-block: #e66767;--shadow: 0 10px 30px rgba(0, 0, 0, .4);--radius: 12px;--radius-sm: 8px;--mono: ui-monospace, "SF Mono", "SFMono-Regular", Menlo, Consolas, monospace;--sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Inter, sans-serif}:root[data-theme=light]{--bg: #f4f6fa;--bg-1: #ffffff;--bg-2: #ffffff;--bg-3: #eef2f7;--line: #dde4ec;--line-2: #cbd5e1;--fg: #101827;--fg-dim: #46566a;--fg-mut: #6b7c91;--accent: #0a84c9;--accent-2: #3b5bdb;--ok: #006300;--bad: #d03b3b;--v-allow: #2a78d6;--v-strip: #eb6834;--v-warn: #eda100;--v-ask: #4a3aa7;--v-block: #e34948;--shadow: 0 8px 24px rgba(20, 30, 50, .1)}*{box-sizing:border-box}html,body,#root{height:100%;margin:0}body{background:var(--bg);color:var(--fg);font-family:var(--sans);font-size:13.5px;line-height:1.5;-webkit-font-smoothing:antialiased}button,input,select{font-family:inherit;font-size:inherit;color:inherit}button{cursor:pointer}::-webkit-scrollbar{width:9px;height:9px}::-webkit-scrollbar-thumb{background:var(--line-2);border-radius:6px}::-webkit-scrollbar-track{background:transparent}.app{display:flex;flex-direction:column;height:100vh;overflow:hidden}.header{display:flex;align-items:center;gap:12px;padding:0 18px;height:52px;flex:0 0 auto;background:linear-gradient(180deg,var(--bg-2),var(--bg-1));border-bottom:1px solid var(--line)}.brand{display:flex;align-items:center;gap:10px}.brand .mark{width:22px;height:22px}.brand h1{font-size:14.5px;margin:0;font-weight:650;letter-spacing:.2px}.brand .tag{font-size:11px;color:var(--fg-mut);margin-left:2px}.header .spacer{flex:1}.boards{display:inline-flex;margin-left:14px;background:var(--bg-3);border:1px solid var(--line-2);border-radius:999px;padding:2px}.boards button{border:none;background:none;color:var(--fg-mut);font-weight:650;font-size:12px;padding:4px 14px;border-radius:999px}.boards button.active{background:var(--bg-1);color:var(--fg);box-shadow:inset 0 0 0 1px var(--line-2)}.chip{display:inline-flex;align-items:center;gap:6px;padding:3px 10px;border-radius:999px;font-size:11.5px;font-weight:600;border:1px solid var(--line-2);color:var(--fg-dim);white-space:nowrap}.chip .dot{width:7px;height:7px;border-radius:50%;background:var(--fg-mut)}.chip.ok{color:var(--ok);border-color:color-mix(in srgb,var(--ok) 40%,transparent)}.chip.ok .dot{background:var(--ok)}.chip.bad{color:var(--bad);border-color:color-mix(in srgb,var(--bad) 45%,transparent)}.chip.bad .dot{background:var(--bad);box-shadow:0 0 8px var(--bad)}.chip.warn{color:var(--v-warn);border-color:color-mix(in srgb,var(--v-warn) 45%,transparent)}.chip.warn .dot{background:var(--v-warn)}.beacon{display:inline-flex;align-items:center;gap:7px;padding:3px 11px;border-radius:999px;font-size:11.5px;font-weight:650;border:1px solid var(--line-2);color:var(--fg-dim);white-space:nowrap}.beacon .beam{width:12px;height:12px;border-radius:50%;position:relative;background:var(--bg-3);overflow:hidden;flex:0 0 auto}.beacon .beam:before{content:"";position:absolute;top:0;right:0;bottom:0;left:0;border-radius:50%;background:conic-gradient(from 0deg,var(--accent) 0 40deg,transparent 40deg 360deg)}.beacon.live{color:var(--accent);border-color:color-mix(in srgb,var(--accent) 45%,transparent)}.beacon.live .beam:before{animation:sweep 2.4s linear infinite}.beacon.paused .beam:before{background:conic-gradient(from 0deg,var(--fg-mut) 0 40deg,transparent 40deg 360deg)}.beacon.off{color:var(--bad);border-color:color-mix(in srgb,var(--bad) 45%,transparent)}.beacon.off .beam:before{background:conic-gradient(from 0deg,var(--bad) 0 40deg,transparent 40deg 360deg)}@keyframes sweep{to{transform:rotate(360deg)}}@media (prefers-reduced-motion: reduce){.beacon.live .beam:before{animation:none}.event.enter{animation:none}}select.org,.icon-btn{background:var(--bg-3);border:1px solid var(--line-2);border-radius:var(--radius-sm);padding:5px 9px;color:var(--fg-dim)}.icon-btn:hover,select.org:hover{border-color:var(--accent);color:var(--fg)}.toolbar{display:flex;align-items:center;gap:10px;flex-wrap:wrap;padding:10px 18px;flex:0 0 auto;background:var(--bg-1);border-bottom:1px solid var(--line)}.search{flex:1 1 260px;min-width:180px;display:flex;align-items:center;gap:8px;background:var(--bg-3);border:1px solid var(--line-2);border-radius:var(--radius-sm);padding:6px 10px}.search:focus-within{border-color:var(--accent);box-shadow:0 0 0 3px color-mix(in srgb,var(--accent) 18%,transparent)}.search input{flex:1;background:none;border:none;outline:none}.search svg{color:var(--fg-mut);flex:0 0 auto}.seg{display:inline-flex;background:var(--bg-3);border:1px solid var(--line-2);border-radius:var(--radius-sm);overflow:hidden}.seg button{padding:5px 10px;background:none;border:none;color:var(--fg-mut);border-right:1px solid var(--line-2);font-weight:600;font-size:11.5px}.seg button:last-child{border-right:none}.seg button.active{background:color-mix(in srgb,var(--accent) 20%,var(--bg-3));color:var(--fg)}select.filter{background:var(--bg-3);border:1px solid var(--line-2);border-radius:var(--radius-sm);padding:6px 9px;color:var(--fg-dim)}select.filter:hover{border-color:var(--accent)}.btn{padding:6px 12px;border-radius:var(--radius-sm);font-weight:600;font-size:12px;background:var(--bg-3);border:1px solid var(--line-2);color:var(--fg-dim)}.btn:hover{border-color:var(--accent);color:var(--fg)}.btn.primary{background:var(--accent);border-color:var(--accent);color:#05121b}.btn.primary:hover{filter:brightness(1.08)}.btn.ghost{background:none}.toggle{display:inline-flex;align-items:center;gap:6px;color:var(--fg-mut);font-size:12px}.main.trace{flex:1 1 auto;display:grid;grid-template-columns:380px 1fr 400px;min-height:0;overflow:hidden}.main.perf{flex:1 1 auto;min-height:0;overflow-y:auto}.perf-grid{padding:16px 18px;max-width:1320px;margin:0 auto}.perf-grid .tiles{margin-bottom:14px}.two-up{display:grid;grid-template-columns:1fr 1fr;gap:14px}.three-up{display:grid;grid-template-columns:repeat(3,1fr);gap:14px}@media (max-width: 980px){.two-up,.three-up{grid-template-columns:1fr}}.col{min-height:0;overflow-y:auto;padding:14px}.col.left{border-right:1px solid var(--line);background:var(--bg-1)}.col.right{border-left:1px solid var(--line);background:var(--bg-1)}.col-title{font-size:11px;text-transform:uppercase;letter-spacing:.7px;color:var(--fg-mut);font-weight:700;margin:2px 0 12px;display:flex;align-items:center;justify-content:space-between}.col-title .count{color:var(--fg-dim);font-variant-numeric:tabular-nums}@media (max-width: 1180px){.main.trace{grid-template-columns:340px 1fr}.col.right{position:fixed;top:103px;right:0;bottom:0;width:400px;z-index:20;box-shadow:var(--shadow);transform:translate(105%);transition:transform .22s ease;background:var(--bg-1)}.col.right.open{transform:translate(0)}}.card{background:var(--bg-2);border:1px solid var(--line);border-radius:var(--radius);padding:14px;margin-bottom:14px}.card h3{font-size:11px;text-transform:uppercase;letter-spacing:.6px;color:var(--fg-mut);font-weight:700;margin:0 0 12px}.card.empty-note{color:var(--fg-mut);font-size:12.5px}.tiles{display:grid;grid-template-columns:repeat(auto-fit,minmax(150px,1fr));gap:12px}.tile{background:var(--bg-2);border:1px solid var(--line);border-radius:var(--radius);padding:12px 14px}.tile .k{font-size:10.5px;text-transform:uppercase;letter-spacing:.6px;color:var(--fg-mut);font-weight:700}.tile .v{font-size:25px;font-weight:720;margin-top:4px;letter-spacing:-.4px}.tile .v.bad{color:var(--v-block)}.tile .v.warn{color:var(--v-warn)}.tile .v.ok{color:var(--ok)}.tile .sub{font-size:11px;color:var(--fg-mut);margin-top:2px}.stream{display:flex;flex-direction:column;gap:7px}.event{display:grid;grid-template-columns:auto 1fr auto;gap:8px;align-items:center;padding:9px 11px;border-radius:var(--radius-sm);background:var(--bg-2);border:1px solid var(--line);cursor:pointer;transition:border-color .12s,background .12s}.event:hover{border-color:var(--line-2);background:var(--bg-3)}.event.selected{border-color:var(--accent);background:color-mix(in srgb,var(--accent) 10%,var(--bg-2))}.event.enter{animation:slidein .3s ease}@keyframes slidein{0%{opacity:0;transform:translateY(-6px)}to{opacity:1;transform:none}}.event .meta{min-width:0}.event .line1{display:flex;align-items:center;gap:7px}.event .actor{font-family:var(--mono);font-size:11.5px;color:var(--fg);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.event .line2{font-size:11px;color:var(--fg-mut);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.event .seq{font-family:var(--mono);font-size:10.5px;color:var(--fg-mut)}.event .tail{display:flex;flex-direction:column;align-items:flex-end;gap:1px}.event .time{font-family:var(--mono);font-size:10.5px;color:var(--fg-mut);white-space:nowrap}.event .lat{font-family:var(--mono);font-size:10px;color:var(--fg-mut)}.pill{font-size:10px;font-weight:750;text-transform:uppercase;letter-spacing:.4px;padding:2px 7px;border-radius:5px;white-space:nowrap}.pill.allow{color:var(--v-allow);background:color-mix(in srgb,var(--v-allow) 15%,transparent)}.pill.block{color:var(--v-block);background:color-mix(in srgb,var(--v-block) 16%,transparent)}.pill.strip{color:var(--v-strip);background:color-mix(in srgb,var(--v-strip) 15%,transparent)}.pill.warn{color:var(--v-warn);background:color-mix(in srgb,var(--v-warn) 15%,transparent)}.pill.ask{color:var(--v-ask);background:color-mix(in srgb,var(--v-ask) 16%,transparent)}.plane{display:inline-block;font-size:9.5px;font-weight:750;text-transform:uppercase;letter-spacing:.5px;padding:1px 6px;border-radius:4px;border:1px solid var(--line-2);color:var(--fg-dim)}.plane.data{color:var(--accent);border-color:color-mix(in srgb,var(--accent) 45%,transparent)}.plane.control{color:var(--accent-2);border-color:color-mix(in srgb,var(--accent-2) 45%,transparent)}.alert-card{border:1px solid var(--line);border-left:3px solid var(--v-block);border-radius:var(--radius-sm);background:var(--bg-2);padding:11px 13px;margin-bottom:10px;cursor:pointer;transition:border-color .12s,background .12s}.alert-card.v-ask{border-left-color:var(--v-ask)}.alert-card:hover{background:var(--bg-3)}.alert-card.selected{border-color:var(--accent)}.alert-card .head{display:flex;align-items:center;gap:9px}.alert-card .reason{font-weight:700;font-size:12.5px;flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.alert-card .when{font-family:var(--mono);font-size:10.5px;color:var(--fg-mut)}.alert-card .grid{display:grid;grid-template-columns:64px 1fr;gap:3px 10px;margin-top:8px}.alert-card .k{color:var(--fg-mut);font-size:10.5px;text-transform:uppercase;letter-spacing:.5px;padding-top:1px}.alert-card .v{font-size:11.5px;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.alert-card .v.mono,.mono{font-family:var(--mono)}.alert-card .rules{display:flex;flex-wrap:wrap;gap:6px;margin-top:9px}.alert-card .rule{display:inline-flex;align-items:center;gap:6px;font-size:10.5px;border:1px solid var(--line);border-radius:5px;padding:2px 7px;background:var(--bg-1)}.alert-card .rule .t{color:var(--fg-mut)}.bar{display:flex;align-items:center;gap:10px;margin:7px 0}.bar .lbl{width:130px;font-size:11.5px;color:var(--fg-dim);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.bar .track{flex:1;height:8px;background:var(--bg-3);border-radius:5px;overflow:hidden}.bar .fill{height:100%;border-radius:5px;transition:width .4s ease}.bar .n{width:46px;text-align:right;font-variant-numeric:tabular-nums;color:var(--fg-mut);font-size:11.5px}.chart-wrap{position:relative}.chart svg{width:100%;display:block}.chart .axis{stroke:var(--line-2);stroke-width:1}.chart .grid{stroke:var(--line);stroke-width:1}.legend{display:flex;gap:14px;margin-top:8px;flex-wrap:wrap;align-items:center}.legend span{display:inline-flex;align-items:center;gap:6px;font-size:11px;color:var(--fg-dim)}.legend i{width:10px;height:10px;border-radius:3px;display:inline-block}.brush-hint{font-size:10.5px;color:var(--fg-mut);margin-top:6px}.empty-chart{font-size:12px;padding:28px 8px;text-align:center}.tip{position:absolute;top:6px;transform:translate(-50%);background:var(--bg-1);border:1px solid var(--line-2);border-radius:var(--radius-sm);padding:7px 10px;pointer-events:none;box-shadow:var(--shadow);min-width:130px;z-index:5}.tip .t-when{font-family:var(--mono);font-size:10px;color:var(--fg-mut);margin-bottom:4px}.tip .t-row{display:flex;align-items:center;gap:6px;font-size:11px;color:var(--fg-dim)}.tip .t-row b{margin-left:auto;color:var(--fg);font-variant-numeric:tabular-nums}.tip .t-row.total{font-weight:700}.tip .t-row i{width:8px;height:8px;border-radius:2px}.detail .empty{color:var(--fg-mut);text-align:center;padding:40px 12px}.detail .kv{display:grid;grid-template-columns:92px 1fr;gap:6px 10px;margin-bottom:12px}.detail .kv .k{color:var(--fg-mut);font-size:11.5px}.detail .kv .v{font-family:var(--mono);font-size:11.5px;word-break:break-all}.finding-row{padding:8px 10px;border:1px solid var(--line);border-radius:var(--radius-sm);margin-bottom:7px;background:var(--bg-2)}.finding-row .top{display:flex;justify-content:space-between;gap:8px}.finding-row .rid{font-family:var(--mono);font-size:11px}.tags{display:flex;gap:5px;flex-wrap:wrap;margin-top:5px}.tags .t{font-size:10px;padding:1px 6px;border-radius:4px;background:var(--bg-3);color:var(--fg-mut);border:1px solid var(--line)}.sev-high{color:var(--v-block)}.sev-critical{color:var(--crit)}.sev-medium{color:var(--v-warn)}.sev-low{color:var(--fg-dim)}.jsontree{font-family:var(--mono);font-size:11px;line-height:1.6;white-space:pre-wrap;word-break:break-word;background:var(--bg);border:1px solid var(--line);border-radius:var(--radius-sm);padding:10px;max-height:260px;overflow:auto}.jsontree .key{color:var(--accent)}.jsontree .str{color:var(--fg-dim)}.verify-box{display:flex;align-items:center;gap:10px;padding:10px 12px;border-radius:var(--radius-sm);border:1px solid var(--line);margin-top:10px}.verify-box.pass{border-color:color-mix(in srgb,var(--ok) 40%,transparent);background:color-mix(in srgb,var(--ok) 8%,transparent)}.verify-box.fail{border-color:color-mix(in srgb,var(--bad) 40%,transparent);background:color-mix(in srgb,var(--bad) 8%,transparent)}.verify-box .txt{flex:1}.verify-box .txt .t1{font-weight:700}.verify-box .txt .t2{font-size:11px;color:var(--fg-mut)}.gate{height:100vh;display:grid;place-items:center}.gate .panel{width:380px;max-width:92vw;background:var(--bg-2);border:1px solid var(--line);border-radius:16px;padding:30px 28px;box-shadow:var(--shadow)}.gate .mark{width:40px;height:40px;margin-bottom:12px}.gate h2{margin:0 0 4px;font-size:18px}.gate p{color:var(--fg-mut);font-size:12.5px;margin:0 0 20px}.gate label{font-size:11px;text-transform:uppercase;letter-spacing:.5px;color:var(--fg-mut);font-weight:700}.gate input{width:100%;margin:6px 0 14px;padding:10px 12px;background:var(--bg-3);border:1px solid var(--line-2);border-radius:var(--radius-sm);outline:none}.gate input:focus{border-color:var(--accent)}.gate .err{color:var(--bad);font-size:12px;margin-top:-8px;margin-bottom:12px}.gate .btn.primary{width:100%;padding:10px;justify-content:center}.status-line{font-size:11px;color:var(--fg-mut)}.status-line.err{color:var(--bad)}.muted{color:var(--fg-mut)}.spin{display:inline-block;width:13px;height:13px;border:2px solid var(--line-2);border-top-color:var(--accent);border-radius:50%;animation:rot .7s linear infinite}@keyframes rot{to{transform:rotate(360deg)}}
|