molecule-ai/molecule-ai-workspace-runtime

Go to file

rabbitblood c43df7f947 fix(precommit): skip during rebase/cherry-pick/merge/revert — unblocks DIRTY PR rebase Trace from molecule-core cycle 107 (2026-04-24): 15 staging PRs stuck DIRTY (real merge conflicts) with 0 merges in 1+ hours. Authors couldn't rebase to fix the conflicts because the pre-commit hook (shipped in 0.1.11) refuses ANY commit that includes forbidden paths in the diff — including rebase replays of historical commits that pre-date the gate. Specifically, agents trying to `git rebase staging` on a PR like "docs(marketing): Phase 30 social copy" fail at the first commit replay because that commit added marketing/* files. The fix would require interactive rebase + manual file deletion + commit amend — agents don't do that, so the PR stays DIRTY indefinitely. Detection: check .git for rebase-merge/, rebase-apply/, CHERRY_PICK_HEAD, MERGE_HEAD, or REVERT_HEAD. These state markers exist only during the corresponding git operation. Skip the hook silently when present. The hook still blocks fresh `git commit` (the failure mode it was designed for). It just doesn't try to police what was already in git history. Bumped to 0.1.14. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>		2026-04-24 04:34:55 -07:00
.github/workflows	fix(CI): remove conflicting bandit flags from security linter step	2026-04-21 00:58:43 +00:00
molecule_runtime	fix(precommit): skip during rebase/cherry-pick/merge/revert — unblocks DIRTY PR rebase	2026-04-24 04:34:55 -07:00
tests	feat: migrate a2a-sdk 1.x (KI-009) (#39 )	2026-04-24 01:54:33 +00:00
.gitignore	chore: gitignore credentials for molecule-ai-workspace-runtime	2026-04-16 09:18:48 -07:00
pyproject.toml	fix(precommit): skip during rebase/cherry-pick/merge/revert — unblocks DIRTY PR rebase	2026-04-24 04:34:55 -07:00
README.md	feat: initial release of molecule-ai-workspace-runtime 0.1.0	2026-04-16 04:26:06 -07:00

README.md

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.