Expose agent execution status via a simple, queryable API

### Language Implementation

- [ ] Python
- [ ] TypeScript

### Feature Type

- [ ] Action Provider Template
- [ ] Wallet Provider Template
- [ ] Framework Extension
- [ ] Core Requirements
- [ ] Other

### 🚀 The feature, motivation and pitch

## Overview
When running agents with AgentKit, developers often need to know the current execution status (idle, running, waiting, completed, failed) without relying on logs or custom instrumentation.

## Problem Description
At the moment, there is no simple way to query an agent’s current execution state programmatically. This makes it harder to build dashboards, status indicators, or coordination logic around agent execution.

## Expected Behavior
Developers should be able to query an agent’s current execution status at any time in a predictable and lightweight way. The status should accurately reflect whether the agent is idle, actively executing, waiting on an external dependency, or finished.

## Proposed Solution
Introduce a small, read-only API or helper (for example, `agent.getStatus()`) that returns the current execution state and basic metadata. This API should be safe to call at any time, should not trigger execution, and should work consistently across different runtime environments.

### Alternatives

_No response_

### Additional context

_No response_