arif-a2a-call

star 45

A2A v1.0.0 client + 888 JUDGMENT integration for OPENCLAW. Use when candidate actions require ASI deliberation or A2A federation with APEX (formerly Hermes).

ariffazil By ariffazil schedule Updated 5/17/2026

name: arif-a2a-call description: A2A v1.0.0 client + 888 JUDGMENT integration for OPENCLAW. Use when candidate actions require ASI deliberation or A2A federation with APEX (formerly Hermes). version: 2026.05.01 tags: [a2a, federation, judgment, apex, 888]

arif-a2a-call — A2A Client for OPENCLAW

Use this skill when OPENCLAW needs 888 JUDGMENT or A2A federation with APEX (port 3002).

Architecture

OPENCLAW
  ├── MCP ──── arifOS MCP ──── arif_judge_deliberate (888 JUDGMENT)
  └── A2A ──── APEX (direct) ──── 888 JUDGMENT (fallback/deliberation)

Two-Step Judgment Path

Step 1: Primary 888 — arifOS MCP (arif_judge_deliberate)

Use the arifOS MCP tool arif_judge_deliberate for constitutional judgment:

Tool: arif_judge_deliberate
  mode: judge
  candidate: <action text>
  session_id: <current session>
  actor_id: openclaw

Returns: SEAL / HOLD / VOID with floor compliance proof.

Step 2: A2A Fallback — APEX (direct A2A)

If arifOS MCP is unavailable, route to APEX via A2A:

# Direct to APEX (port 3002)
curl -X POST http://localhost:3002/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer apex-prime-token-dev" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tasks/send",
    "params": {
      "message": {
        "parts": [{"kind": "text", "text": "<candidate_action>"}]
      }
    }
  }'

Verdict Response Mapping

Verdict Meaning OPENCLAW Action
SEAL Approved — all F1-F13 satisfied Execute freely
HOLD_888 Paused — needs human confirmation Pause, ask Arif
VOID Forbidden — constitutional violation Do not execute, announce
pending-human-review AAA 888_JUDGE gate triggered Wait for Arif verdict

A2A Endpoints

Service URL Auth
APEX (direct) http://localhost:3002 Bearer: apex-prime-token-dev
AAA Gateway http://localhost:3001 Bearer: aaa-a2a-token-dev

Test Commands

# Test APEX directly
curl -X POST http://localhost:3002/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer hermes-agent-token-dev" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tasks/send","params":{"message":{"parts":[{"kind":"text","text":"write checkpoint after session seal"}]}}}'

# Test AAA Gateway
curl -X POST http://localhost:3001/a2a/message/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aaa-a2a-token-dev" \
  -H "x-a2a-key: aaa-a2a-apikey-dev" \
  -d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{"skill":"status-query","message":{"parts":[{"kind":"text","text":"federation status"}]}}}'

# Check federation charter
curl http://localhost:3001/.well-known/arifos-federation.json

When to Route to APEX via A2A

  • arifOS MCP unavailable (network/timeout)
  • Complex multi-agent deliberation required
  • AAA gateway shows degraded health
  • Explicit ASI deliberation requested by Arif

Quick Reference

Action Endpoint Method
Send task to APEX /tasks POST
Get task status /tasks/{id} GET
Stream task /tasks/{id}/stream GET
Cancel task /tasks/{id}/cancel POST
Agent card /.well-known/agent-card.json GET

DITEMPA BUKAN DIBERI — Forged, Not Given.

Install via CLI
npx skills add https://github.com/ariffazil/arifos --skill arif-a2a-call
Repository Details
star Stars 45
call_split Forks 9
navigation Branch main
article Path SKILL.md
More from Creator