← back to examples
core beginner

Emit Directive Agent

Focused example showing how actions emit domain events while still updating agent state in one step.

signals directives emit core-mechanics l1

Related guides and notebooks

Concept
Directives
Review built-in directives and effect modeling.
Concept
Signals
Understand signal structure and dispatch.
Next
Build your first workflow
Combine emits into multi-step workflows.
Livebook
Build your first workflow
Run the companion notebook in Livebook
Explanation

What this example teaches

Interactive Demo

Run the agent and inspect state

Source Code

Read the production implementation

emit_directive_agent.ex create_order_action.ex process_payment_action.ex multi_emit_action.ex emit_directive_agent_live.ex
lib/agent_jido/demos/emit_directive/emit_directive_agent.ex 31 lines 
defmodule AgentJido.Demos.EmitDirectiveAgent do
  @moduledoc """
  Demo agent for `Directive.Emit` patterns.
  """

  alias AgentJido.Demos.EmitDirective.{
    CreateOrderAction,
    MultiEmitAction,
    ProcessPaymentAction
  }

  use Jido.Agent,
    name: "emit_directive_agent",
    description: "Shows state updates alongside emitted domain events",
    schema: [
      orders: [type: {:list, :map}, default: []],
      last_order_id: [type: :string, default: ""],
      last_payment: [type: :map, default: %{}],
      emitted_count: [type: :integer, default: 0]
    ],
    signal_routes: [
      {"create_order", CreateOrderAction},
      {"process_payment", ProcessPaymentAction},
      {"multi_emit", MultiEmitAction}
    ]

  @doc false
  @spec plugin_specs() :: nonempty_list(Jido.Plugin.Spec.t())
  def plugin_specs, do: super()
end