/*********************************************************************/
/*                                                                   */
/*                     AgentService Framework                        */
/*                       www.agentservice.it                         */
/*                                                                   */
/* Copyright (C) 2007 l.i.d.o. - DIST, University of Genoa, Italy    */
/* GNU Lesser General Public License                                 */
/*                                                                   */
/* This library is free software; you can redistribute it and/or     */
/* modify it under the terms of the GNU Lesser General Public        */
/* License as published by the Free Software Foundation,             */
/* version 2.1 of the License.                                       */
/*                                                                   */
/* This library is distributed in the hope that it will be useful,   */
/* but WITHOUT ANY WARRANTY; without even the implied warranty of    */
/* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU */
/* Lesser General Public License for more details.                   */
/*                                                                   */
/* You should have received a copy of the GNU Lesser General Public  */
/* License along with this library; if not, write to the             */
/* Free Software Foundation, Inc., 59 Temple Place - Suite 330,      */
/* Boston, MA  02111-1307, USA.                                      */
/*                                                                   */
/*********************************************************************/
using AgentService;
using AgentService.Agent;

namespace AgentService.Agent.Runtime
{
	/// <summary>
	/// Interface IAgentEventProxy. Offers a safe
	/// and controlled access for runtime components
	/// to the agent's events.
	/// </summary>
	public interface IAgentEventProxy 
	{
		/// <summary>
		/// Fires when the agent is activated.
		/// </summary>
		event AgentDelegate OnActivateAgent;
		/// <summary>
		/// Fires when the agent is stopped.
		/// </summary>
		event AgentDelegate OnStopAgent;
		/// <summary>
		/// Fires when the system reosurces of the agent
		/// need to be released.
		/// </summary>
		event AgentDelegate OnReleaseAgent;
		/// <summary>
		/// Fires when the agent is terminated.
		/// </summary>
		event AgentDelegate OnTerminateAgent; 
		/// <summary>
		/// Fires when a new behaviour in the agent is
		/// created.
		/// </summary>
		event BehaviourDelegate OnNewBehaviour;
		/// <summary>
		/// Fires when an agent's behaviour is started.
		/// </summary>
		event BehaviourDelegate OnStartBehaviour;
		/// <summary>
		/// Fires when an agent's behaviour is suspended.
		/// </summary>
		event BehaviourDelegate OnSuspendBehaviour;
		/// <summary>
		/// Fires when an agent's behaviour is terminated.
		/// </summary>
		event BehaviourDelegate OnTerminateBehaviour;
	
	}

	/// <summary>
	/// <p>
	/// Interface IRuntimeBindable. Defines a
	/// contract for runtime components that
	/// specifies how to attach to the events
	/// of the agent class.
	/// </p>
	/// <p>
	/// This interface avoids direct references
	/// to agent instances.
	/// </p>
	/// </summary>
	public interface IRuntimeBindable 
	{
		/// <summary>
		/// Connects the runtime component to the events
		/// originated by the agent instance.
		/// </summary>
		/// <param name="proxy">proxy to the agent instance</param>
		void BindEvents(IAgentEventProxy proxy);
		/// <summary>
		/// Disconnects the runtime component to the events
		/// originated by the agent instance.
		/// </summary>
		/// <param name="proxy">proxy to the agent instance</param>
		void UnbindEvents(IAgentEventProxy proxy);
	}
}