Risks

Low. This change is purely additive - it adds a new public method to the IAgentRuntime interface without modifying any existing functionality. No breaking changes.

What could be affected:

• Plugins can now access action results through a clean API
• Backward compatible - existing code continues to work unchanged

Background

What does this PR do?

Adds a public getActionResults(messageId: UUID): ActionResult[] method to the IAgentRuntime interface and AgentRuntime class, providing a clean, type-safe API for plugins to retrieve action execution results after calling processActions().

Currently, plugins that need to execute actions and retrieve their results must cast IAgentRuntime to AgentRuntime to access the internal stateCache, which is not type-safe and relies on implementation details.

What kind of change is this?

• Features (non-breaking change which adds functionality)
• Improvements (misc. changes to existing features - test cleanup)

Why are we doing this? Any context or related work?

Plugins like workers need to execute actions programmatically and retrieve structured results for further processing. The current workaround requires casting to the concrete implementation and accessing internal cache, which is fragile and not part of the public API.

This PR provides:

• Clean, documented public API
• Type safety
• Encapsulation of internal cache implementation
• Better developer experience for plugin authors

Documentation changes needed?

My changes require a change to the project documentation.

• API documentation for getActionResults() method added in code comments
• No external documentation update needed as this is a new API addition

Testing

Where should a reviewer start?

1. Review the interface change in packages/core/src/types/runtime.ts
2. Review the implementation in packages/core/src/runtime.ts
3. Review the comprehensive test coverage in packages/core/src/__tests__/runtime.test.ts

Detailed testing steps

None: Automated tests are acceptable.

All tests pass (33 pass, 0 fail):

cd eliza
bun test packages/core/src/__tests__/runtime.test.ts