Skip to main content

Module agent_jekt_keys

Module agent_jekt_keys 

Source
Expand description

Per-agent HMAC-SHA256 signing key for host-tier jekt sender verification. See db_agent_jekt_keys in migrations.rs (OBJECT_SCHEMA_VERSION v18) and docs/specs/SPEC_JEKT_TRUST_LAYER_COMPLETION_2026_08_13.md §2.2.

One row per locally-registered agent_id. The key is minted once (first call to agent_jekt_key_ensure for that agent — normally at spawn, via agent_config/agent_open) and never leaves this srv instance except by being injected into that ONE agent’s own MCP server process env (AGENTMUX_JEKT_KEY) — never into any other agent’s env, and never returned over any RPC. This is what makes the resulting signature mean something: only the agent it claims to be from ever held the key needed to produce it.

As of docs/specs/SPEC_JEKT_HOST_KEY_TTL_ROTATION_2026_09_14.md, a key past JEKT_KEY_TTL_SECS old is rotated the next time agent_jekt_key_ensure is called for it (i.e. at that agent’s next spawn) — see that spec for why this is lazy-at-next-mint rather than invalidating a live key. agent_jekt_key_load (the verification-read path) is deliberately unaffected: it has no concept of “too old,” only “matches” or “doesn’t.”

Constants§

JEKT_KEY_TTL_SECS 🔒
A key older than this is rotated at its agent’s next spawn (the next agent_jekt_key_ensure call), not invalidated in place — see docs/specs/SPEC_JEKT_HOST_KEY_TTL_ROTATION_2026_09_14.md §2.