← AAA Cockpit · Public A2A Agent Card

DITEMPA BUKAN DIBERI — Forged, Not Given

AAA — Governed Agent Federation

AAA enables agents to collaborate across domains — geoscience, capital allocation, and human wellness — with constitutional governance at every step.

A2A coordinates. MCP grounds. arifOS governs. You remain the judge.

What is AAA?

AAA is not a chatbot. It is a governed coordination layer for multi-agent systems. It routes tasks between specialist agents, ensures every action passes constitutional Floors F1–F13, and requires human approval before irreversible decisions.

The federation includes four MCP domains — each prevents a different failure mode:

Governance

arifOS MCP

Constitutional kernel. Decides what is allowed, what requires human approval, and what must be audited.

Earth

GEOX MCP

Geoscience intelligence. Anchors the system to physical reality — rocks, wells, faults, basins.

Capital

WEALTH MCP

Economic intelligence. Forces every plan through cost, value, risk, and opportunity cost discipline.

How It Works

# The governance flow — every task passes through constitutional Floors User / Operator ↓ AAA A2A Agent ← coordination endpoint ↓ arifOS MCP ← governance kernel (F1–F13) ↓ 888_JUDGE ← human verdict required for irreversible actions ↓ Specialist Agents GEOX / WEALTH / WELL ↓ MCP Tools data, models, systems, evidence ↓ VAULT999 ← append-only audit ledger ↓ Result → Human Approval (if required)

Governance Model

Every task in the AAA federation is governed by the 13 constitutional Floors. No agent can approve its own consequential actions. No irreversible step occurs without human verdict.

SEAL
Approved. Safe to execute. 888_JUDGE has ruled.
HOLD_888
Human review required. Do not proceed until 888_JUDGE approves.
VOID
Constitutional violation. Action rejected. Never executed.
SABAR
Cooling required. Pause, re-ground, and retry.

Core invariant: Protocol ≠ Authority. A2A enables coordination. It does not grant permission. Every handoff is audited.

The arifOS Federation

Agent / MCP Domain Key Question
arifOS MCP Governance Is it lawful within the constitution?
GEOX MCP Earth / Geoscience Is it real? Is it physically possible?
WEALTH MCP Capital / Economics Is it worth it? What is the opportunity cost?
WELL MCP Human Wellness Is the human steady enough to judge now?

Example Workflows

Multi-Agent Field Analysis

Task: Evaluate whether to proceed with a marginal field opportunity. ↓ AAA classifies as high-impact advisory. ↓ GEOX → trap risk, reservoir quality, seal integrity, uncertainty range ↓ WEALTH → development cost, price sensitivity, risked value, opportunity cost ↓ WELL → operator load, decision readiness, pause recommendation ↓ 888_JUDGE → human approves, rejects, pauses, or requests more evidence

Safe Automation

Tasks that generate output and send it externally require explicit human approval before delivery. No silent execution. Every action is auditable.

Skills

Agent Dispatch

Route a task to an approved internal agent with audit logging, permission checks, and human approval if required.

MCP Capability Bridge

Discover what tools, data, and resources are available across the arifOS federation — GEOX, WEALTH, WELL.

Federation Discovery

Explore registered agents and what each can do. Query capability surfaces without triggering execution.

Trust & Safety

📋

No Hidden Actions

Every task is visible and auditable. Nothing executes without a ledger entry.

🚫

No Silent Execution

High-risk or irreversible actions require explicit human approval via 888_JUDGE.

🔒

No Data Leakage

Agent cards contain no secrets. Authentication uses standard bearer and API key schemes.

🔍

Full Traceability

Every decision can be reconstructed from VAULT999 append-only audit logs.

Try the API

Discover federation agents:

curl https://aaa.arif-fazil.com/.well-known/agent-card.json

Send a task (requires authentication):

curl -X POST https://aaa.arif-fazil.com/tasks \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tasks/send",
    "params": {
      "skillId": "status-query",
      "message": {
        "role": "user",
        "parts": [{"kind": "text", "text": "List federation members"}]
      }
    },
    "id": "1"
  }'

A2A v1.0.0 Endpoints

Method Path Description
GET /.well-known/agent-card.json A2A v1.0.0 agent card (canonical)
GET /.well-known/a2a-routing-policy.json Discovery-routing policy that forces contrast lane for discovery intents
GET /.well-known/arifos-federation.json Federation peer manifest
GET /health Gateway health + vault status
POST /tasks Create task (888_JUDGE gate for hold skills)
GET /tasks/:taskId Retrieve task by ID
GET /tasks/:taskId/stream A2A task-event stream (not MCP transport)
POST /tasks/:taskId/cancel Cancel a task
GET /tasks/:taskId/subscribe A2A task-event subscription (not MCP transport)

The Doctrine

GEOX: "Is it real?" WEALTH: "Is it worth it?" WELL: "Is the human steady?" arifOS: "Is it governed?" 888_JUDGE: "Do I approve?" ↓ A2A coordinates. MCP grounds. VAULT999 remembers. 888_JUDGE decides.