Skip to contentOTHRYS

ARCHITECTURE NOTE · TWO-LAYER AGENT SECURITY

Aegis & Klethron
two-layer security for local agents.

OTHRYS runs local coding agents across desktop and workstation nodes to build and verify web utilities. Every live tool call passes through Aegis 1.0 (the ~14 µs hot-path firewall), while Klethron 0.1 watches repos, static CSP bundles, open sockets, and SHA-256 ledgers from an airgapped cold path.

Constitutional Invariant
“Klethron observes; Aegis denies; neither ever manufactures authority.”
PASS < OBSERVE < WARN < ASK < RESTRICT < DENY < LOCK · UNKNOWN != GREEN
~14 µsHot-Path Gate Eval
0 tokModel Inference Spend
5 Clans + 4 ProbesInner Gate & Outer Ring
Unknown != Green>24h Stale Failsafe

01 / THE KLETHRON ADDITION

Why Klethron was added around Aegis

Aegis 1.0 guards what an autonomous agent tries to do right now. Klethron 0.1 was added as an airgapped outer ring so OTHRYS can verify that repositories, deployed bundles, cloud RLS, open sockets, and the audit chain itself remain intact between sessions.

01 · WHAT AEGIS ALREADY COVERS

Inner pre-syscall enforcement

Aegis 1.0 inspects every agent tool call inline (~14 µs, zero LLM tokens). Inside an approved repo root, normal work passes silently; path escapes, secret reads, SSRF targets, and destructive shell ops trigger PASS, ASK, DENY, or LOCK.

02 · THE GAP WE CLOSED

Health outside single tool calls

Blocking one dangerous syscall does not prove whether surrounding repo commits carry leaked credentials, static utility bundles preserve strict CSP headers, cloud RLS policies remain closed, or stray 0.0.0.0 sockets stayed bound.

03 · THE KLETHRON ADDITION

Cold-path posture & ledger witness

Klethron 0.1 wraps a passive outer ring around Aegis: it merges bounded offline sensor snapshots with Aegis's SHA-256 hash-chained log without modifying disk, git, or policy—failing dark if any signal is missing or >24h stale.

Ring 01 (Aegis 1.0) vs. Ring 02 (Klethron 0.1) responsibilities
DimensionRing 01 · Aegis 1.0 (Hot Path)Ring 02 · Klethron 0.1 (Cold Path)
Primary roleEnforces every live agent tool call before executionObserves whole-environment posture & SHA-256 ledger continuity
Execution pathHot path (~14 µs evaluation, 0 LLM tokens)Cold path (scheduled posture emitter + offline read-only fusion)
Authority modelSubtracts authority only via a 7-level monotonic ratchetRead-only observer (authorityGranted: false, hard execution airgap)
Verified inputsFile paths, normalized shell commands, DNS/IP targets, tripwiresBounded sensor JSON (OpSec, Zero-Egress, Cloud RLS, Fleet Sockets) + ledger tip
Outputs & failsafePASS / ASK / DENY / LOCK verdicts appended to SHA-256 JSONL ledgerPASS / HOLD / UNKNOWN status where Unknown != Green after 24h

02 / WHAT'S NEW · NOVEMBER 2026

Recent hardening & Klethron perimeter rollout

Following SIMPLIFY-01 consolidation, the security architecture pairs upgraded inner parser & SSRF defenses with a lean 8-track passive perimeter—eliminating background collector daemons and silent false greens.

NEW · KLETHRON 0.1 PERIMETER

Cold-path threat fusion & posture ring

Adds a passive outer observation layer that correlates static bundle CSP/zero-egress, repo OPSEC, cloud RLS/quotas, and local socket posture without custom SIEM daemons.

HARDENED · OFFLINE DNS SSRF

Wildcard rebinding blocked offline

Custody now decodes .sslip.io, .nip.io, .xip.io, .traefik.me, localtest.me, lvh.me, and vcap.me (dotted, dashed, and 8-hex IPv4) locally before any HTTP fetch occurs.

HARDENED · MULTI-SHELL PARSER

ANSI-C hex & cmd caret unescaping

Tartarus strips POSIX $'\x72\x6d' hex/octal escapes and Windows cmd caret (^) obfuscation ahead of command classification, paired with PowerShell subexpression checks.

VERIFIED · LEDGER WITNESSING

Hash-chained aegis.decision.v1 trail

Every hot-path ALLOW, ASK, DENY, or LOCK writes an unbroken SHA-256 chain; Klethron verifies the rolling witnessTip and flags truncated or modified local logs.

POLICY · TRUTH-IN-STATUS

Unknown != Green enforcement

Missing credentials, disconnected sensors, or >24h stale readings automatically degrade to UNKNOWN across CLI reports and owner dashboards instead of silent green.

CORPUS · OWASP AGENTIC TOP 10

Offline adversarial Dojo regression

Aegis Dojo includes offline regression probes covering ANSI-C destruction, caret splitting, wildcard DNS SSRF, indirect prompt injections, and canary leaks.

03 / ARCHITECTURE MAP

How the hot path and cold perimeter work together

Select a scenario below to trace how ordinary workspace calls clear silently, boundary violations quarantine pre-syscall, high-blast commands ask the owner directly, and Klethron audits everything offline.

Trace a request or audit path
All LayersFull two-ring architecture: every agent call passes through Aegis 1.0 in ~14 µs, writes to an append-only SHA-256 ledger, and is audited offline by Klethron 0.1 without granting automated control.
Autonomous Coding Agents
Untrusted Tool CallsFile · Shell · HTTP / MCP

Local coding assistants and build workers emit filesystem, command, or network calls. No agent ever holds raw bypass authority over the OS gate.

RING 01 · AEGIS 1.0 — Inner Deterministic Firewall (Hot Path)
~14 µs median0 LLM tokensSubtract-only authority
Paths & Symlinks
Labyrinth

Keeps reads and edits inside verified workspace roots.

Shell & SQL
Tartarus

Unescapes ANSI-C $'...' & carets (^); stops destructive flags.

Secrets & SSRF
Custody

Redacts keys; decodes .sslip.io / .nip.io offline pre-request.

Loop Brakes
Hecatoncheires

Halts runaway repeated tool calls and violation storms.

Canary & Leaks
Minotaur

Locks immediately on decoy touches or exfiltration trifectas.

Monotonic 7-Level Ratchet

All five clans vote in parallel; the strictest verdict wins and can never be downgraded by prompts or plugins.

PASS < OBSERVE < WARN < ASK < RESTRICT < DENY < LOCK
SAFE CALLS
PASS · Allow Silently

Approved workspace edits and tests execute with zero confirmation popups.

HIGH BLAST RADIUS
ASK · Pause & Confirm

Sensitive or irreversible actions request exact one-time human approval.

ESCAPES & SSRF
DENY / LOCK · Block

Travels, canary hits, ANSI-C obfuscation, and metadata SSRF halt pre-syscall.

APPEND-ONLY AUDIT
LEDGER · SHA-256 Chain

Every decision appends to local aegis.decision.v1 JSONL with a rolling digest.

Direct channel: ASK pauses execution until the Human Owner approves or denies
Read-only witness stream: Ledger emits SHA-256 witnessTip into Klethron (KLE-L6)
RING 02 · KLETHRON 0.1 — Outer Observation Perimeter (Cold Path)
SIMPLIFY-010 network in fusion0 writesUnknown != Green
COLLECTORS · L2–L6
Offline Scanners & Probes

Correlates pinned Trivy scans, repo OPSEC, static CSP zero-egress, cloud RLS/quotas, and 0.0.0.0 socket checks.

COLD-PATH CORE
Deterministic Fusion & Witness

Deduplicates via key-sorted SHA-256, strips raw secrets/findings on ingest, and degrades >24h or missing feeds to UNKNOWN.

FAILSAFE BOUNDARY
Hard Execution Airgap

authorityGranted: false — Klethron cannot trigger firewall bans, token rotations, or self-lockout actions.

POSTURE CONSOLE
Truth-in-Status Visibility

Shows honest OK / WARN / FAIL / UNKNOWN status and SHA-256 ledger tip inside owner Huddle.

HUMAN TRIAGE
Review Proposals (REVIEW_SESSION)

Packages reproducible findings for human review without blocking or editing code automatically.

CRYPTOGRAPHIC PROOF
Off-Host Witness Anchor

Detects truncated or edited local Aegis ledgers whenever the hash chain breaks.

Human Owner — Sole Authority

Grants one-time ASK approvals, investigates surfaced WARN / FAIL / UNKNOWN posture alerts, and merges reviewed changes.

Owner Merge OnlyNo Unsupervised Writes

04 / DESIGN MODEL

Why OTHRYS uses deterministic two-layer security

PRINCIPLE 01 · DETERMINISM

Outside the model context

Asking a second language model to judge the first adds latency, burns tokens, and fails under indirect prompt injection. Aegis & Klethron run pure deterministic parsers and hash checks—no prompt can persuade a parser.

PRINCIPLE 02 · ERGONOMICS

Zero prompts inside the workspace

Inside an approved repository root, agents read files, edit code, and run test suites without confirmation popups. The gate only intervenes when a call crosses workspace, credential, or destructive-command boundaries.

PRINCIPLE 03 · AIRGAP

Observe vs. Deny separation

Aegis subtracts authority via a monotonic 7-level ratchet. Klethron only observes on a cold read-only path (authorityGranted: false) behind an execution airgap—eliminating solo-operator self-lockout risk.

05 / INNER & OUTER DOMAINS

Five defense clans plus one cold-path perimeter

Mythological names map directly to concrete engineering boundaries—making it clear at a glance which subsystem owns path containment, shell normalization, secret scrubbing, rate limits, tripwires, or estate posture.

CLAN 01 · PATH · Workspace & Path Containment

Labyrinth

Resolves symlinks, recursive URL encodings, null bytes, Windows Alternate Data Streams, and credential dotfiles (~/.ssh, ~/.aws, .env) before any file operation executes.

CLAN 02 · EXEC · Shell, SQL & Process Shield

Tartarus

Quote-aware POSIX, PowerShell, and CMD parser with ANSI-C $'...' and caret (^) unescaping—blocking destructive chains while keeping in-workspace builds silent.

CLAN 03 · EGRESS · Secrets & SSRF Airlock

Custody

Redacts live keys and tokens in flight and blocks cloud-metadata SSRF across hex, octal, IPv6, and offline wildcard DNS services (.sslip.io / .nip.io / localtest.me).

CLAN 04 · RATE · Loop & Escalation Brakes

Hecatoncheires

Concurrency sentinel that halts runaway identical tool calls in milliseconds and locks sessions that trip repeated boundary violations within a rolling window.

CLAN 05 · SENSOR · Canary Tripwires & Leak Sensor

Minotaur

Monitors decoy credential files that legitimate tasks never touch and escalates immediately if private reads combine with untrusted inputs and outbound egress.

OUTER RING · KLETHRON 0.1 · Cold-Path Posture & Witness

Klethron Perimeter

Audits public repos for LAN/path leaks, verifies static utility CSP headers and zero-egress, checks 0.0.0.0 local binds, and anchors Aegis SHA-256 ledger tips read-only.

06 / INTERACTIVE WALKTHROUGH

Inspect gate verdicts in your browser

Select a workspace task or an adversarial probe below (including offline .sslip.io DNS rebinding and POSIX ANSI-C / caret escapes) to see how Aegis decides with zero model tokens.

AEGIS GATE EVALUATOR · CLIENT-SIDE SIMULATION0 LLM calls · deterministic rules
PASSAll 5 Clans · Clear

Call stays within workspace root with zero secret, SSRF, or destructive command indicators (~14µs, 0 tokens).