mirror of
https://github.com/blackboxprogramming/lucidia.git
synced 2026-03-17 05:57:21 -05:00
Alexa Amundson
855585cb0e
Synced from BlackRoad-OS-Inc/blackroad-operator/orgs/personal/lucidia BlackRoad OS — Pave Tomorrow. RoadChain-SHA2048: fe729062952871e7 RoadChain-Identity: alexa@sovereign RoadChain-Full: fe729062952871e77147cf6d938b799096e87d9024d7005a14c9e209e12e8ad0c825b624c7bc649fc7eeb4c284fdcab8231af77980065cc04d9f36fca479ffc2346ed3c1b73de6f240d8f9485f47c995ad5b81142f7179b84932c67914dff1c08db039349ba28fca36cb57688093bf0199268dd1c2f3448c9383000bc77cc9663066ff57b834370afc8838b18466ea9029908018b961555cccaabf2ce21649cf3cabc7f64bdcc4abdf2da259b210c342835a2cecf92bdd3b4e109b4d6e622f6934e13b2b123607bd61ce3d0f20454c9ab594f9284cffe18716619c52db57ce5f4ee2856cb96e1fa3748fe1fe65435bec297c5ab3ab58d570ec1064aea29931dd
260 lines
6.8 KiB
Markdown
260 lines
6.8 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```json
|
|
{
|
|
"to": "lucidia",
|
|
"message": "What should we build next?",
|
|
"subject": "Optional subject line"
|
|
}
|
|
```
|
|
|
|
Response:
|
|
```json
|
|
{
|
|
"agent": { "name": "LUCIDIA", "email": "lucidia@blackroad.io", "emoji": "🌀" },
|
|
"reply": "...",
|
|
"model": "tinyllama"
|
|
}
|
|
```
|
|
|
|
### POST /broadcast
|
|
|
|
```json
|
|
{ "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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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.*
|