UMG Envoy Agent

Run Universal Modular Generation as a modular cognitive architectural runtime inside OpenClaw, with sleeve-aware orchestration, active sleeve session state, runtime inspection, IR Matrix visibility, and approved read-only tool gating.

Install

openclaw plugins install clawhub:umg-envoy-agent

UMG Envoy Agent 0.3.0-alpha.12

UMG Envoy Agent 0.3.0-alpha.12 lets you run Universal Modular Generation as a modular cognitive architectural runtime inside OpenClaw, with sleeve-aware orchestration, active sleeve session state, runtime inspection, IR Matrix visibility, and approved read-only tool gating.

It is not a broad execution agent package.

  • 0.3.0-alpha.7 may be referenced historically as the public package baseline.
  • 0.3.0-alpha.8 is a previous verified public release.
  • 0.3.0-alpha.9 is a previous verified public release.
  • 0.3.0-alpha.10 is a previous verified public release.
  • 0.3.0-alpha.11 is the current public release.
  • 0.3.0-alpha.12 is the current package candidate for clean native graph fixture, sleeve-native graph richness, and clean native route proof.

alpha.12 capability note

alpha.12 includes the Alpha6 real block-library runtime path, Alpha7 controlled runtime flow additions, the Alpha8 bounded read-only orchestration surface, explicit active sleeve session state, richer sleeve graph visibility, and the first clean native graph fixture/runtime integration with corrected diagnostics shape:

  • runtime tool request classifier
  • execution gate plan
  • approval checkpoint create
  • approval checkpoint resume
  • approved allowlisted read-only execution
  • end-to-end dry-run-to-approved-read-only execution chain
  • active sleeve / IR Matrix / envelope inspector
  • clean native graph fixture
  • native graph schema/types/adapter
  • runtime graph richness native fixture integration
  • runtimeCodeIdentity diagnostics
  • nativeFixtureResolution diagnostics
  • sourceMode = sleeve_native for clean native fixture
  • routePurity = clean_native for clean native fixture

alpha.12 preserves strict safety boundaries:

  • approved only
  • allowlisted only
  • read-only only
  • no broad autonomous execution
  • no trigger evaluation as execution authority
  • no external MOLT block file loading
  • no full library scan
  • no unbounded recursive traversal
  • no UMG-Block-Library mutation
  • no restart / publish / package execution
  • no automatic response takeover
  • direct_source remains disabled

Live-capable tool surface

Alpha6 / block-library runtime path tools

  • umg_envoy_block_library_status
  • umg_envoy_block_library_manifest_index
  • umg_envoy_block_library_manifest_entry_lookup
  • umg_envoy_block_library_target_shallow_load_gate
  • umg_envoy_block_library_target_shallow_load_single
  • umg_envoy_block_library_target_shallow_summary_normalize
  • umg_envoy_block_library_neoblock_inspect
  • umg_envoy_block_library_moltblock_visible_extract
  • umg_envoy_block_library_molt_map_fragment
  • umg_envoy_block_library_molt_map_compose
  • umg_envoy_block_library_response_envelope_fragment
  • umg_envoy_block_library_active_stack_projection
  • umg_envoy_block_library_sleeve_graph_index
  • umg_envoy_block_library_sleeve_graph_drilldown
  • umg_envoy_sleeve_select
  • umg_envoy_sleeve_resolve
  • umg_envoy_runtime_compile
  • umg_envoy_runtime_preview

Alpha7/Alpha8/Alpha10 runtime control / visibility tools

  • umg_envoy_runtime_tool_request_classify
  • umg_envoy_runtime_execution_gate_plan
  • umg_envoy_runtime_approval_checkpoint_create
  • umg_envoy_runtime_approval_checkpoint_resume
  • umg_envoy_runtime_execute_approved_allowlisted
  • umg_envoy_runtime_execution_chain_e2e_approved_read_only
  • umg_envoy_runtime_active_sleeve_ir_matrix_envelope_inspect
  • umg_envoy_runtime_bounded_read_only_orchestrate
  • umg_envoy_sleeve_session_select
  • umg_envoy_sleeve_session_current
  • umg_envoy_sleeve_session_clear
  • umg_envoy_sleeve_session_inspect
  • umg_envoy_runtime_sleeve_graph_richness_inspect

Existing utility tools

  • umg_envoy_status
  • umg_envoy_compiler_smoke_test
  • umg_envoy_list_sleeves
  • umg_envoy_list_block_libraries
  • umg_envoy_compile_sleeve
  • umg_envoy_validate_runtime_output
  • umg_envoy_compare_sleeves
  • umg_envoy_parse_path
  • umg_envoy_validate_path
  • umg_envoy_render_path
  • umg_envoy_build_path
  • umg_envoy_matrix_status

What alpha.12 does

  • inspects the real block-library through bounded approved lanes
  • resolves a real sleeve into a bounded dry-run graph
  • shallow-loads approved NeoBlocks within limits
  • extracts visible MOLT fragments
  • composes a full or partial MOLT Map
  • compiles a dry-run RuntimeSpecV0
  • classifies declared tool requests without executing them
  • creates execution gate plans and approval checkpoint projections
  • can execute approved allowlisted read-only actions only
  • renders Active Stack and response-envelope previews
  • selects and remembers an explicit active sleeve for the session
  • reports current active sleeve session state
  • clears active sleeve session state without hidden fallback
  • inspects active sleeve, NeoStacks, NeoBlocks, MOLT blocks, RuntimeSpec, IR Matrix, envelope preview, and execution gate state
  • exposes clean native fixture-backed graph richness with sleeve-native provenance

What alpha.12 does not do

  • broad execution
  • unapproved execution
  • non-allowlisted execution
  • write/mutate runtime actions through the Alpha7 chain
  • trigger evaluation as independent execution authority
  • external MOLT block loading
  • full-graph recursion
  • mutation of the UMG-Block-Library
  • package / publish / restart execution

Default posture

  • allowRuntimeWrites: false
  • contentMode: bundled-public or configured packaged mode
  • compilerMode: compiler-backed dry-run preview
  • debug: false

Docs

  • Quickstart: docs/ALPHA8-QUICKSTART.md
  • Demo runtime flow: docs/ALPHA8-DEMO-RUNTIME-FLOW.md

Install

  • current public release: openclaw plugins install clawhub:umg-envoy-agent@0.3.0-alpha.11
  • current package candidate for prep: umg-envoy-agent@0.3.0-alpha.12

Build and test

  • npm run check
  • npm run build
  • npm run smoke
  • npm run pack:dry

Entrypoint

  • dist/plugin-entry.js