report_progress
Report progress updates for agent tasks and status changes. Send status, task, milestone, error, or completion messages with optional task tracking and broadcast to rooms.
Instructions
Report progress updates for agent tasks and status changes
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agentId | Yes | ID of the agent reporting progress. Must be a valid agent ID that exists in the system. | |
| repositoryPath | Yes | Path to the repository or project directory. Can be relative (e.g., '.') or absolute path. | |
| progressType | Yes | Type of progress being reported: 'status' for general agent status updates, 'task' for task-specific progress, 'milestone' for significant achievements, 'error' for reporting errors/failures, 'completion' for task completion. | |
| message | Yes | Human-readable progress message describing what the agent is doing or has accomplished. This message will be displayed in logs and can be broadcast to rooms. | |
| taskId | No | Optional ID of the specific task being reported on. Required when progressType is 'task', 'error', or 'completion'. Used to update task status and progress. | |
| progressPercentage | No | Optional progress percentage (0-100) for task completion. Used with progressType 'task' to track completion progress. Will be validated and capped to 0-100 range. | |
| results | No | Optional key-value pairs of task results or metadata. Used with progressType 'completion' to store task outcomes and artifacts. | |
| error | No | Optional error message when progressType is 'error'. Provides detailed error information for debugging and failure analysis. | |
| roomId | No | Optional room ID to broadcast progress to. If not provided, will use the agent's assigned room from metadata. | |
| broadcastToRoom | No | Whether to broadcast this progress update to the agent's assigned room. Defaults to true. Set to false for internal progress tracking only. |