boxlang-core-dev-runtime-architecture

Explains BoxLang runtime architecture and core services for Java integration.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ortus-boxlang/skills --skill boxlang-core-dev-runtime-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: boxlang-core-dev-runtime-architecture
Source: https://github.com/ortus-boxlang/skills/tree/main/boxlang-core-development/runtime-architecture
Command: npx skills add https://github.com/ortus-boxlang/skills --skill boxlang-core-dev-runtime-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

BoxLang runtime internals and architecture explanations help developers understand how core services, context hierarchy, and module isolation work, reducing guesswork when implementing modules and extensions.

Core Features & Use Cases

  • Core services overview: BoxRuntime, InterceptorService, ModuleService, FunctionService (BIF registry), AsyncService, SchedulerService, DataSourceService, and class loader isolation.
  • Context and typing: IBoxContext hierarchy, DynamicObject wrappers, and IBoxType system for interoperability.
  • Use cases: embedding BoxLang in Java apps, creating custom BIFs, and debugging runtime behavior across modules.

Quick Start

Initialize BoxRuntime in your environment and observe the core services to verify runtime setup.

Frequently Asked Questions about boxlang-core-dev-runtime-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I embed BoxLang runtime into a Java application?

To embed BoxLang runtime into a Java application, initialize BoxRuntime in your environment and observe core services like InterceptorService and ModuleService to verify the runtime setup and integration.

How does BoxLang class loader isolation work for modules?

BoxLang class loader isolation separates module dependencies using Class Data Sharing (CDS) and distinct class loaders, preventing conflicts across extensions and ensuring runtime stability during module integration.

What is the IBoxContext hierarchy used for in BoxLang architecture?

The IBoxContext hierarchy in BoxLang architecture manages execution state and variable resolution across runtime scopes, enabling DynamicObject wrappers and the IBoxType system for seamless interoperability.

Can I create custom BIFs using the BoxLang FunctionService?

Yes, you can create custom Built-In Functions (BIFs) by integrating with the BoxLang FunctionService registry, which manages core functions and allows extensions to register new operations within the runtime architecture.

Does BoxLang runtime support virtual threads for async operations?

BoxLang runtime supports virtual threads through its AsyncService and SchedulerService, enabling efficient concurrent execution and debugging of asynchronous runtime behavior across isolated modules.

What is the best way to debug BoxLang runtime behavior across modules?

The best way to debug BoxLang runtime behavior is by examining the BoxRuntime core services, IBoxContext hierarchy, and parsing pipeline to trace execution flow and isolate issues across module boundaries.