LibreFang Plugin Registry

Official plugin registry for LibreFang context engine plugins.

Installing a plugin

curl -X POST http://127.0.0.1:4545/api/plugins/install \
  -H "Content-Type: application/json" \
  -d '{"source": "registry", "name": "echo-memory"}'

Contributing a plugin

1. Fork this repo
2. Create plugins/<your-plugin-name>/ with:
   • plugin.toml — manifest (name, version, hooks)
   • hooks/ — Python hook scripts
   • requirements.txt — optional Python dependencies
3. Open a PR

Plugin manifest format

name = "my-plugin"
version = "0.1.0"
description = "What the plugin does"
author = "your-name"

[hooks]
ingest = "hooks/ingest.py"
after_turn = "hooks/after_turn.py"

Hook protocol

Hooks receive JSON on stdin and print JSON to stdout:

ingest hook — called when agent receives a user message:

// stdin
{"type": "ingest", "agent_id": "...", "message": "user message"}
// stdout
{"type": "ingest_result", "memories": [{"content": "recalled fact"}]}

after_turn hook — called after each conversation turn:

// stdin
{"type": "after_turn", "agent_id": "...", "messages": [...]}
// stdout
{"type": "ok"}