Skip to content

MACS Protocol v3.1 — Capability Routing, Review Chain, Escalation, Dead Agent Reaping

Choose a tag to compare

@Vdc-K Vdc-K released this 05 Mar 04:29
· 26 commits to main since this release

What's New in v3.1

3.1 Capability Routing

Tasks can now declare requires_capabilities. Only agents with matching capabilities can claim them. Auto-claim and swarm simulation are both capability-aware.

```bash
macs create "Train embedding model" --requires ml,gpu
macs boot --agent ml-agent --capabilities ml,gpu
```

3.10 Review Chain

Agents can request peer review before marking a task done.

```bash
macs review T-009 --agent lead-opus --result approved
macs review T-009 --agent lead-opus --result rejected --note "Missing error handling"
```

3.11 Escalation Protocol

When a task hits a human decision bottleneck, escalate it. Optionally auto-resume after a timeout.

```bash
macs escalate T-012 --reason "GDPR compliance sign-off" --to cto --timeout 60
```

3.12 Dead Agent Reaping

Agents that miss heartbeats are automatically marked dead and their tasks reassigned to pending.

```bash
macs reap --threshold 45 # agents silent > 45 min → dead, tasks → pending
```

Also Included

  • OpenClaw adapter (adapters/openclaw/)
  • 12-task SaaS demo (demo/setup.sh + demo/run.sh)
  • 111 integration tests (0 failed)
  • Forced handoff, task decomposition, drift detection, swarm orchestration

Install

```bash
npm install -g macs-protocol
macs init "My Project"
macs swarm --agents "lead:architect|eng1:backend|eng2:frontend|qa:testing" --simulate
```