Vapora/nickel/agents/contracts.ncl

{
  RegistryConfig = {
    max_agents_per_role | Number,
    health_check_interval | Number,
    agent_timeout | Number,
  },

  AgentDefinition = {
    role | String,
    description | String,
    llm_provider | String,
    llm_model | String,
    parallelizable | Bool,
    priority | Number,
    capabilities | Array String,
    system_prompt | String | optional,
  },
}
feat(agents): stable identity + hot-reload for zero learning loss on config change Introduce stable_id = role on AgentMetadata so learning profiles and KG execution records survive process restarts and hot-reloads. Previously every Uuid::new_v4() rotation orphaned accumulated expertise. - registry: add stable_id field (serde default, backward-compatible), stable_id_or_role() fallback helper, drain_role(), list_roles() - coordinator: profile lookup and KG writes use stable_id_or_role() instead of the ephemeral UUID; drain_role() drops Sender to close mpsc channels after in-flight messages drain; registry_arc() accessor - executor: agent_id written to KG now uses stable_id_or_role() - server: reload_agents() drain-and-respawn function; SIGHUP handler via while sighup.recv().await.is_some(); POST /reload endpoint; AppState extended with config_path, router, cap_registry - fix: SIGHUP recv() spin-loop guard (is_some()) - fix: io_other_error clippy lint in vapora-agents, vapora-llm-router, vapora-workflow-engine (std::io::Error::other instead of Error::new) - docs: ADR-0040, CHANGELOG entry, README hot-reload section 2026-03-02 22:54:28 +00:00			`{`
			`RegistryConfig = {`
			`max_agents_per_role \| Number,`
			`health_check_interval \| Number,`
			`agent_timeout \| Number,`
			`},`

			`AgentDefinition = {`
			`role \| String,`
			`description \| String,`
			`llm_provider \| String,`
			`llm_model \| String,`
			`parallelizable \| Bool,`
			`priority \| Number,`
			`capabilities \| Array String,`
			`system_prompt \| String \| optional,`
			`},`
			`}`