molecule-ai/molecule-ai-workspace-runtime

Hongming Wang 851a6d7bfd feat: initial release of molecule-ai-workspace-runtime 0.1.0

Extracts shared workspace runtime from molecule-monorepo/workspace-template
into a publishable PyPI package.

- molecule_runtime/ package with all shared infrastructure modules
- Adapter discovery via ADAPTER_MODULE env var (standalone repos) + built-in scan
- molecule-runtime console script entry point (main_sync)
- CI workflow to publish on version tags
- Published to PyPI as molecule-ai-workspace-runtime==0.1.0

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-16 04:26:06 -07:00

1.9 KiB

Raw Blame History

molecule-ai-workspace-runtime

Shared Python runtime infrastructure for all Molecule AI agent adapters.

This package provides the core machinery that every Molecule AI workspace container needs:

A2A server — Registers with the platform, heartbeats, serves A2A JSON-RPC
Adapter interface — BaseAdapter / AdapterConfig / SetupResult
Built-in tools — delegation, memory, approvals, sandbox, telemetry
Skill loader — loads and hot-reloads skill modules from /configs/skills/
Plugin system — per-workspace + shared plugin discovery and install
Config / preflight — YAML config loading with validation

Installation

pip install molecule-ai-workspace-runtime

Adapter Discovery

The runtime discovers adapters in two ways:

ADAPTER_MODULE env var (standalone adapter repos):
```
ADAPTER_MODULE=my_adapter molecule-runtime
```
The module must export an Adapter class extending BaseAdapter.
Built-in subdirectory scan (monorepo local dev): Scans molecule_runtime/adapters/ subdirectories for Adapter classes.

Writing an Adapter

from molecule_runtime.adapters.base import BaseAdapter, AdapterConfig
from a2a.server.agent_execution import AgentExecutor

class Adapter(BaseAdapter):
    @staticmethod
    def name() -> str:
        return "my-runtime"

    @staticmethod
    def display_name() -> str:
        return "My Runtime"

    @staticmethod
    def description() -> str:
        return "My custom agent runtime"

    async def setup(self, config: AdapterConfig) -> None:
        result = await self._common_setup(config)
        # Store result attributes for create_executor

    async def create_executor(self, config: AdapterConfig) -> AgentExecutor:
        # Return an AgentExecutor instance
        ...

Set ADAPTER_MODULE=my_package.adapter and run molecule-runtime.

License

BSL-1.1 — see LICENSE for details.