mirror of
https://github.com/blackboxprogramming/lucidia.git
synced 2026-03-17 07:57:19 -05:00
sync: update from blackroad-operator 2026-03-14
Synced from BlackRoad-OS-Inc/blackroad-operator/orgs/personal/lucidia BlackRoad OS — Pave Tomorrow. RoadChain-SHA2048: fe729062952871e7 RoadChain-Identity: alexa@sovereign RoadChain-Full: fe729062952871e77147cf6d938b799096e87d9024d7005a14c9e209e12e8ad0c825b624c7bc649fc7eeb4c284fdcab8231af77980065cc04d9f36fca479ffc2346ed3c1b73de6f240d8f9485f47c995ad5b81142f7179b84932c67914dff1c08db039349ba28fca36cb57688093bf0199268dd1c2f3448c9383000bc77cc9663066ff57b834370afc8838b18466ea9029908018b961555cccaabf2ce21649cf3cabc7f64bdcc4abdf2da259b210c342835a2cecf92bdd3b4e109b4d6e622f6934e13b2b123607bd61ce3d0f20454c9ab594f9284cffe18716619c52db57ce5f4ee2856cb96e1fa3748fe1fe65435bec297c5ab3ab58d570ec1064aea29931dd
This commit is contained in:
259
blackroad.io/README.md
Normal file
259
blackroad.io/README.md
Normal file
@@ -0,0 +1,259 @@
|
||||
# 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.*
|
||||
Reference in New Issue
Block a user