Highlights
- Added Action Execution Environment v2 for managed runtime resources.
- Added Action-native built-in capability packages for Search, Browse, and Cmd.
- Added agent capability helpers for common execution capabilities such as Python, shell, Node.js, SQLite, and workspace access.
- Added compact action execution recall with artifact-backed full result access.
- Added companion compatibility manifests for Agently, Agently-Skills, and Agently-Devtools release alignment.
Features
Action Execution Environment
- [ExecutionEnvironment] Added managed environment lifecycle support for Python, Bash, Node.js, Docker, Browser, SQLite, and MCP resources.
- [ExecutionEnvironment] Added provider contracts for declaring, ensuring, health-checking, injecting, and releasing managed resources.
- [Action] Added environment-aware action execution so executors can receive managed handles and resources without changing executor call signatures.
- [TriggerFlow] Added support for managed execution-local resources while keeping
runtime_resourcesas the compatibility surface.
Built-in Actions
- [Action] Added Action-native built-in packages under
agently.builtins.actions. - [Action] Added Search and Browse packages with Action Runtime integration.
- [Action] Added Cmd and sandbox-oriented execution paths for local command workflows.
- [Action] Added execution recall so instruction-heavy action outputs can be summarized in model context while full outputs remain available through artifacts.
Agent Capability Helpers
- [Agent] Added capability helpers for common managed execution capabilities.
- [Agent] Added
desc_modebehavior for helper descriptions, supporting default, append, and override modes. - [Agent] Improved default helper descriptions so model-facing action guidance keeps baseline usage and safety constraints.
Updates
Runtime And Observability
- [Runtime] Improved runtime console log routing.
- [Observability] Preferred
ObservationEventnaming while keeping legacy runtime event compatibility. - [EventCenter] Expanded event coverage for action and execution-environment lifecycle paths.
Compatibility
- [Compatibility] Added version-scoped compatibility manifests under
compatibility/releases/. - [Compatibility] Added release index metadata for current and in-development compatibility lines.
- [Compatibility] Added Agently-Skills and Agently-Devtools companion alignment metadata.
- [DevTools] Updated static 4.1.2 compatibility metadata to recommend
agently-devtools>=0.1.4,<0.2.0.
Docs And Examples
- [Docs] Added Execution Environment documentation in English and Chinese.
- [Docs] Added extension-boundary guidance for core contracts, providers, built-in capabilities, and application helpers.
- [Docs] Updated Action Runtime, observability, settings, and TriggerFlow resource guidance.
- [Examples] Added built-in action examples for Search and Browse.
- [Examples] Added execution-environment examples for Python, Node.js, SQLite, Browser, and health-check reuse.
- [Examples] Added cookbook examples for model-driven action loops, routing, concurrency, reflection, and shell-policy workflows.
- [Examples] Archived obsolete built-in tool examples.
Developer Experience
- [Types] Added Pyright configuration for the main repository.
- [Tests] Added compatibility registry coverage.
- [Tests] Expanded coverage for Action Runtime, Execution Environment, EventCenter, runtime observation, and built-in action flows.
Bug Fixes
- [Runtime] Fixed runtime console log routing behavior.
- [Agent] Preserved default helper descriptions when custom descriptions are supplied.
- [Compatibility] Kept published framework-code compatibility metadata stable while allowing static release metadata updates.
Full Changelog: v4.1.1...v4.1.2