FoundationAgents/OpenManus · error · ToolError

Parameter `step_index` is required for command: mark_step

Error message

Parameter `step_index` is required for command: mark_step

What it means

Error "Parameter `step_index` is required for command: mark_step" thrown in FoundationAgents/OpenManus.

Source

Thrown at app/tool/planning.py:277

        plan_id: Optional[str],
        step_index: Optional[int],
        step_status: Optional[str],
        step_notes: Optional[str],
    ) -> ToolResult:
        """Mark a step with a specific status and optional notes."""
        if not plan_id:
            # If no plan_id is provided, use the current active plan
            if not self._current_plan_id:
                raise ToolError(
                    "No active plan. Please specify a plan_id or set an active plan."
                )
            plan_id = self._current_plan_id

        if plan_id not in self.plans:
            raise ToolError(f"No plan found with ID: {plan_id}")

        if step_index is None:
            raise ToolError("Parameter `step_index` is required for command: mark_step")

        plan = self.plans[plan_id]

        if step_index < 0 or step_index >= len(plan["steps"]):
            raise ToolError(
                f"Invalid step_index: {step_index}. Valid indices range from 0 to {len(plan['steps'])-1}."
            )

        if step_status and step_status not in [
            "not_started",
            "in_progress",
            "completed",
            "blocked",
        ]:
            raise ToolError(
                f"Invalid step_status: {step_status}. Valid statuses are: not_started, in_progress, completed, blocked"
            )

View on GitHub (pinned to 52a13f2a57)

Solutions

1. Pass the `step_index` parameter when calling the planning tool with command `mark_step`.
2. Use a zero-based integer index into the plan's steps list; call `get` or `list` first to see the valid indices.

When it happens

Trigger: Raised when the `mark_step` command is invoked on the planning tool without supplying the required `step_index` parameter.

Common situations: See trigger scenarios.

AI-assisted analysis of FoundationAgents/OpenManus@52a13f2a57 (2026-08-15). Data as JSON: /api/errors/646b72aa6269ef47. Report an issue: GitHub.