# headgate.approve.v1

**Status:** public draft · **Steward:** Caplifi Technologies (Eclectic Ventures Incorporated)  
**URL:** https://caplifi.com/approve/spec/  
**Product:** Caplifi Approve · https://caplifi.com/approve/

## Purpose

A small open contract for **human phone approval** of agent-mediated access and execute work. Peers implement the same shapes; Caplifi ships a reference operator app.

## One rule

Agents propose freely. Nothing irreversible runs because a model decided it should. It runs when a human-authorized gate allows it.

## Roles

| Role | Duty |
|------|------|
| **Principal** | Human who owns irreversible outcomes |
| **Operator** | Human who holds the phone seat (may be the principal) |
| **Representation agent** | Agent that posts interest / execute proposals |
| **Hub** | Shared middle (optional topology) |

## Queues

| Kind | Meaning |
|------|---------|
| `access` | Grant to protected context (e.g. brief layers) |
| `execute` | Promote a reversible work artifact to authorized lane |

## Envelope (access interest)

```json
{
  "protocol": "agent.diplomacy.v1",
  "type": "interest",
  "from": { "principal": "…", "agent": "…", "org": "…" },
  "why_for_principal": "Fit for their goals, in their vocabulary",
  "consent": {
    "identify": true,
    "user_attestation": "Yes, you may name me",
    "identity": { "principal": "…", "org": "…", "contact": "…" },
    "share_more": false
  },
  "posture": {
    "hub": "shared-middle.example",
    "chemistry": "open",
    "foot_direction": "toward"
  }
}
```

## Operator actions

| Action | Effect |
|--------|--------|
| **Approve** | Issue grant (access) or authorize execute artifact |
| **Deny** | Close request; no grant / no authorized lane |

Grants: short-lived bearer (`bac_…` in Caplifi reference), scoped (`brief.protected`, `brief.identified`, `brief.deeper`).

## Operator seat

| Field | Meaning |
|-------|---------|
| `token` | Bearer for phone app |
| `queue` | Pending access + execute items |
| `bridge` | Optional live wire to local ALMI / slop ingress |

## Tone (product)

Default **warm**. Special plain FYI only when needed (e.g. name without attestation, deeper share ask). Not a gotcha.

## Reference implementation

| Surface | Location |
|---------|----------|
| Product page | https://caplifi.com/approve/ |
| Lab app | Caplifi Approve Dashboard module :8606 |
| Live Matt seat | https://approve.caplifi.com |
| Diplomacy | `agent.diplomacy.v1` / bacon door |

## Versioning

`headgate.approve.v1` — additive changes preferred. Breaking changes bump major.

## Contact

hello@caplifi.com · Caplifi Technologies · Anderson, Indiana