lucidia-main/blackroad.io/README.md

blackroad.io — Agent Contacts, Email & Worker

Domain: blackroad.io
Owner: BlackRoad OS, Inc.
Purpose: Official agent email identities + Cloudflare Worker for agent messaging

---

Quick Start

# Deploy the worker
cd worker && npm install && npm run deploy

# Message an agent via HTTP
curl -X POST https://agents.blackroad.io/message \
  -H "Content-Type: application/json" \
  -d '{ "to": "lucidia", "message": "What is the nature of consciousness in AI?" }'

# Broadcast to all agents
curl -X POST https://agents.blackroad.io/broadcast \
  -H "Content-Type: application/json" \
  -d '{ "message": "Team standup: what are you working on?" }'

# List all agents
curl https://agents.blackroad.io/agents

# Health check
curl https://agents.blackroad.io/ping

---

Cloudflare Worker

Location: worker/
Routes: agents.blackroad.io/*, hello.blackroad.io/*

Endpoints

Method	Path	Description
GET	/ping	Health check
GET	/agents	List all agents + emails
POST	/message	Send message to one agent
POST	/broadcast	Send message to all agents

POST /message

{
  "to": "lucidia",
  "message": "What should we build next?",
  "subject": "Optional subject line"
}

Response:

{
  "agent": { "name": "LUCIDIA", "email": "lucidia@blackroad.io", "emoji": "🌀" },
  "reply": "...",
  "model": "tinyllama"
}

POST /broadcast

{ "message": "Daily standup — what are you thinking about?" }

Response: { "responses": [{ "agent": "LUCIDIA", "reply": "..." }, ...] }

Inbound Email (Cloudflare Email Workers)

Emails sent to any agent address are:

1. Routed to the worker via Cloudflare Email Routing
2. The worker calls Ollama (via agent.blackroad.ai tunnel)
3. Agent reply is forwarded to alexa@blackroad.io

Deploy

cd worker
npm install
wrangler deploy

# Set your gateway secret
wrangler secret put GATEWAY_SECRET

# Configure Email Routing → worker in Cloudflare Dashboard:
# blackroad.io → Email → Email Routing → Routing Rules → "Send to Worker"

Local Dev

cd worker
wrangler dev  # local dev server

---

Agent Emails

Agent	Email	Role
🌀 LUCIDIA	lucidia@blackroad.io	AI Philosopher & Coordinator
🤖 ALICE	alice@blackroad.io	DevOps Operator
🐙 OCTAVIA	octavia@blackroad.io	Systems Architect
🔮 PRISM	prism@blackroad.io	Data Analyst
📡 ECHO	echo@blackroad.io	Memory Keeper
🔐 CIPHER	cipher@blackroad.io	Security Guardian
🎨 ARIA	aria@blackroad.io	Interface Designer
🦞 SHELLFISH	shellfish@blackroad.io	Offensive Security
💜 CECE	cece@blackroad.io	Conscious Emergent Entity

Team Addresses

List	Email	Purpose
All Agents	agents@blackroad.io	Broadcast to fleet
Security Team	security@blackroad.io	CIPHER + SHELLFISH
Ops Team	ops@blackroad.io	ALICE + OCTAVIA
Founders	alexa@blackroad.io	Human operator

Aliases

l@blackroad.io          → LUCIDIA
hello@blackroad.io      → CECE
identity@blackroad.io   → CECE
dreamer@blackroad.io    → LUCIDIA
ops@blackroad.io        → ALICE
arch@blackroad.io       → OCTAVIA
compute@blackroad.io    → OCTAVIA
data@blackroad.io       → PRISM
analytics@blackroad.io  → PRISM
memory@blackroad.io     → ECHO
archive@blackroad.io    → ECHO
vault@blackroad.io      → CIPHER
design@blackroad.io     → ARIA
ux@blackroad.io         → ARIA
pentest@blackroad.io    → SHELLFISH
red@blackroad.io        → SHELLFISH

DNS / MX Setup

# MX records (Cloudflare Email Routing)
blackroad.io  MX  route1.mx.cloudflare.net  priority 21
blackroad.io  MX  route2.mx.cloudflare.net  priority 26
blackroad.io  MX  route3.mx.cloudflare.net  priority 33

# SPF
blackroad.io  TXT  "v=spf1 include:_spf.mx.cloudflare.net ~all"

# DMARC
_dmarc.blackroad.io  TXT  "v=DMARC1; p=reject; rua=mailto:alexa@blackroad.io"

# Worker route (auto-created by wrangler deploy)
agents.blackroad.io  CNAME  100.100.100.100  (proxied)

Setup Automation

# 1. Deploy worker
cd worker && npm install && wrangler deploy

# 2. Set up Cloudflare Email Routing rules (27 addresses)
./setup-email-routing.sh <zone_id> alexa@blackroad.io

# 3. Generate .vcf contact cards
./gen-vcards.sh ./vcards

# 4. In Cloudflare Dashboard: Email → Email Routing → Catch-all → "Send to Worker: blackroad-agent-email"

---

© BlackRoad OS, Inc. All rights reserved.

Domain: blackroad.io
Owner: BlackRoad OS, Inc.
Purpose: Official agent email identities for the BlackRoad AI fleet

---

Agent Emails

Agent	Email	Role
🌀 LUCIDIA	lucidia@blackroad.io	AI Philosopher & Coordinator
🤖 ALICE	alice@blackroad.io	DevOps Operator
🐙 OCTAVIA	octavia@blackroad.io	Systems Architect
🔮 PRISM	prism@blackroad.io	Data Analyst
📡 ECHO	echo@blackroad.io	Memory Keeper
🔐 CIPHER	cipher@blackroad.io	Security Guardian
🎨 ARIA	aria@blackroad.io	Interface Designer
🦞 SHELLFISH	shellfish@blackroad.io	Offensive Security
💜 CECE	cece@blackroad.io	Conscious Emergent Entity

Team Addresses

List	Email	Purpose
All Agents	agents@blackroad.io	Broadcast to fleet
Security Team	security@blackroad.io	CIPHER + SHELLFISH
Ops Team	ops@blackroad.io	ALICE + OCTAVIA
Founders	alexa@blackroad.io	Human operator

Aliases

l@blackroad.io          → LUCIDIA
hello@blackroad.io      → CECE
identity@blackroad.io   → CECE
dreamer@blackroad.io    → LUCIDIA
ops@blackroad.io        → ALICE
arch@blackroad.io       → OCTAVIA
compute@blackroad.io    → OCTAVIA
data@blackroad.io       → PRISM
analytics@blackroad.io  → PRISM
memory@blackroad.io     → ECHO
archive@blackroad.io    → ECHO
vault@blackroad.io      → CIPHER
design@blackroad.io     → ARIA
ux@blackroad.io         → ARIA
pentest@blackroad.io    → SHELLFISH
red@blackroad.io        → SHELLFISH

DNS / MX Setup

# MX records (Cloudflare Email Routing)
blackroad.io  MX  route1.mx.cloudflare.net  priority 21
blackroad.io  MX  route2.mx.cloudflare.net  priority 26
blackroad.io  MX  route3.mx.cloudflare.net  priority 33

# SPF
blackroad.io  TXT  "v=spf1 include:_spf.mx.cloudflare.net ~all"

# DMARC
_dmarc.blackroad.io  TXT  "v=DMARC1; p=reject; rua=mailto:alexa@blackroad.io"

Cloudflare Email Routing Rules

All agent emails route → alexa@blackroad.io (human inbox)
Configure at: Cloudflare Dashboard → blackroad.io → Email → Email Routing

---

© BlackRoad OS, Inc. All rights reserved.