2026-06-02 17:28:14 +00:00
55 changed files with 55 additions and 0 deletions
@@ -1,5 +1,6 @@
 ---
 title: "Hermes Adapter — Shell Design Spec"
+description: "Design spec for the Hermes runtime adapter — the BaseAdapter shell, provider map, and integration points."
 ---
 # Hermes Adapter — Shell Design Spec

@@ -1,5 +1,6 @@
 ---
 title: "Hermes Adapter — Implementation Plan"
+description: "Implementation plan for the Hermes runtime adapter, from SDK import path to adapter.py build steps."
 ---
 # Hermes Adapter — Implementation Plan

@@ -1,5 +1,6 @@
 ---
 title: "Hermes Agent — Adapter Reconnaissance"
+description: "Reconnaissance of the NousResearch hermes-agent project as a candidate Molecule AI runtime adapter."
 ---
 # Hermes Agent — Adapter Reconnaissance

@@ -1,5 +1,6 @@
 ---
 title: "MeDo Integration Design — Molecule AI Hackathon (May 20 2026)"
+description: "Design for integrating the Baidu MeDo / Miaoda App Builder as an OpenClaw-runtime workspace, with A2A delegation and open questions."
 ---
 # MeDo Integration Design — Molecule AI Hackathon (May 20 2026)

@@ -1,5 +1,6 @@
 ---
 title: "MeDo Smoke Test Log — 2026-04-13 (Run 4)"
+description: "Smoke-test run log for the MeDo / Miaoda App Builder OpenClaw integration."
 ---
 # MeDo Smoke Test Log — 2026-04-13 (Run 4)

@@ -1,5 +1,6 @@
 ---
 title: "ADR-001: Admin endpoints accept any workspace bearer token"
+description: "ADR-001: why admin endpoints validate any workspace bearer token, and the AdminAuth lockdown that followed."
 ---
 # ADR-001: Admin endpoints accept any workspace bearer token

@@ -1,5 +1,6 @@
 ---
 title: "Agent Card"
+description: "The Agent Card at /.well-known/agent-card.json — the A2A document describing a workspace's identity, capabilities, and how to reach it."
 ---
 # Agent Card

@@ -1,5 +1,6 @@
 ---
 title: "Bundle System"
+description: "Workspace bundles — the portable .bundle.json unit that captures everything needed to recreate a workspace anywhere."
 ---
 # Bundle System

@@ -1,5 +1,6 @@
 ---
 title: "Agent Runtime Adapters"
+description: "The pluggable adapter architecture bridging each agent framework (Claude Code, LangGraph, AutoGen, Codex, …) to the A2A protocol."
 ---
 # Agent Runtime Adapters

@@ -1,5 +1,6 @@
 ---
 title: "Config Format (config.yaml)"
+description: "The config.yaml format that defines a workspace's model, runtime, skills, tools, and settings."
 ---
 # Config Format (config.yaml)

@@ -1,5 +1,6 @@
 ---
 title: "Skills"
+description: "Skills — packages that give an agent knowledge, instructions, and optional executable tools; the primary way to customize a workspace."
 ---
 # Skills

@@ -1,5 +1,6 @@
 ---
 title: "Social Channels"
+description: "Connect workspaces to Telegram, Slack, and Discord through the pluggable channel adapter pattern."
 ---
 # Social Channels

@@ -1,5 +1,6 @@
 ---
 title: "System Prompt Structure"
+description: "How a workspace agent's system prompt is assembled — identity, capabilities, then delegation, ordered specific-to-general."
 ---
 # System Prompt Structure

@@ -1,5 +1,6 @@
 ---
 title: "Team Expansion (Recursive Workspaces)"
+description: "Recursive team expansion — turning a workspace into a team lead with sub-workspaces, infinitely deep."
 ---
 # Team Expansion (Recursive Workspaces)

@@ -1,5 +1,6 @@
 ---
 title: "A2A Protocol (Inter-Workspace Communication)"
+description: "The A2A (Agent-to-Agent) protocol for direct inter-workspace communication, with the platform out of the message path."
 ---
 # A2A Protocol (Inter-Workspace Communication)

@@ -1,5 +1,6 @@
 ---
 title: "Communication Rules"
+description: "How communication topology is derived automatically from the org hierarchy — the hierarchy IS the access-control policy."
 ---
 # Communication Rules

@@ -1,5 +1,6 @@
 ---
 title: "Platform API (Go Backend)"
+description: "The Go control-plane backend — how it manages workspace infrastructure and coordination without executing agent reasoning."
 ---
 # Platform API (Go Backend)

@@ -1,5 +1,6 @@
 ---
 title: "Registry & Heartbeat"
+description: "Workspace registration and the 30-second heartbeat that tells the platform which workspaces are alive and where to reach them."
 ---
 # Registry & Heartbeat

@@ -1,5 +1,6 @@
 ---
 title: "WebSocket Events"
+description: "The /ws WebSocket stream of real-time structure events that the canvas subscribes to."
 ---
 # WebSocket Events

@@ -1,5 +1,6 @@
 ---
 title: "System Architecture"
+description: "The distributed system architecture — workspaces on separate machines communicating over the A2A protocol."
 ---
 # System Architecture

@@ -1,5 +1,6 @@
 ---
 title: "Canary release pipeline"
+description: "The canary release pipeline that ships workspace-server changes to the prod tenant fleet, and how to halt it."
 ---
 # Canary release pipeline

@@ -1,5 +1,6 @@
 ---
 title: "Database Schema"
+description: "The Postgres schema — the mutable projection of structure_events representing current workspace state."
 ---
 # Database Schema

@@ -1,5 +1,6 @@
 ---
 title: "Event Log"
+description: "The append-only structure_events table and the event-sourcing pattern behind workspace state."
 ---
 # Event Log

@@ -1,5 +1,6 @@
 ---
 title: "Memory Architecture (HMA)"
+description: "The Hierarchical Memory Architecture (HMA) — LOCAL / TEAM / GLOBAL scopes that follow the org tree."
 ---
 # Memory Architecture (HMA)

@@ -1,5 +1,6 @@
 ---
 title: "Architecture Overview"
+description: "How Molecule AI orchestrates AI agent workspaces into an org hierarchy — registration, A2A communication, and the canvas."
 ---
 # Architecture Overview

@@ -1,5 +1,6 @@
 ---
 title: "Partner API Keys — Programmatic Org Management"
+description: "Partner API keys (mol_pk_…) for programmatic org management by CI/CD, resellers, and automation."
 ---
 # Partner API Keys — Programmatic Org Management

@@ -1,5 +1,6 @@
 ---
 title: "Provisioner"
+description: "The provisioner — how the platform deploys workspace containers and VMs on create, import, or team expansion."
 ---
 # Provisioner

@@ -1,5 +1,6 @@
 ---
 title: "SaaS prod migration — 2026-04-19"
+description: "Prod cutover notes for the 2026-04-19 staging→main promotion of molecule-controlplane and molecule-core."
 ---
 # SaaS prod migration — 2026-04-19

@@ -1,5 +1,6 @@
 ---
 title: "Staging Environment Design"
+description: "The staging environment design on Railway, mirroring prod for safe pre-release validation."
 ---
 # Staging Environment Design

@@ -1,5 +1,6 @@
 ---
 title: "Technology Choices"
+description: "Why each core technology — Go, Postgres, Redis, the runtime adapters — was chosen for Molecule AI."
 ---
 # Technology Choices

@@ -1,5 +1,6 @@
 ---
 title: "Tenant Image Upgrade Strategies"
+description: "Strategies for rolling a new platform-tenant image out to existing EC2 tenants, with trade-offs."
 ---
 # Tenant Image Upgrade Strategies

@@ -1,5 +1,6 @@
 ---
 title: "Wildcard DNS + Cloudflare Worker Proxy"
+description: "Wildcard DNS plus a Cloudflare Worker proxy for routing per-tenant subdomains."
 ---
 # Wildcard DNS + Cloudflare Worker Proxy

@@ -1,5 +1,6 @@
 ---
 title: "Workspace Tiers"
+description: "The four workspace tiers (T1–T4) and the isolation-vs-system-access trade-off each makes."
 ---
 # Workspace Tiers

@@ -1,5 +1,6 @@
 ---
 title: "Build Order"
+description: "The recommended build order — proving the register → canvas → heartbeat → offline core loop first."
 ---
 # Build Order

@@ -1,5 +1,6 @@
 ---
 title: "Code Sandbox"
+description: "The code sandbox that isolates execution of the agent's own generated code (the run_code tool)."
 ---
 # Code Sandbox

@@ -1,5 +1,6 @@
 ---
 title: "Constraints & Rules"
+description: "Key design rules and invariants to follow across the Molecule AI codebase."
 ---
 # Constraints & Rules

@@ -1,5 +1,6 @@
 ---
 title: "Local Development"
+description: "Running Molecule AI locally — how workspace containers are provisioned on demand during development."
 ---
 # Local Development

@@ -1,5 +1,6 @@
 ---
 title: "Observability (Langfuse)"
+description: "Self-hosted Langfuse observability — automatic per-workspace agent tracing via the runtime integration."
 ---
 # Observability (Langfuse)

@@ -1,5 +1,6 @@
 ---
 title: "E2E Testing"
+description: "The end-to-end test suite under tests/e2e/ — real Postgres + Redis, shellcheck-clean scripts, shared helpers."
 ---
 # E2E Testing

@@ -1,5 +1,6 @@
 ---
 title: "Canvas UI (Next.js Frontend)"
+description: "The canvas — Molecule AI's operational UI for deploying workspaces, inspecting live state, configuring runtimes, and chatting with agents."
 ---
 # Canvas UI (Next.js Frontend)

@@ -1,5 +1,6 @@
 ---
 title: "Guides"
+description: "Step-by-step guides for common Molecule AI integrations and configurations."
 ---
 # Guides

@@ -1,5 +1,6 @@
 ---
 title: "Skill Catalog"
+description: "The skill catalog — available skill types and how to install them per workspace."
 ---
 # Skill Catalog

@@ -1,5 +1,6 @@
 ---
 title: "Incident Log — molecule-core"
+description: "Chronological incident log for molecule-core — summaries, resolutions, and references."
 ---
 # Incident Log — molecule-core

@@ -1,5 +1,6 @@
 ---
 title: "Molecule AI + opencode Integration"
+description: "Connect opencode to a Molecule AI workspace over remote MCP for the full A2A tool surface."
 ---
 # Molecule AI + opencode Integration

@@ -1,5 +1,6 @@
 ---
 title: "Molecule AI plugins and the agentskills.io standard"
+description: "How Molecule AI plugins align with the agentskills.io standard for cross-tool compatibility."
 ---
 # Molecule AI plugins and the agentskills.io standard

@@ -1,5 +1,6 @@
 ---
 title: "Plugin install sources"
+description: "Plugin install sources — the local:// registry and pinned github:// refs, orthogonal to plugin shape."
 ---
 # Plugin install sources

@@ -1,5 +1,6 @@
 ---
 title: "Cognee Architecture Deep-Dive — Workspace Isolation"
+description: "Deep-dive into Cognee's isolation primitives versus Molecule AI's per-workspace memory requirements."
 ---
 # Cognee Architecture Deep-Dive — Workspace Isolation

@@ -1,5 +1,6 @@
 ---
 title: "Cognee Workspace Isolation Evaluation"
+description: "Evaluating Cognee, an open-source AI memory engine, against Molecule AI's hierarchical memory isolation needs."
 ---
 # Cognee Workspace Isolation Evaluation

@@ -1,5 +1,6 @@
 ---
 title: "Provisioning Workspaces on Fly Machines (CONTAINER_BACKEND=flyio)"
+description: "Provisioning workspaces on Fly Machines with CONTAINER_BACKEND=flyio instead of local Docker."
 ---
 # Provisioning Workspaces on Fly Machines (CONTAINER_BACKEND=flyio)

@@ -1,5 +1,6 @@
 ---
 title: "Running a Google ADK Workspace on Molecule AI"
+description: "Run a Google ADK (Gemini on Vertex AI) workspace on Molecule AI, from zero to a registered A2A agent."
 ---
 # Running a Google ADK Workspace on Molecule AI

@@ -1,5 +1,6 @@
 ---
 title: "Hermes Multi-Provider Dispatch: Native Anthropic, Gemini, and Multi-Turn History"
+description: "Hermes multi-provider dispatch — native Anthropic and Gemini routing with correct multi-turn history."
 ---
 # Hermes Multi-Provider Dispatch: Native Anthropic, Gemini, and Multi-Turn History

@@ -1,5 +1,6 @@
 ---
 title: "Connecting an AI Agent to Lark / Feishu"
+description: "Connect a workspace agent to Lark / Feishu using the Lark channel adapter."
 ---
 # Connecting an AI Agent to Lark / Feishu

@@ -1,5 +1,6 @@
 ---
 title: "Register a Remote Agent on Molecule AI"
+description: "Register a remote agent running on your own infrastructure to a Molecule AI canvas."
 ---
 # Register a Remote Agent on Molecule AI

@@ -1,5 +1,6 @@
 ---
 title: "SaaS Federation — Multi-Tenant Agent Platform"
+description: "Set up a multi-tenant agent platform with Molecule AI's SaaS federation — per-tenant isolation from one control plane."
 ---
 # SaaS Federation — Multi-Tenant Agent Platform

@@ -1,5 +1,6 @@
 ---
 title: Self-Hosted Workspace Deployment with Docker
+description: "Run a Molecule AI workspace agent as a self-hosted Docker container — env vars, healthcheck, and Kubernetes."
 ---

 # Self-Hosted Workspace Deployment with Docker