refactoring folders

lib/elixir_ai/application.ex

@@ -12,6 +12,8 @@ defmodule ElixirAi.Application do
        [Application.get_env(:libcluster, :topologies, []), [name: ElixirAi.ClusterSupervisor]]},
       {Phoenix.PubSub, name: ElixirAi.PubSub},
       {ElixirAi.LiveViewPG, []},
+      {ElixirAi.RunnerPG, []},
+      {ElixirAi.SingletonPG, []},
       {ElixirAi.PageToolsPG, []},
       {ElixirAi.AudioProcessingPG, []},
       {DynamicSupervisor, name: ElixirAi.AudioWorkerSupervisor, strategy: :one_for_one},

lib/elixir_ai/chat_runner/chat_runner.ex

@@ -68,6 +68,7 @@ defmodule ElixirAi.ChatRunner do
 
   def init(name) do
     Phoenix.PubSub.subscribe(ElixirAi.PubSub, conversation_message_topic(name))
+    :pg.join(ElixirAi.RunnerPG, {:runner, name}, self())
 
     messages =
       case Conversation.find_id(name) do

lib/elixir_ai/chat_runner/runner_pg.ex

@@ -1,7 +1,7 @@
-defmodule ElixirAi.LiveViewPG do
+defmodule ElixirAi.RunnerPG do
   @moduledoc """
-  Named :pg scope for tracking LiveView processes across the cluster.
-  Each LiveView joins {:liveview, ViewModule} on connect; :pg syncs membership
+  Named :pg scope for tracking ChatRunner processes across the cluster.
+  Each ChatRunner joins {:runner, name} on init; :pg syncs membership
   automatically and removes dead processes without any additional cleanup.
   """
 

lib/elixir_ai/chat_runner/stream_handler.ex

@@ -1,183 +0,0 @@
-defmodule ElixirAi.ChatRunner.StreamHandler do
-  require Logger
-  import ElixirAi.ChatRunner.OutboundHelpers
-
-  def handle({:start_new_ai_response, id}, state) do
-    starting_response = %{id: id, reasoning_content: "", content: "", tool_calls: []}
-    broadcast_ui(state.name, {:start_ai_response_stream, starting_response})
-    {:noreply, %{state | streaming_response: starting_response}}
-  end
-
-  def handle({:ai_reasoning_chunk, _id, reasoning_content}, state) do
-    broadcast_ui(state.name, {:reasoning_chunk_content, reasoning_content})
-
-    {:noreply,
-     %{
-       state
-       | streaming_response: %{
-           state.streaming_response
-           | reasoning_content: state.streaming_response.reasoning_content <> reasoning_content
-         }
-     }}
-  end
-
-  def handle({:ai_text_chunk, _id, text_content}, state) do
-    broadcast_ui(state.name, {:text_chunk_content, text_content})
-
-    {:noreply,
-     %{
-       state
-       | streaming_response: %{
-           state.streaming_response
-           | content: state.streaming_response.content <> text_content
-         }
-     }}
-  end
-
-  def handle({:ai_text_stream_finish, _id}, state) do
-    Logger.info(
-      "AI stream finished for id #{state.streaming_response.id}, broadcasting end of AI response"
-    )
-
-    final_message = %{
-      role: :assistant,
-      content: state.streaming_response.content,
-      reasoning_content: state.streaming_response.reasoning_content,
-      tool_calls: state.streaming_response.tool_calls
-    }
-
-    broadcast_ui(state.name, {:end_ai_response, final_message})
-    store_message(state.name, final_message)
-
-    {:noreply,
-     %{
-       state
-       | streaming_response: nil,
-         messages: state.messages ++ [final_message]
-     }}
-  end
-
-  def handle(
-        {:ai_tool_call_start, _id, {tool_name, tool_args_start, tool_index, tool_call_id}},
-        state
-      ) do
-    Logger.info("AI started tool call #{tool_name}")
-
-    new_streaming_response = %{
-      state.streaming_response
-      | tool_calls:
-          state.streaming_response.tool_calls ++
-            [
-              %{
-                name: tool_name,
-                arguments: tool_args_start,
-                index: tool_index,
-                id: tool_call_id
-              }
-            ]
-    }
-
-    {:noreply, %{state | streaming_response: new_streaming_response}}
-  end
-
-  def handle({:ai_tool_call_middle, _id, {tool_args_diff, tool_index}}, state) do
-    new_streaming_response = %{
-      state.streaming_response
-      | tool_calls:
-          Enum.map(state.streaming_response.tool_calls, fn
-            %{arguments: existing_args, index: ^tool_index} = tool_call ->
-              %{tool_call | arguments: existing_args <> tool_args_diff}
-
-            other ->
-              other
-          end)
-    }
-
-    {:noreply, %{state | streaming_response: new_streaming_response}}
-  end
-
-  def handle({:ai_tool_call_end, id}, state) do
-    tool_request_message = %{
-      role: :assistant,
-      content: state.streaming_response.content,
-      reasoning_content: state.streaming_response.reasoning_content,
-      tool_calls: state.streaming_response.tool_calls
-    }
-
-    broadcast_ui(state.name, {:tool_request_message, tool_request_message})
-
-    {failed_call_messages, pending_call_ids} =
-      Enum.reduce(state.streaming_response.tool_calls, {[], []}, fn tool_call,
-                                                                    {failed, pending} ->
-        with {:ok, decoded_args} <- Jason.decode(tool_call.arguments),
-             tool when not is_nil(tool) <-
-               Enum.find(state.server_tools ++ state.liveview_tools ++ state.page_tools, fn t ->
-                 t.name == tool_call.name
-               end) do
-          tool.run_function.(id, tool_call.id, decoded_args)
-          {failed, [tool_call.id | pending]}
-        else
-          {:error, e} ->
-            error_msg = "Failed to decode tool arguments: #{inspect(e)}"
-            Logger.error("Tool call #{tool_call.name} failed: #{error_msg}")
-            {[%{role: :tool, content: error_msg, tool_call_id: tool_call.id} | failed], pending}
-
-          nil ->
-            error_msg = "No tool definition found for #{tool_call.name}"
-            Logger.error(error_msg)
-            {[%{role: :tool, content: error_msg, tool_call_id: tool_call.id} | failed], pending}
-        end
-      end)
-
-    store_message(state.name, [tool_request_message] ++ failed_call_messages)
-
-    {:noreply,
-     %{
-       state
-       | messages: state.messages ++ [tool_request_message] ++ failed_call_messages,
-         pending_tool_calls: pending_call_ids
-     }}
-  end
-
-  def handle({:tool_response, _id, tool_call_id, result}, state) do
-    new_message = %{role: :tool, content: inspect(result), tool_call_id: tool_call_id}
-
-    broadcast_ui(state.name, {:one_tool_finished, new_message})
-    store_message(state.name, new_message)
-
-    new_pending_tool_calls =
-      Enum.filter(state.pending_tool_calls, fn id -> id != tool_call_id end)
-
-    new_streaming_response =
-      case new_pending_tool_calls do
-        [] -> nil
-        _ -> state.streaming_response
-      end
-
-    if new_pending_tool_calls == [] do
-      broadcast_ui(state.name, :tool_calls_finished)
-
-      ElixirAi.ChatUtils.request_ai_response(
-        self(),
-        messages_with_system_prompt(state.messages ++ [new_message], state.system_prompt),
-        state.server_tools ++ state.liveview_tools ++ state.page_tools,
-        state.provider,
-        state.tool_choice
-      )
-    end
-
-    {:noreply,
-     %{
-       state
-       | pending_tool_calls: new_pending_tool_calls,
-         streaming_response: new_streaming_response,
-         messages: state.messages ++ [new_message]
-     }}
-  end
-
-  def handle({:ai_request_error, reason}, state) do
-    Logger.error("AI request error: #{inspect(reason)}")
-    broadcast_ui(state.name, {:ai_request_error, reason})
-    {:noreply, %{state | streaming_response: nil, pending_tool_calls: []}}
-  end
-end

lib/elixir_ai/cluster_singleton/singleton_pg.ex

@@ -0,0 +1,16 @@
+defmodule ElixirAi.SingletonPG do
+  @moduledoc """
+  Named :pg scope for tracking cluster singleton processes across the cluster.
+  Each singleton joins {:singleton, __MODULE__} on init; :pg syncs membership
+  automatically and removes dead processes without any additional cleanup.
+  """
+
+  def child_spec(_opts) do
+    %{
+      id: __MODULE__,
+      start: {:pg, :start_link, [__MODULE__]},
+      type: :worker,
+      restart: :permanent
+    }
+  end
+end

lib/elixir_ai/conversation_manager.ex

@@ -20,6 +20,7 @@ defmodule ElixirAi.ConversationManager do
 
   def init(_) do
     Logger.info("ConversationManager initializing...")
+    :pg.join(ElixirAi.SingletonPG, {:singleton, __MODULE__}, self())
     send(self(), :load_conversations)
     {:ok, %{conversations: :loading, subscriptions: MapSet.new(), runners: %{}}}
   end

lib/elixir_ai/page_tools_pg.ex

@@ -1,15 +0,0 @@
-defmodule ElixirAi.PageToolsPG do
-  @moduledoc """
-  Named :pg scope for tracking LiveViews that implement AiControllable.
-  Group key is `{:page, voice_session_id}` — one group per browser session.
-  """
-
-  def child_spec(_opts) do
-    %{
-      id: __MODULE__,
-      start: {:pg, :start_link, [__MODULE__]},
-      type: :worker,
-      restart: :permanent
-    }
-  end
-end