Vapora/nickel/workflows/contracts.ncl
Jesús Pérez c5f4caa2ab
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

30 lines
728 B
Text

{
EngineConfig = {
max_parallel_tasks | Number,
workflow_timeout | Number,
approval_gates_enabled | Bool,
cedar_policy_dir | String | optional,
},
ScheduleConfig = {
cron | String,
timezone | String | optional,
allow_concurrent | Bool,
catch_up | Bool,
},
WorkflowNotifications = {
on_completed | Array String | default = [],
on_failed | Array String | default = [],
on_approval_required | Array String | default = [],
},
StageConfig = {
name | String,
agents | Array String,
parallel | Bool | default = false,
max_parallel | Number | optional,
approval_required | Bool | default = false,
compensation_agents | Array String | optional,
},
}