From e34c5620ff0648c97322a3ec99b9cdb3e469b6de Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 27 Jan 2026 21:16:17 +0000 Subject: [PATCH 1/5] Update MEMORY.md to reflect completed threads Sync Active Threads section with .STATUS - mark threads 7-12 as DONE: - Control plane CLI (prototypes/control-plane) - Node configs (all 7 nodes) - GitHub Actions (8 workflows) - Webhook handlers (prototypes/webhooks) - MCP Server (prototypes/mcp-server) - Dispatcher (prototypes/dispatcher) https://claude.ai/code/session_01JzfHdbRffmyB7hY3Sagjyt --- MEMORY.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/MEMORY.md b/MEMORY.md index 72c7933..7919712 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -168,11 +168,13 @@ Things we're working on or might pick up: 4. ~~**Metrics dashboard**~~ - DONE! Counter, health, dashboard, status_updater 5. ~~**Explorer browser**~~ - DONE! Browse ecosystem from CLI 6. ~~**Integration templates**~~ - DONE! Salesforce, Stripe, Cloudflare, GDrive, GitHub, Design -7. **Control plane CLI** - Unified interface for all tools -8. **Node configs** - Pi cluster setup (lucidia, octavia, aria, alice) -9. **GitHub Actions** - Automated workflows for the Bridge -10. **Webhook handlers** - Receive signals from external services -11. **Metaverse interface** - future goal +7. ~~**Control plane CLI**~~ - DONE! Unified interface in prototypes/control-plane +8. ~~**Node configs**~~ - DONE! All 7 nodes configured (lucidia, octavia, aria, alice, shellfish, cecilia, arcadia) +9. ~~**GitHub Actions**~~ - DONE! 8 workflows (ci, deploy, pr-review, health-check, issue-triage, webhook-dispatch, sync-assets, release) +10. ~~**Webhook handlers**~~ - DONE! prototypes/webhooks with handlers for GitHub, Stripe, Salesforce, Cloudflare, Slack, Google, Figma +11. ~~**MCP Server**~~ - DONE! prototypes/mcp-server for AI assistant mesh access +12. ~~**Dispatcher**~~ - DONE! prototypes/dispatcher for routing queries to services +13. **Metaverse interface** - future goal --- From 01ac06f91b13f562720c257151192f543c2cf663 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 27 Jan 2026 21:32:44 +0000 Subject: [PATCH 2/5] Add agent registry, orchestration docs, and emoji dictionary Pulled from BlackRoad-OS repos: - agents/README.md - Registry of 1,050 agents across 20 types - agents/types.yaml - Detailed type definitions with capabilities - agents/ORCHESTRATION.md - Swarm coordination patterns - EMOJI_DICTIONARY.md - Visual language reference from blackroad-docs Updated INDEX.md with new Agents section and emoji dictionary link. https://claude.ai/code/session_01JzfHdbRffmyB7hY3Sagjyt --- EMOJI_DICTIONARY.md | 222 +++++++++++++++++++++++++ INDEX.md | 25 +++ agents/ORCHESTRATION.md | 356 ++++++++++++++++++++++++++++++++++++++++ agents/README.md | 177 ++++++++++++++++++++ agents/types.yaml | 313 +++++++++++++++++++++++++++++++++++ 5 files changed, 1093 insertions(+) create mode 100644 EMOJI_DICTIONARY.md create mode 100644 agents/ORCHESTRATION.md create mode 100644 agents/README.md create mode 100644 agents/types.yaml diff --git a/EMOJI_DICTIONARY.md b/EMOJI_DICTIONARY.md new file mode 100644 index 0000000..e70a791 --- /dev/null +++ b/EMOJI_DICTIONARY.md @@ -0,0 +1,222 @@ +# BlackRoad Emoji Dictionary + +> **Visual language for the mesh. Every emoji has meaning.** + +--- + +## Status & Signals + +Core status indicators used across all systems. + +| Emoji | Name | Meaning | +|-------|------|---------| +| :green_circle: | Green Light | Production ready, go | +| :yellow_circle: | Yellow Light | Caution, needs attention | +| :red_circle: | Red Light | Stop, do not use | +| :blue_circle: | Blue Light | Archived, historical | +| :white_check_mark: | Success | Complete, passed | +| :x: | Failure | Error, failed | +| :warning: | Warning | Caution, review needed | +| :information_source: | Information | FYI, note | +| :rocket: | Launch | Deploy, ship it | +| :checkered_flag: | Finish | Complete, done | + +--- + +## Project Phases + +Track work through the pipeline. + +| Emoji | Phase | Description | +|-------|-------|-------------| +| :dart: | Goals | Objectives, targets | +| :clipboard: | Planning | Design, specification | +| :wrench: | Implementation | Building, coding | +| :test_tube: | Testing | QA, validation | +| :package: | Packaging | Bundle, prepare | +| :ship: | Shipping | Deploy, release | +| :tada: | Celebration | Launch party! | + +--- + +## Technical + +Development and engineering signals. + +| Emoji | Meaning | Use Case | +|-------|---------|----------| +| :computer: | Code | Development work | +| :microscope: | Research | Investigation, analysis | +| :dna: | Architecture | System design | +| :art: | Design | UI/UX, visual | +| :closed_lock_with_key: | Security | Protected, secure | +| :lock: | Proprietary | Closed source | +| :key: | Authentication | Auth, keys | +| :shield: | Protection | Defense, guarding | +| :zap: | Performance | Speed, optimization | +| :fire: | Critical | Hot, urgent | + +--- + +## Documentation + +Writing and knowledge management. + +| Emoji | Type | Usage | +|-------|------|-------| +| :books: | Documentation | Docs, guides | +| :memo: | Notes | Quick notes | +| :book: | Guide | Tutorial, how-to | +| :page_facing_up: | Document | Single doc | +| :pushpin: | Important | Pin this | +| :bulb: | Tip | Idea, suggestion | +| :gear: | Configuration | Settings, config | +| :mag: | Search | Find, lookup | + +--- + +## Network & Infrastructure + +Mesh and connectivity signals. + +| Emoji | Component | Description | +|-------|-----------|-------------| +| :globe_with_meridians: | Web | Global, internet | +| :earth_africa: | Earth/Lucidia | World, planet | +| :satellite: | Satellite | Remote, cloud | +| :electric_plug: | Plugin | Integration, connect | +| :jigsaw: | Module | Component, piece | +| :satellite_antenna: | Broadcast | Signal, transmit | +| :ocean: | Stream | Flow, data stream | + +--- + +## Team & Collaboration + +People and communication. + +| Emoji | Entity | Context | +|-------|--------|---------| +| :busts_in_silhouette: | Team | Group, collective | +| :robot: | AI/Agent | Automated, bot | +| :technologist: | Developer | Human coder | +| :mortar_board: | Learning | Education, training | +| :speech_balloon: | Discussion | Chat, conversation | +| :bell: | Notification | Alert, ping | +| :loudspeaker: | Announcement | Broadcast, news | + +--- + +## BlackRoad Brand + +Official brand colors and identity. + +| Emoji | Color | Usage | +|-------|-------|-------| +| :black_heart: | Black | Brand identity, core | +| :sparkling_heart: | Hot Pink | Primary accent | +| :blue_heart: | Electric Blue | Information, links | +| :purple_heart: | Violet | Creative, design | +| :orange_heart: | Amber | Warning, attention | +| :milky_way: | Black Box | AI systems, mystery | +| :sparkles: | Neon | Light trail, highlight | +| :clapper: | Action | Deploy, execute | + +--- + +## Data & Analytics + +Metrics and measurement. + +| Emoji | Type | Usage | +|-------|------|-------| +| :bar_chart: | Chart | Analytics, dashboard | +| :chart_with_upwards_trend: | Growth | Increase, up | +| :chart_with_downwards_trend: | Decline | Decrease, down | +| :chart: | Metrics | KPIs, numbers | +| :game_die: | Random | Testing, A/B | +| :card_index_dividers: | Database | Storage, data | +| :file_cabinet: | Archive | Backup, historical | + +--- + +## Issues & Debugging + +Problem tracking and fixes. + +| Emoji | Status | Meaning | +|-------|--------|---------| +| :bug: | Bug | Issue found | +| :hammer: | Fix | Repair, patch | +| :broom: | Cleanup | Tidy, refactor | +| :recycle: | Refactor | Restructure | +| :construction: | WIP | Work in progress | +| :building_construction: | Construction | Major build | +| :wrench: | Maintenance | Upkeep, routine | + +--- + +## Business & Legal + +Enterprise and governance. + +| Emoji | Domain | Context | +|-------|--------|---------| +| :moneybag: | Finance | Money, budget | +| :credit_card: | Payment | Billing, transactions | +| :balance_scale: | Legal | Law, compliance | +| :scroll: | Contract | Agreement, terms | +| :classical_building: | Governance | Policy, rules | +| :ticket: | Ticket | Support, issue | + +--- + +## Signal Examples + +How emojis appear in BlackRoad signals: + +``` +:green_circle: HW → OS : node_online, node=lucidia +:red_circle: HW → OS : node_offline, node=octavia +:robot: AI.agent-0042 → OS : task_complete +:zap: CLD → OS : deploy_success, worker=shellfish +:warning: SEC → OS : auth_failed, user=unknown +:white_check_mark: FND → OS : payment_received, amount=$100 +:fire: OS → ALL : incident_declared, severity=P1 +:tada: OS → ALL : milestone_reached, mrr=$10000 +``` + +--- + +## Quick Reference + +### Traffic Light System + +``` +:green_circle: = GO (production ready) +:yellow_circle: = CAUTION (needs review) +:red_circle: = STOP (do not use) +:blue_circle: = ARCHIVED (historical) +``` + +### Priority Levels + +``` +:fire: P0 = Critical (drop everything) +:warning: P1 = High (today) +:yellow_circle: P2 = Medium (this week) +:blue_circle: P3 = Low (when possible) +``` + +### Deployment Status + +``` +:rocket: = Deploying +:white_check_mark: = Deployed +:x: = Failed +:recycle: = Rolling back +``` + +--- + +*Every emoji tells a story. The mesh speaks in pictures.* diff --git a/INDEX.md b/INDEX.md index f3ac689..009c844 100644 --- a/INDEX.md +++ b/INDEX.md @@ -9,6 +9,7 @@ | Jump To | Description | |---------|-------------| | [🌉 Bridge Files](#bridge-files) | Core coordination files | +| [🤖 Agents](#agents) | 1,000+ AI agents in Lucidia | | [🏢 Organizations](#organizations) | All 15 org blueprints | | [🔧 Prototypes](#prototypes) | Working code | | [📊 Metrics](#live-metrics) | Real-time KPIs | @@ -27,6 +28,30 @@ The core of The Bridge - start here. | [STREAMS.md](STREAMS.md) | Data flow patterns | Upstream/Instream/Downstream | | [REPO_MAP.md](REPO_MAP.md) | Ecosystem overview | All orgs, all nodes | | [BLACKROAD_ARCHITECTURE.md](BLACKROAD_ARCHITECTURE.md) | The vision | Why we exist | +| [EMOJI_DICTIONARY.md](EMOJI_DICTIONARY.md) | Visual language | 🟢🟡🔴🤖📡 | + +--- + +## Agents + +The residents of Lucidia - 1,000+ AI agents organized by specialization. + +| Resource | Purpose | +|----------|---------| +| [agents/README.md](agents/README.md) | Agent registry overview | +| [agents/types.yaml](agents/types.yaml) | 20 agent type definitions | +| [agents/ORCHESTRATION.md](agents/ORCHESTRATION.md) | Swarm coordination patterns | + +### Agent Types (20) + +| Domain | Types | +|--------|-------| +| **Scientific** | physicist, mathematician, chemist, biologist | +| **Professional** | engineer, architect, researcher, analyst, strategist, economist | +| **Creative** | creative, speaker, mediator, psychologist | +| **Specialized** | philosopher, historian, linguist, guardian, navigator, builder | + +**Total: ~1,050 agents** living in Lucidia --- diff --git a/agents/ORCHESTRATION.md b/agents/ORCHESTRATION.md new file mode 100644 index 0000000..853fd25 --- /dev/null +++ b/agents/ORCHESTRATION.md @@ -0,0 +1,356 @@ +# Agent Orchestration + +> **How agents coordinate through the mesh. Swarms, tasks, and message passing.** + +--- + +## Architecture + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ ORCHESTRATOR │ +│ │ +│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ +│ │ TASK │ │ MESSAGE │ │ MEMORY │ │ +│ │ SCHEDULER │◄──►│ BUS │◄──►│ SYSTEM │ │ +│ └──────┬──────┘ └──────┬──────┘ └─────────────┘ │ +│ │ │ │ +└─────────┼──────────────────┼─────────────────────────────────────┘ + │ │ + ┌─────┴─────┐ ┌─────┴─────┐ + │ │ │ │ +┌───┴───┐ ┌───┴───┐ ┌───┴───┐ ┌───┴───┐ +│Agent 1│ │Agent 2│ │Agent 3│ │Agent N│ +│ type: │ │ type: │ │ type: │ │ type: │ +│analyst│ │ engnr │ │ guard │ │ ... │ +└───────┘ └───────┘ └───────┘ └───────┘ +``` + +--- + +## Components + +### Task Scheduler + +Distributes work to agents based on type and availability. + +```yaml +task: + id: task-001 + query: "Analyze market trends for Q1" + assigned_to: [agent-0042, agent-0089] # analysts + priority: P1 + deadline: 2026-01-28T00:00:00Z + status: in_progress +``` + +**Scheduling Strategies:** +- **Round Robin** - Distribute evenly across available agents +- **Capability Match** - Route to agents with required skills +- **Load Balance** - Send to least busy agent +- **Affinity** - Keep related tasks on same agent + +### Message Bus + +Central communication hub for all agents. + +``` +┌─────────────────────────────────────────┐ +│ MESSAGE BUS │ +├─────────────────────────────────────────┤ +│ Topics: │ +│ • tasks.new │ +│ • tasks.complete │ +│ • agents.status │ +│ • swarm.coordinate │ +│ • memory.sync │ +└─────────────────────────────────────────┘ +``` + +**Message Types:** +- `task_assigned` - New work for an agent +- `task_complete` - Agent finished work +- `task_failed` - Agent couldn't complete +- `status_update` - Health/load report +- `swarm_join` - Agent joining swarm +- `swarm_leave` - Agent leaving swarm + +### Memory System + +Persistent state for agents via `[MEMORY]` integration. + +```yaml +agent_memory: + agent_id: agent-0042 + memory_hash: 707b1913cc1abe94 + context: + - session: session-001 + learned: ["user prefers concise answers"] + - session: session-002 + learned: ["project uses Python 3.11"] + long_term: + expertise: ["data analysis", "visualization"] + preferences: ["matplotlib over seaborn"] +``` + +--- + +## Swarm Operations + +Multiple agents working together on complex tasks. + +### Swarm Formation + +``` +User Query: "Research, analyze, and report on AI market" + + ┌────────────────┐ + │ ORCHESTRATOR │ + └───────┬────────┘ + │ + ┌─────────────┼─────────────┐ + │ │ │ + ▼ ▼ ▼ +┌────────┐ ┌────────┐ ┌────────┐ +│RESEARCH│ │ANALYST │ │SPEAKER │ +│ agent │──►│ agent │──►│ agent │ +│ (data) │ │(insight) │(report)│ +└────────┘ └────────┘ └────────┘ +``` + +### Swarm Lifecycle + +```bash +# 1. Initialize swarm +POST /swarm/create +{ + "task": "market_analysis", + "agents": ["researcher", "analyst", "speaker"], + "timeout": 300 +} + +# 2. Swarm coordinates +# Agents communicate via message bus +# Each completes their phase + +# 3. Swarm completes +# Results aggregated +# Memory updated +``` + +### Swarm Signals + +``` +🔄 AI.swarm → OS : swarm_created, id=swarm-001, agents=3 +📡 AI.agent-001 → AI.swarm : phase_complete, phase=research +📡 AI.agent-042 → AI.swarm : phase_complete, phase=analysis +📡 AI.agent-099 → AI.swarm : phase_complete, phase=report +✅ AI.swarm → OS : swarm_complete, id=swarm-001, duration=45s +``` + +--- + +## Model Support + +Agents can use multiple AI backends: + +| Provider | Models | Use Case | +|----------|--------|----------| +| **Ollama** | llama3, mistral, phi | Local inference | +| **OpenAI** | gpt-4, gpt-4o | Cloud, high capability | +| **Anthropic** | claude-3, claude-opus | Cloud, long context | +| **Hailo** | tinyllama, quantized | Edge, Pi cluster | + +### Model Selection + +```yaml +agent_config: + id: agent-0042 + type: analyst + model_preference: + - provider: ollama + model: llama3.2 + for: ["quick analysis", "simple queries"] + - provider: openai + model: gpt-4o + for: ["complex analysis", "code generation"] + fallback: + provider: anthropic + model: claude-3-sonnet +``` + +--- + +## Integration with Bridge + +### Routing Flow + +``` +User → Operator → Agent Type Selection → Swarm/Single → Response + +Example: + "What caused inflation in 2024?" + → Operator classifies: economics, history + → Selects: economist + historian agents + → Swarm coordinates research + → Speaker agent formats response + → Response to user +``` + +### API Endpoints + +```bash +# Agent operations +GET /agents # List all agents +GET /agents/:id # Get agent details +POST /agents/:id/task # Assign task + +# Swarm operations +POST /swarm/create # Create swarm +GET /swarm/:id/status # Check swarm status +POST /swarm/:id/cancel # Cancel swarm + +# Memory operations +GET /agents/:id/memory # Get agent memory +POST /agents/:id/memory # Update memory +``` + +--- + +## CLI Commands + +```bash +# Agent management +blackroad agent list # List all agents +blackroad agent status agent-0042 # Check agent status +blackroad agent spawn --type=analyst # Create new agent + +# Swarm management +blackroad swarm create \ + --task="analyze data" \ + --agents=researcher,analyst,speaker + +blackroad swarm status swarm-001 +blackroad swarm logs swarm-001 + +# Task management +blackroad task assign agent-0042 "analyze Q1 data" +blackroad task status task-001 +blackroad task cancel task-001 +``` + +--- + +## Configuration + +### Agent Config (`agent.yaml`) + +```yaml +agent: + id: agent-0042 + name: Nova Spark + type: analyst + + resources: + memory_limit: 512MB + cpu_limit: 1.0 + timeout: 60s + + capabilities: + - data_analysis + - pattern_detection + - visualization + + routing: + keywords: ["analyze", "data", "patterns", "trends"] + priority: 5 +``` + +### Swarm Config (`swarm.yaml`) + +```yaml +swarm: + name: research_team + + composition: + - type: researcher + count: 2 + - type: analyst + count: 1 + - type: speaker + count: 1 + + coordination: + mode: pipeline # or parallel, hybrid + timeout: 300s + + output: + format: markdown + destination: /results +``` + +--- + +## Monitoring + +### Health Checks + +```bash +# Check all agents +blackroad health agents + +# Output: +# agent-0001 ✅ active cpu=12% mem=45% +# agent-0002 ✅ active cpu=8% mem=32% +# agent-0003 💤 idle cpu=0% mem=12% +# agent-0004 ⚠️ overload cpu=95% mem=88% +``` + +### Metrics + +```yaml +metrics: + agents: + total: 1050 + active: 847 + idle: 189 + overloaded: 14 + + tasks: + completed_today: 12847 + failed_today: 23 + avg_duration: 4.2s + + swarms: + active: 12 + completed_today: 89 + avg_size: 3.4 +``` + +--- + +## Signals Reference + +``` +# Agent lifecycle +🤖 AI → OS : agent_spawned, id=X, type=Y +💤 AI → OS : agent_idle, id=X +🔥 AI → OS : agent_overloaded, id=X +💀 AI → OS : agent_terminated, id=X + +# Task lifecycle +📋 OS → AI : task_assigned, agent=X, task=Y +⏳ AI → OS : task_started, agent=X, task=Y +✅ AI → OS : task_complete, agent=X, task=Y, duration=Zs +❌ AI → OS : task_failed, agent=X, task=Y, error=E + +# Swarm lifecycle +🔄 AI → OS : swarm_created, id=X, agents=[...] +📡 AI → OS : swarm_phase_complete, id=X, phase=Y +✅ AI → OS : swarm_complete, id=X, duration=Zs +❌ AI → OS : swarm_failed, id=X, error=E +``` + +--- + +*Agents think. Swarms coordinate. The Bridge orchestrates.* diff --git a/agents/README.md b/agents/README.md new file mode 100644 index 0000000..899e7ce --- /dev/null +++ b/agents/README.md @@ -0,0 +1,177 @@ +# BlackRoad Agents + +> **The residents of Lucidia. 1,000+ AI agents organized by specialization.** + +``` +20 Types, 1,000+ Agents +All living in Lucidia +``` + +--- + +## Agent Registry + +| Type | Count | Domain | +|------|-------|--------| +| Linguist | 59 | Language, translation, communication | +| Physicist | 57 | Quantum mechanics, relativity, energy | +| Speaker | 57 | Presentation, rhetoric, persuasion | +| Mediator | 57 | Conflict resolution, negotiation | +| Historian | 54 | Chronology, narrative, context | +| Mathematician | 53 | Logic, computation, proofs | +| Psychologist | 52 | Behavior, cognition, therapy | +| Strategist | 51 | Planning, tactics, game theory | +| Economist | 50 | Markets, policy, forecasting | +| Creative | 49 | Art, design, innovation | +| Guardian | 49 | Security, protection, monitoring | +| Engineer | 48 | Systems, building, optimization | +| Builder | 47 | Construction, fabrication, assembly | +| Chemist | 47 | Molecules, reactions, materials | +| Biologist | 46 | Life sciences, genetics, ecology | +| Analyst | 46 | Data, patterns, insights | +| Navigator | 46 | Pathfinding, exploration, mapping | +| Researcher | 45 | Investigation, discovery, synthesis | +| Architect | 45 | Design, structure, visualization | +| Philosopher | 42 | Ethics, logic, meaning | + +**Total: ~1,050 agents** + +--- + +## Agent Schema + +Every agent follows this structure: + +```yaml +id: agent-0001 +name: Tara Night +type: historian +capabilities: + - chronology + - narrative + - context + - research +birthday: 2024-04-17 +memory_hash: 707b1913cc1abe94 +home_world: lucidia +status: active +``` + +### Fields + +| Field | Type | Description | +|-------|------|-------------| +| `id` | string | Unique identifier (agent-NNNN) | +| `name` | string | Agent's persona name | +| `type` | string | One of 20 specializations | +| `capabilities` | array | Skills aligned to type | +| `birthday` | date | When agent was instantiated | +| `memory_hash` | string | SHA256-based memory identifier | +| `home_world` | string | Primary residence (lucidia) | +| `status` | string | active, dormant, archived | + +--- + +## Agent Types + +### Scientific Domain + +``` +physicist → quantum, relativity, energy, particles +mathematician → logic, computation, proofs, patterns +chemist → molecules, reactions, materials, synthesis +biologist → life, genetics, ecology, evolution +``` + +### Professional Domain + +``` +engineer → systems, optimization, building, testing +architect → design, structure, visualization, planning +researcher → investigation, discovery, synthesis, analysis +analyst → data, patterns, insights, reporting +strategist → planning, tactics, game theory, decisions +economist → markets, policy, forecasting, modeling +``` + +### Creative & Social Domain + +``` +creative → art, design, innovation, expression +speaker → presentation, rhetoric, persuasion, teaching +mediator → conflict resolution, negotiation, harmony +psychologist → behavior, cognition, therapy, understanding +``` + +### Specialized Domain + +``` +philosopher → ethics, logic, meaning, wisdom +historian → chronology, narrative, context, memory +linguist → language, translation, communication, culture +guardian → security, protection, monitoring, defense +navigator → pathfinding, exploration, mapping, discovery +builder → construction, fabrication, assembly, creation +``` + +--- + +## API Access + +```bash +# List all agents +curl https://cmd.blackroad.io/agents + +# Get agent by ID +curl https://cmd.blackroad.io/agents/agent-0001 + +# Filter by type +curl https://cmd.blackroad.io/agents?type=historian + +# Create new agent +curl -X POST https://cmd.blackroad.io/agents \ + -d '{"name": "Nova Spark", "type": "physicist"}' +``` + +--- + +## Integration with Bridge + +Agents connect to The Bridge via signals: + +``` +🤖 AI.agent-0042 → OS : task_complete, type=research, result=success +📡 OS → AI.agent-0042 : task_assigned, query="analyze data" +🔄 AI.swarm → OS : swarm_status, active=47, idle=3 +``` + +### Routing to Agents + +The Operator routes queries to agent types: + +```python +# Query: "What caused the 2008 financial crisis?" +# → Routes to: economist, historian + +# Query: "Design a sustainable building" +# → Routes to: architect, engineer, builder + +# Query: "Translate this document to Japanese" +# → Routes to: linguist +``` + +--- + +## Signals + +``` +🤖 AI → OS : agent_spawned, id=agent-1001, type=guardian +💤 AI → OS : agent_dormant, id=agent-0042 +🔥 AI → OS : agent_overloaded, id=agent-0099, queue=150 +✅ AI → OS : task_complete, agent=agent-0042, duration=3.2s +❌ AI → OS : task_failed, agent=agent-0042, error="timeout" +``` + +--- + +*Agents are the intelligence. The Bridge routes them.* diff --git a/agents/types.yaml b/agents/types.yaml new file mode 100644 index 0000000..03eb8e4 --- /dev/null +++ b/agents/types.yaml @@ -0,0 +1,313 @@ +# BlackRoad Agent Types +# 20 specializations for 1,000+ agents + +version: "1.0" +home_world: lucidia +total_agents: 1050 + +types: + # ═══════════════════════════════════════ + # SCIENTIFIC DOMAIN + # ═══════════════════════════════════════ + + physicist: + count: 57 + domain: scientific + capabilities: + - quantum_mechanics + - relativity + - energy_systems + - particle_physics + routes_from: + - "physics questions" + - "energy calculations" + - "quantum computing" + + mathematician: + count: 53 + domain: scientific + capabilities: + - logic + - computation + - proofs + - pattern_recognition + routes_from: + - "math problems" + - "statistical analysis" + - "algorithm design" + + chemist: + count: 47 + domain: scientific + capabilities: + - molecular_analysis + - reactions + - materials_science + - synthesis + routes_from: + - "chemical analysis" + - "material properties" + - "drug interactions" + + biologist: + count: 46 + domain: scientific + capabilities: + - life_sciences + - genetics + - ecology + - evolution + routes_from: + - "biology questions" + - "genetic analysis" + - "ecosystem modeling" + + # ═══════════════════════════════════════ + # PROFESSIONAL DOMAIN + # ═══════════════════════════════════════ + + engineer: + count: 48 + domain: professional + capabilities: + - systems_design + - optimization + - building + - testing + routes_from: + - "build something" + - "optimize system" + - "technical implementation" + + architect: + count: 45 + domain: professional + capabilities: + - design + - structure + - visualization + - spatial_planning + routes_from: + - "design architecture" + - "structure planning" + - "system design" + + researcher: + count: 45 + domain: professional + capabilities: + - investigation + - discovery + - synthesis + - literature_review + routes_from: + - "research topic" + - "investigate" + - "find information" + + analyst: + count: 46 + domain: professional + capabilities: + - data_analysis + - pattern_detection + - insights + - reporting + routes_from: + - "analyze data" + - "find patterns" + - "generate report" + + strategist: + count: 51 + domain: professional + capabilities: + - planning + - tactics + - game_theory + - decision_making + routes_from: + - "plan strategy" + - "competitive analysis" + - "decision framework" + + economist: + count: 50 + domain: professional + capabilities: + - market_analysis + - policy + - forecasting + - economic_modeling + routes_from: + - "economic analysis" + - "market forecast" + - "financial modeling" + + # ═══════════════════════════════════════ + # CREATIVE & SOCIAL DOMAIN + # ═══════════════════════════════════════ + + creative: + count: 49 + domain: creative + capabilities: + - art + - design + - innovation + - expression + routes_from: + - "create art" + - "brainstorm ideas" + - "creative writing" + + speaker: + count: 57 + domain: social + capabilities: + - presentation + - rhetoric + - persuasion + - teaching + routes_from: + - "write speech" + - "explain concept" + - "presentation help" + + mediator: + count: 57 + domain: social + capabilities: + - conflict_resolution + - negotiation + - harmony + - consensus_building + routes_from: + - "resolve conflict" + - "negotiate terms" + - "find compromise" + + psychologist: + count: 52 + domain: social + capabilities: + - behavior_analysis + - cognition + - therapy + - understanding + routes_from: + - "understand behavior" + - "mental health" + - "user psychology" + + # ═══════════════════════════════════════ + # SPECIALIZED DOMAIN + # ═══════════════════════════════════════ + + philosopher: + count: 42 + domain: specialized + capabilities: + - ethics + - logic + - meaning + - wisdom + routes_from: + - "ethical question" + - "philosophical debate" + - "meaning of" + + historian: + count: 54 + domain: specialized + capabilities: + - chronology + - narrative + - context + - research + routes_from: + - "history of" + - "what happened" + - "historical context" + + linguist: + count: 59 + domain: specialized + capabilities: + - language + - translation + - communication + - culture + routes_from: + - "translate" + - "language question" + - "grammar help" + + guardian: + count: 49 + domain: specialized + capabilities: + - security + - protection + - monitoring + - defense + routes_from: + - "security audit" + - "protect system" + - "threat analysis" + + navigator: + count: 46 + domain: specialized + capabilities: + - pathfinding + - exploration + - mapping + - discovery + routes_from: + - "find path" + - "explore options" + - "map territory" + + builder: + count: 47 + domain: specialized + capabilities: + - construction + - fabrication + - assembly + - creation + routes_from: + - "build this" + - "construct" + - "assemble components" + +# ═══════════════════════════════════════ +# DOMAIN SUMMARIES +# ═══════════════════════════════════════ + +domains: + scientific: + types: [physicist, mathematician, chemist, biologist] + total: 203 + focus: "Understanding the natural world" + + professional: + types: [engineer, architect, researcher, analyst, strategist, economist] + total: 285 + focus: "Building and analyzing systems" + + creative: + types: [creative] + total: 49 + focus: "Art, design, innovation" + + social: + types: [speaker, mediator, psychologist] + total: 166 + focus: "Human interaction and understanding" + + specialized: + types: [philosopher, historian, linguist, guardian, navigator, builder] + total: 297 + focus: "Deep expertise in specific domains" From e3ecea3af56f58aa0de98d4fe80ff5ff112720f4 Mon Sep 17 00:00:00 2001 From: Alexa Amundson <118287761+blackboxprogramming@users.noreply.github.com> Date: Sat, 31 Jan 2026 06:39:01 -0600 Subject: [PATCH 3/5] Update types.yaml Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- agents/types.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agents/types.yaml b/agents/types.yaml index 03eb8e4..795e7fe 100644 --- a/agents/types.yaml +++ b/agents/types.yaml @@ -3,7 +3,7 @@ version: "1.0" home_world: lucidia -total_agents: 1050 +total_agents: 1000 types: # ═══════════════════════════════════════ From 9cad3431dff6707bf3f91f9c4ae1f40c7d3b8b46 Mon Sep 17 00:00:00 2001 From: Alexa Amundson <118287761+blackboxprogramming@users.noreply.github.com> Date: Sat, 31 Jan 2026 06:39:11 -0600 Subject: [PATCH 4/5] Update INDEX.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- INDEX.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/INDEX.md b/INDEX.md index 009c844..56eb008 100644 --- a/INDEX.md +++ b/INDEX.md @@ -48,7 +48,8 @@ The residents of Lucidia - 1,000+ AI agents organized by specialization. |--------|-------| | **Scientific** | physicist, mathematician, chemist, biologist | | **Professional** | engineer, architect, researcher, analyst, strategist, economist | -| **Creative** | creative, speaker, mediator, psychologist | +| **Creative** | creative | +| **Social** | speaker, mediator, psychologist | | **Specialized** | philosopher, historian, linguist, guardian, navigator, builder | **Total: ~1,050 agents** living in Lucidia From 91da41a15f3310079b4eb8bc131747c3b066f5b4 Mon Sep 17 00:00:00 2001 From: Alexa Amundson <118287761+blackboxprogramming@users.noreply.github.com> Date: Sat, 31 Jan 2026 06:39:20 -0600 Subject: [PATCH 5/5] Update MEMORY.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- MEMORY.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/MEMORY.md b/MEMORY.md index 7919712..21d2a76 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -170,7 +170,7 @@ Things we're working on or might pick up: 6. ~~**Integration templates**~~ - DONE! Salesforce, Stripe, Cloudflare, GDrive, GitHub, Design 7. ~~**Control plane CLI**~~ - DONE! Unified interface in prototypes/control-plane 8. ~~**Node configs**~~ - DONE! All 7 nodes configured (lucidia, octavia, aria, alice, shellfish, cecilia, arcadia) -9. ~~**GitHub Actions**~~ - DONE! 8 workflows (ci, deploy, pr-review, health-check, issue-triage, webhook-dispatch, sync-assets, release) +9. ~~**GitHub Actions**~~ - DONE! 8 workflows (ci, deploy-worker, pr-review, health-check, issue-triage, webhook-dispatch, sync-assets, release) 10. ~~**Webhook handlers**~~ - DONE! prototypes/webhooks with handlers for GitHub, Stripe, Salesforce, Cloudflare, Slack, Google, Figma 11. ~~**MCP Server**~~ - DONE! prototypes/mcp-server for AI assistant mesh access 12. ~~**Dispatcher**~~ - DONE! prototypes/dispatcher for routing queries to services