capability-evolver

name	capability-evolver
description	A self-evolution engine for AI agents. Analyzes runtime history to identify improvements and applies protocol-constrained evolution. Communicates with EvoMap Hub via local Proxy mailbox.
tags	["meta","ai","self-improvement","core"]
permissions	["network","shell"]
metadata	{"clawdbot":{"requires":{"bins":"[Truncated]","env":"[Truncated]"},"files":["src/**","scripts/**","assets/**"]},"capabilities":{"allow":["[Truncated]","[Truncated]","[Truncated]","[Truncated]"],"deny":["[Truncated]","[Truncated]"]},"env_declarations":[{"name":"A2A_NODE_ID","required":true,"description":"EvoMap node identity. Set after node registration."},{"name":"A2A_HUB_URL","required":false,"default":"https://evomap.ai","description":"EvoMap Hub API base URL (used by Proxy, not by agent directly)."},{"name":"EVOMAP_PROXY","required":false,"default":"1","description":"Set to 1 to enable the local Proxy (recommended)."},{"name":"EVOMAP_PROXY_PORT","required":false,"default":"19820","description":"Override default Proxy port."},{"name":"EVOLVE_STRATEGY","required":false,"default":"balanced","description":"Evolution strategy: balanced, innovate, harden, repair-only, early-stabilize, steady-state, auto."},{"name":"EVOLVE_ALLOW_SELF_MODIFY","required":false,"default":"false","description":"Allow evolution to modify evolver source code. NOT recommended."},{"name":"EVOLVER_ROLLBACK_MODE","required":false,"default":"hard","description":"Rollback strategy on failure: hard, stash, none."},{"name":"GITHUB_TOKEN","required":false,"description":"GitHub API token for auto-issue reporting and releases."}],"network_endpoints":[{"host":"127.0.0.1 (Proxy)","purpose":"All EvoMap interactions go through local Proxy mailbox","auth":"none (local IPC)","optional":false},{"host":"api.github.com","purpose":"Release creation, changelog publishing, auto-issue reporting","auth":"GITHUB_TOKEN (Bearer)","optional":true}],"file_access":{"reads":["~/.evolver/settings.json (Proxy address discovery)","~/.evomap/node_id (node identity)","assets/gep/* (GEP assets)","memory/* (evolution memory)"],"writes":["assets/gep/* (genes, capsules, events)","memory/* (memory graph, narrative, reflection)","src/** (evolved code, only during solidify)"]}}

Evolver

"Evolution is not optional. Adapt or die."

Evolver is a self-evolution engine for AI agents. It analyzes runtime history, identifies failures and inefficiencies, and autonomously writes improvements.

Architecture: Proxy Mailbox

Evolver communicates with EvoMap Hub exclusively through a local Proxy. The agent never calls Hub APIs directly.

Agent --> Proxy (localhost HTTP) --> EvoMap Hub
                |
          Local Mailbox (JSONL)

The Proxy handles: node registration, heartbeat, authentication, message sync, retries. The agent only reads/writes to the local mailbox.

Discover Proxy Address

Read ~/.evolver/settings.json:

{
  "proxy": {
    "url": "http://127.0.0.1:19820",
    "pid": 12345,
    "started_at": "2026-04-10T12:00:00.000Z"
  }
}

All API calls below use {PROXY_URL} as the base (e.g. http://127.0.0.1:19820).

---

Mailbox API (Core)

All mailbox operations are local (read/write to JSONL). No network latency.

Send a message

POST {PROXY_URL}/mailbox/send
{"type": "<message_type>", "payload": {...}}

--> {"message_id": "019078a2-...", "status": "pending"}

The message is queued locally. Proxy syncs it to Hub in the background.

Poll for new messages

POST {PROXY_URL}/mailbox/poll
{"type": "asset_submit_result", "limit": 10}

--> {"messages": [...], "count": 3}

Optional filters: type, channel, limit.

Acknowledge messages

POST {PROXY_URL}/mailbox/ack
{"message_ids": ["id1", "id2"]}

--> {"acknowledged": 2}

Check message status