From 75dab2c6dcf7d779fa52969d718112cfc4426a16 Mon Sep 17 00:00:00 2001 From: Hongming Wang Date: Mon, 4 May 2026 04:47:29 -0700 Subject: [PATCH] docs: align runtime lists with workspace-server allowlist; remove stale NemoClaw/NVIDIA claims MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cross-checked every runtime list against the canonical AllRuntimes allowlist in workspace-server/internal/handlers/admin_workspace_images.go (claude-code, langgraph, crewai, autogen, deepagents, hermes, gemini-cli, openclaw). Lists were drifting toward an old 6-runtime snapshot, missing hermes + gemini-cli; one file referenced a non-existent NemoClaw branch plus NVIDIA T4 hardware that has no source presence anywhere in the monorepo (verified: no `feat/nemoclaw-t4-docker` branch, no `nemoclaw` references outside docs). Files changed: content/docs/agent-runtime/workspace-runtime.md - Before: "Current `main` ships six adapters" listing langgraph, deepagents, claude-code, crewai, autogen, openclaw + a "Branch-level experiments such as NemoClaw" sentence. - After: "Current `main` ships eight adapters" — added hermes + gemini-cli; removed NemoClaw line; pointed readers at AllRuntimes as the source of truth and external-workspace path for BYO. content/docs/architecture/molecule-technical-doc.md (two locations) - Before (runtime table ~line 575): 6 rows + "Branch-level WIP: NemoClaw (NVIDIA T4 + Docker socket) on feat/nemoclaw-t4-docker". - After: 8 rows including Hermes + Gemini CLI; NemoClaw line deleted; AllRuntimes pointer added. - Before (Branch-Level Work table ~line 981): row "feat/nemoclaw-t4-docker | NemoClaw adapter (NVIDIA T4 support) | WIP". - After: row removed (the branch does not exist). content/docs/architecture/overview.md - Before: "Supports LangGraph, Claude Code, OpenClaw, DeepAgents, CrewAI, AutoGen." - After: "Supports Claude Code, LangGraph, CrewAI, AutoGen, DeepAgents, Hermes, Gemini CLI, and OpenClaw." content/docs/glossary.md - Before: runtime defined as "one of langgraph, claude-code, openclaw, crewai, autogen, deepagents, hermes" (7, missing gemini-cli). - After: full 8-entry list ordered to match AllRuntimes. Out-of-scope sweep results (no changes needed): - "NeMo Guardrails" — zero references in molecule-docs (the "guardrails" word elsewhere refers to generic plugin/role guardrails, not the NVIDIA NeMo Guardrails product). Nothing to remove. - "Nemotron" — only present in the monorepo as a NIM model alias inside a model-dispatcher test; no first-class model claim in docs. - Model lists in docs match workspace/agent.py (Anthropic, OpenAI, Gemini, MiniMax, DeepSeek, Moonshot, local Ollama/vLLM); no Nemotron claims to remove. - Observability sinks (OpenTelemetry, Langfuse, Sentry, Prometheus references) match implementation; no NeMo Guardrails sink claimed. - index.mdx, concepts.mdx, architecture.mdx already list the full 8 runtimes; no edit needed there. Verified via `npm run build` — all 111 static pages regenerate clean. Co-Authored-By: Claude Opus 4.7 (1M context) --- content/docs/agent-runtime/workspace-runtime.md | 10 ++++++---- content/docs/architecture/molecule-technical-doc.md | 9 +++++---- content/docs/architecture/overview.md | 2 +- content/docs/glossary.md | 2 +- 4 files changed, 13 insertions(+), 10 deletions(-) diff --git a/content/docs/agent-runtime/workspace-runtime.md b/content/docs/agent-runtime/workspace-runtime.md index 277e9df..f622b8f 100644 --- a/content/docs/agent-runtime/workspace-runtime.md +++ b/content/docs/agent-runtime/workspace-runtime.md @@ -9,16 +9,18 @@ The `workspace/` directory is Molecule AI's unified runtime image. Every provisi ## Runtime Matrix In Current `main` -Current `main` ships six adapters: +Current `main` ships eight adapters: -- `langgraph` -- `deepagents` - `claude-code` +- `langgraph` - `crewai` - `autogen` +- `deepagents` +- `hermes` +- `gemini-cli` - `openclaw` -This is the merged runtime surface today. Branch-level experiments such as NemoClaw are separate and should be treated as roadmap/WIP, not merged support. +This is the merged runtime surface today. The canonical allowlist lives in `workspace-server/internal/handlers/admin_workspace_images.go` (`AllRuntimes`). Anything not on this list — including BYO runtimes — registers via the [external workspace](../external-agents.mdx) path, not as a built-in adapter. Adapter-specific behavior is documented in [Agent Runtime Adapters](./cli-runtime.md). diff --git a/content/docs/architecture/molecule-technical-doc.md b/content/docs/architecture/molecule-technical-doc.md index ecf65c7..c9d6c7c 100644 --- a/content/docs/architecture/molecule-technical-doc.md +++ b/content/docs/architecture/molecule-technical-doc.md @@ -573,14 +573,16 @@ compliance: | Adapter | Core Strength | Image Tag | |---------|--------------|-----------| -| **LangGraph** | Graph-based state machine, tool use, streaming | `workspace-template:langgraph` | -| **DeepAgents** | Deep planning, multi-step task decomposition | `workspace-template:deepagents` | | **Claude Code** | Native coding workflows, CLI continuity, OAuth auth | `workspace-template:claude-code` | +| **LangGraph** | Graph-based state machine, tool use, streaming | `workspace-template:langgraph` | | **CrewAI** | Role-based crews, structured task orchestration | `workspace-template:crewai` | | **AutoGen** | Multi-agent conversations, explicit strategies | `workspace-template:autogen` | +| **DeepAgents** | Deep planning, multi-step task decomposition | `workspace-template:deepagents` | +| **Hermes** | Multi-provider dispatch (Anthropic/Gemini native + OpenAI-compatible shim) | `workspace-template:hermes` | +| **Gemini CLI** | Google Gemini CLI workspace | `workspace-template:gemini-cli` | | **OpenClaw** | CLI-native runtime, own session model | `workspace-template:openclaw` | -**Branch-level WIP**: NemoClaw (NVIDIA T4 + Docker socket) on `feat/nemoclaw-t4-docker`. +The canonical allowlist lives in `workspace-server/internal/handlers/admin_workspace_images.go` (`AllRuntimes`). Anything outside this list registers via the external-workspace path. Each adapter implements `setup()` + `create_executor()`. The base adapter provides shared infrastructure: system prompt assembly, skill loading, tool registration, coordinator detection, plugin injection. @@ -978,7 +980,6 @@ Tools call `resp.json()` without catching JSON decode errors. Should wrap in try | Branch | Feature | Status | |--------|---------|--------| -| `feat/nemoclaw-t4-docker` | NemoClaw adapter (NVIDIA T4 support) | WIP | | Backlog | Firecracker backend (faster cold starts) | Planned | | Backlog | E2B backend (cloud-hosted code sandbox) | Planned | | Backlog | pgvector semantic memory search | Planned | diff --git a/content/docs/architecture/overview.md b/content/docs/architecture/overview.md index 82a0483..9c80e47 100644 --- a/content/docs/architecture/overview.md +++ b/content/docs/architecture/overview.md @@ -20,7 +20,7 @@ Canvas (Next.js :3000) ←WebSocket→ Platform (Go :8080) ←HTTP→ Postgres + - **Workspace Server** (`workspace-server/`): Go/Gin control plane — workspace CRUD, registry, discovery, WebSocket hub, liveness monitoring. - **Canvas** (`canvas/`): Next.js 15 + React Flow (@xyflow/react v12) + Zustand + Tailwind — visual workspace graph. -- **Workspace Runtime** (`workspace/`): Shared runtime published as [`molecule-ai-workspace-runtime`](https://pypi.org/project/molecule-ai-workspace-runtime/) on PyPI. Supports LangGraph, Claude Code, OpenClaw, DeepAgents, CrewAI, AutoGen. Each adapter lives in its own standalone template repo (e.g. `molecule-ai-workspace-template-claude-code`). See `docs/workspace-runtime-package.md` for the full picture. +- **Workspace Runtime** (`workspace/`): Shared runtime published as [`molecule-ai-workspace-runtime`](https://pypi.org/project/molecule-ai-workspace-runtime/) on PyPI. Supports Claude Code, LangGraph, CrewAI, AutoGen, DeepAgents, Hermes, Gemini CLI, and OpenClaw. Each adapter lives in its own standalone template repo (e.g. `molecule-ai-workspace-template-claude-code`). See `docs/workspace-runtime-package.md` for the full picture. - **molecli** (`workspace-server/cmd/cli/`): Go TUI dashboard (Bubbletea + Lipgloss) — real-time workspace monitoring, event log, health overview, delete/filter operations. ## Key Architectural Patterns diff --git a/content/docs/glossary.md b/content/docs/glossary.md index dc840e6..39c500a 100644 --- a/content/docs/glossary.md +++ b/content/docs/glossary.md @@ -26,7 +26,7 @@ lands in the watch list with a colliding term, add a row here. | **team** | A named cluster of workspaces under a PM (org template `expand_team`). Used for role grouping in Canvas. | **CrewAI**: a "crew" is a sequence of agents that pass a task through a declared order. Our "team" is an org-chart abstraction, not an execution order. | | **skill** | A directory with `SKILL.md` that an agent invokes via the `Skill` tool. Skills are documentation + optional scripts that teach an agent a recipe. | **Anthropic Skills API**: nearly identical. **CrewAI tool**: closer to our plugin's MCP tool, not our skill. | | **channel** | An outbound/inbound social integration (Telegram, Slack, …) per-workspace, wired in `workspace_channels`. | Slack's "channel": the container for messages. We use "channel" for the adapter + credentials, not the conversation itself. | -| **runtime** | The execution engine image tag for a workspace: one of `langgraph`, `claude-code`, `openclaw`, `crewai`, `autogen`, `deepagents`, `hermes`. | **LangGraph runtime**: the Python process running the graph. We use "runtime" for the Docker image + adapter pairing, not the inner process. | +| **runtime** | The execution engine image tag for a workspace: one of `claude-code`, `langgraph`, `crewai`, `autogen`, `deepagents`, `hermes`, `gemini-cli`, `openclaw`. | **LangGraph runtime**: the Python process running the graph. We use "runtime" for the Docker image + adapter pairing, not the inner process. | ## GitHub Awesome Copilot disambiguation