huginn/app/models/agents/manual_event_agent.rb

module Agents
  class ManualEventAgent < Agent
    cannot_be_scheduled!
    cannot_receive_events!

    description <<-MD
      The Manual Event Agent is used to manually create Events for testing or other purposes.

      Do not set options for this Agent.  Instead, connect it to other Agents and create Events
      using the UI provided on this Agent's Summary page.
    MD

    event_description "User determined"

    def default_options
      { "no options" => "are needed" }
    end

    def handle_details_post(params)
      if params['payload']
        json = interpolate_options(JSON.parse(params['payload']))
        if json['payloads'] && (json.keys - ['payloads']).length > 0
          { :success => false, :error => "If you provide the 'payloads' key, please do not provide any other keys at the top level." }
        else
          [json['payloads'] || json].flatten.each do |payload|
            create_event(:payload => payload)
          end
          { :success => true }
        end
      else
        { :success => false, :error => "You must provide a JSON payload" }
      end
    end

    def working?
      true
    end

    def validate_options
    end
  end
end