molecule-core/plugins/molecule-hitl/plugin.yaml
Hongming Wang 18b94e0025 feat(plugin): molecule-hitl — opt-in HITL gates (#257)
Closes #257. Thin manifest + skill doc that activates the existing
builtin_tools/hitl.py primitives as a per-workspace opt-in plugin.

The Python implementation (@requires_approval decorator, pause_task /
resume_task tools, multi-channel notification, RBAC bypass roles) is
already in every runtime image — this plugin is the policy layer that
tells agents *when* to call them.

- plugins/molecule-hitl/plugin.yaml — runtimes: langgraph, claude_code,
  deepagents; skills: hitl-gates
- plugins/molecule-hitl/skills/hitl-gates/SKILL.md — documents the 5
  classes of action that need a gate (deployment / irreversible FS /
  public message / production mutation / cross-workspace destructive),
  decorator pattern, pause/resume pattern, config shape, 4 anti-patterns,
  5-step test plan

No Python code — all implementation already exists. Install per
workspace via POST /workspaces/:id/plugins.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 14:03:19 -07:00

25 lines
993 B
YAML

name: molecule-hitl
version: 1.0.0
description: >
Human-in-the-loop gates for any async callable. Wraps builtin_tools/hitl.py:
@requires_approval decorator, pause_task/resume_task tools, multi-channel
notification (dashboard/Slack/email), RBAC bypass roles. Opt-in per workspace.
author: Molecule AI
tags: [hitl, approvals, human-in-the-loop, safety]
# Runtimes that can use this plugin. The Python primitives in hitl.py are
# LangChain-based, so LangGraph + Claude Code (which wraps LangChain tools)
# are the direct consumers. DeepAgents also embeds LangChain.
runtimes:
- langgraph
- claude_code
- deepagents
# Skills shipped by the plugin — a single "hitl-gates" skill that tells the
# agent WHEN to call request_approval / pause_task / resume_task. The
# implementation lives in workspace-template/builtin_tools/hitl.py (already
# in every image) — this plugin is the opt-in policy layer that activates
# the decorator pattern for specific roles.
skills:
- hitl-gates