incidents-plugin

A lightweight operational incident log for protoAgent — the agent files, reads, and resolves incidents in a store it owns end to end. No external service.

Tools

• report_incident(title, detail, severity, source) — file an incident, returns its id (INC-1, INC-2, …).
• get_incidents(status, limit) — read the log (open | resolved | all), newest first.
• resolve_incident(incident_id, resolution) — close an open incident.

Storage

One incidents.json written atomically (temp + os.replace), instance-scoped per ADR 0004 — PROTOAGENT_INSTANCE adds a subdir, so prod and the dev sandbox keep separate logs. Override the base dir with incidents.dir config or INCIDENTS_DIR.

Install

python -m server plugin install https://github.com/protoLabsAI/incidents-plugin
# then add `incidents` to plugins.enabled in your config and restart

Test

cd /path/to/protoAgent && uv run --frozen python -m pytest /path/to/incidents-plugin -q

Ported from the report_incident / get_incidents surface of protoWorkstacean's Ava agent.