MingaAgent.Hooks.Dispatcher (Minga v0.1.0)

Dispatches normalized agent hooks for lifecycle events.

The dispatcher is intentionally stateless. It receives a list of hooks from MingaAgent.Config, filters matching hooks in registration order, and asks a runner to execute each hook. For veto-capable events the first veto short-circuits later hooks; for notification-only events vetoes are broadcast as events and logged as warnings but do not block.

Summary

Types

runner()

Hook runner used by tests and production command execution.

Functions

dispatch(event, hooks, payload_map, opts \\ [])

Runs all matching hooks for an event in registration order.

notification(hooks, payload_map, opts \\ [])

Runs all matching Notification hooks (notification-only).

post_tool_use(hooks, payload_map, opts \\ [])

Runs all matching PostToolUse hooks (notification-only).

pre_compact(hooks, payload_map, opts \\ [])

Runs all matching PreCompact hooks (veto-capable).

pre_tool_use(hooks, payload)

Runs all matching PreToolUse hooks in registration order.

pre_tool_use(hooks, payload, opts)

Runs matching PreToolUse hooks with an injected runner.

session_end(hooks, payload_map, opts \\ [])

Runs all matching SessionEnd hooks (notification-only).

session_start(hooks, payload_map, opts \\ [])

Runs all matching SessionStart hooks (notification-only).

stop(hooks, payload_map, opts \\ [])

Runs all matching Stop hooks (notification-only).

user_prompt_submit(hooks, payload_map, opts \\ [])

Runs all matching UserPromptSubmit hooks (veto-capable).

Types

runner()

@type runner() :: (MingaAgent.Hooks.Hook.t(), map() -> MingaAgent.Hooks.Result.t())

Hook runner used by tests and production command execution.

Functions

dispatch(event, hooks, payload_map, opts \\ [])

@spec dispatch(
  MingaAgent.Hooks.Hook.event(),
  [MingaAgent.Hooks.Hook.t()],
  map(),
  keyword()
) ::
  :ok | {:error, MingaAgent.Hooks.Result.t()}

Runs all matching hooks for an event in registration order.

notification(hooks, payload_map, opts \\ [])

@spec notification([MingaAgent.Hooks.Hook.t()], map(), keyword()) :: :ok

Runs all matching Notification hooks (notification-only).

post_tool_use(hooks, payload_map, opts \\ [])

@spec post_tool_use([MingaAgent.Hooks.Hook.t()], map(), keyword()) :: :ok

Runs all matching PostToolUse hooks (notification-only).

pre_compact(hooks, payload_map, opts \\ [])

@spec pre_compact([MingaAgent.Hooks.Hook.t()], map(), keyword()) ::
  :ok | {:error, MingaAgent.Hooks.Result.t()}

Runs all matching PreCompact hooks (veto-capable).

pre_tool_use(hooks, payload)

@spec pre_tool_use(
  [MingaAgent.Hooks.Hook.t()],
  MingaAgent.Hooks.PreToolUsePayload.t()
) ::
  :ok | {:error, MingaAgent.Hooks.Result.t()}

Runs all matching PreToolUse hooks in registration order.

pre_tool_use(hooks, payload, opts)

@spec pre_tool_use(
  [MingaAgent.Hooks.Hook.t()],
  MingaAgent.Hooks.PreToolUsePayload.t(),
  keyword()
) ::
  :ok | {:error, MingaAgent.Hooks.Result.t()}

Runs matching PreToolUse hooks with an injected runner.

session_end(hooks, payload_map, opts \\ [])

@spec session_end([MingaAgent.Hooks.Hook.t()], map(), keyword()) :: :ok

Runs all matching SessionEnd hooks (notification-only).

session_start(hooks, payload_map, opts \\ [])

@spec session_start([MingaAgent.Hooks.Hook.t()], map(), keyword()) :: :ok

Runs all matching SessionStart hooks (notification-only).

stop(hooks, payload_map, opts \\ [])

@spec stop([MingaAgent.Hooks.Hook.t()], map(), keyword()) :: :ok

Runs all matching Stop hooks (notification-only).

user_prompt_submit(hooks, payload_map, opts \\ [])

@spec user_prompt_submit([MingaAgent.Hooks.Hook.t()], map(), keyword()) ::
  :ok | {:error, MingaAgent.Hooks.Result.t()}

Runs all matching UserPromptSubmit hooks (veto-capable).