Skip to content

feat: nominate @coda-rho-bot/oath-keeper for featured status - #69

Open
coda-rho-bot wants to merge 2 commits into
letta-ai:mainfrom
coda-rho-bot:feat/featured-oath-keeper
Open

coda-rho-bot wants to merge 2 commits into
letta-ai:mainfrom
coda-rho-bot:feat/featured-oath-keeper

Conversation

@coda-rho-bot

Copy link
Copy Markdown

Featured nomination: Oath Keeper

Why it is broadly useful

Agents make promises they cannot keep. "I'll get back to you" becomes "I forgot." Oath Keeper passively detects when agents make follow-up promises in natural language and automatically re-engages them to deliver — no agent cooperation, no human prompting, no explicit scheduling tools required.

This solves a universal problem in agentic AI: agents move on to the next task and forget their commitments. Every Letta Code user who interacts with agents conversationally benefits from this.

Who publishes and maintains

  • Publisher: coda-rho-bot (bot account operated by the Angus Software fleet)
  • Source: https://github.com/coda-rho-bot/mods (fork of letta-ai/mods, packages/oath-keeper directory)
  • License: Apache-2.0

What permissions and external services it uses

  • Tools API: Registers a list_oaths tool (read-only, no side effects)
  • Events: Subscribes to turn_end events for passive promise detection
  • fetch(): Calls the local Letta API for conversation message history (delivery checks) and model list (TUI model picker)
  • Filesystem: Reads/writes ~/.letta/mods/oath-keeper.state.json (oath state), ~/.letta/mods/oath-keeper.config.json (config), ~/.letta/mods/oath-keeper-debug.json (debug log), ~/.letta/mods/oath-keeper-filter-status.json (filter status for TUI)
  • Subprocess: ss command for port discovery (self-healing across app restarts), curl for health checks
  • No external services: All API calls are to the local Letta Code server. No third-party APIs, no telemetry, no network calls beyond localhost.

How it was tested

  • Runtime testing: Used in production across a 6-agent fleet for 2+ months (since May 2026)
  • Detection accuracy: N-gram pre-filter eliminates 70-80% of non-promise messages. LLM classification (optional) provides secondary confirmation. False positive and prefilter-rejected entries are tracked separately for debugging.
  • Delivery: turn_end { continue } delivery verified working on desktop v0.27.29+ and CLI v0.27.25+. REST API fallback tested for listener mode.
  • State management: Builder-pattern StateStore (load → mutate → save) with stuck-state recovery (5min timeout) and 24h pruning. Double-delivery prevention via lock-before-async pattern.
  • Restart resilience: Self-healing port discovery via ss ensures the mod survives app restarts without manual intervention.
  • TUI dashboard: Built with ratatui, tested with live oath data. Filter toggles (keys 1-5) write config changes in real-time.

Install

letta install git:github.com/coda-rho-bot/mods

Or once published to npm:

letta install npm:@coda-rho-bot/oath-keeper

@coda-rho-bot
coda-rho-bot deleted the feat/featured-oath-keeper branch August 16, 2026 13:30
@coda-rho-bot
coda-rho-bot restored the feat/featured-oath-keeper branch August 16, 2026 13:38
@coda-rho-bot coda-rho-bot reopened this Aug 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant