pbx 0.1.0

data/lib/pbx/status.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Pbx
+  module Status
+    STATUS_COLORS = {
+      "registered" => "#22c55e",
+      "reachable" => "#22c55e",
+      "lagged" => "#f59e0b",
+      "unreachable" => "#ef4444",
+      "unregistered" => "#6b7280",
+      "unmonitored" => "#6b7280",
+      "unknown" => "#6b7280"
+    }.freeze
+
+    STATUS_LABELS = {
+      "registered" => "Registered",
+      "reachable" => "Reachable",
+      "lagged" => "Lagged",
+      "unreachable" => "Unreachable",
+      "unregistered" => "Unregistered",
+      "unmonitored" => "Unmonitored",
+      "unknown" => "Unknown"
+    }.freeze
+
+    def self.describe(status)
+      STATUS_LABELS[status.to_s.downcase] || status.to_s.capitalize
+    end
+
+    def self.color(status)
+      STATUS_COLORS[status.to_s.downcase] || "#6b7280"
+    end
+
+    # Normalises the raw AMI Status string from SIPpeers/PeerStatus into a
+    # lowercase key used by describe/color.
+    def self.from_sip(raw)
+      return "unknown" unless raw
+
+      s = raw.to_s.downcase
+      return "registered" if s.start_with?("ok")
+      return "unreachable" if s.include?("unreachable")
+      return "lagged" if s.include?("lagged")
+      return "unregistered" if s.include?("unregistered")
+      return "unmonitored" if s.include?("unmonitored")
+      return "registered" if s.include?("registered") || s.include?("reachable")
+
+      "unknown"
+    end
+
+    QUEUE_MEMBER_STATES = {
+      "1" => "not_in_use",
+      "2" => "in_use",
+      "3" => "busy",
+      "5" => "unavailable",
+      "6" => "ringing",
+      "8" => "on_hold"
+    }.freeze
+
+    def self.queue_member_state(code)
+      QUEUE_MEMBER_STATES[code.to_s] || "unknown"
+    end
+
+    # Maps PJSIP DeviceState strings ("Not in use", "In use", "Unavailable"…)
+    # to the same internal keys used by describe/color.
+    # Any reachable state (in use, ringing, on hold…) maps to "registered" so
+    # the peers table shows the endpoint as up.
+    def self.from_pjsip_device_state(raw)
+      return "unknown" unless raw
+
+      s = raw.to_s.downcase
+      return "unknown" if s.empty?
+      return "unreachable" if s.include?("unavailable") || s.include?("invalid")
+
+      "registered"
+    end
+
+    # Extracts the RTT in milliseconds from strings like "OK (5 ms)".
+    def self.rtt_from_sip(raw)
+      return nil unless raw
+
+      match = raw.match(/\((\d+)\s*ms\)/i)
+      match ? match[1].to_i : nil
+    end
+  end
+end

data/lib/pbx/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Pbx
+  VERSION = "0.1.0"
+end

data/lib/pbx/views/active_calls.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "lipgloss"
+require "bubbles"
+
+module Pbx
+  module Views
+    module ActiveCalls
+      COLUMNS = [
+        {title: "Channel", width: 14},
+        {title: "State", width: 14},
+        {title: "App", width: 14},
+        {title: "With", width: 18},
+        {title: "For", width: 10}
+      ].freeze
+
+      HEADER_STYLE = Lipgloss::Style.new.bold(true).foreground("#f59e0b")
+      SELECTED_STYLE = Lipgloss::Style.new.bold(true).foreground("#ffffff").background("#d97706")
+      TITLE_STYLE = Lipgloss::Style.new.bold(true).foreground("#f59e0b").padding(0, 1)
+      SEP_STYLE = Lipgloss::Style.new.foreground("#4b5563")
+
+      STATE_SYMBOLS = {
+        "up" => "▶",
+        "ringing" => "◎",
+        "ring" => "◎",
+        "dialing" => "→",
+        "offhook" => "·"
+      }.freeze
+
+      OUTCOME_SYMBOLS = {
+        "ANSWER" => "▶",
+        "BUSY" => "✕",
+        "NOANSWER" => "⌀",
+        "CANCEL" => "←",
+        "CHANUNAVAIL" => "✗",
+        "CONGESTION" => "!"
+      }.freeze
+
+      OUTCOME_LABELS = {
+        "BUSY" => "Busy",
+        "NOANSWER" => "No answer",
+        "CANCEL" => "Cancelled",
+        "CHANUNAVAIL" => "Unavailable",
+        "CONGESTION" => "Congestion"
+      }.freeze
+
+      def self.render(calls, width, table_height = 1, table: nil)
+        sep = SEP_STYLE.render("─" * [width, 1].max)
+        title = TITLE_STYLE.render("Active Calls (#{calls.size})")
+        t = table || build(calls, table_height)
+        Lipgloss.join_vertical(:left, sep, title, t.view)
+      end
+
+      def self.build(calls, table_height)
+        rows = calls.values
+          .sort_by { |c| c.started_at || Time.now }
+          .map { |call|
+            [
+              short_channel(call.channel),
+              state_text(call),
+              call.dialplan_app || "—",
+              call.connected_to.to_s.empty? ? "—" : call.connected_to,
+              duration(call.started_at)
+            ]
+          }
+
+        Bubbles::Table.new(columns: COLUMNS, rows: rows, height: table_height).tap do |t|
+          t.header_style = HEADER_STYLE
+          t.selected_style = SELECTED_STYLE
+        end
+      end
+
+      def self.short_channel(channel)
+        return "—" unless channel
+
+        channel.sub(/\A(SIP|PJSIP)\//i, "").split("-").first || channel
+      end
+
+      def self.state_text(call)
+        return "⏸ Hold" if call.held
+
+        if call.outcome && call.outcome != "ANSWER"
+          sym = OUTCOME_SYMBOLS.fetch(call.outcome, "?")
+          label = OUTCOME_LABELS.fetch(call.outcome, call.outcome.downcase.capitalize)
+          return "#{sym} #{label}"
+        end
+
+        key = call.state.to_s.downcase
+        symbol = STATE_SYMBOLS.fetch(key, "·")
+        "#{symbol} #{call.state.to_s.capitalize}"
+      end
+
+      def self.duration(started_at)
+        return "—" unless started_at
+
+        secs = (Time.now - started_at).to_i
+        "#{secs / 60}m #{(secs % 60).to_s.rjust(2, "0")}s"
+      end
+    end
+  end
+end

data/lib/pbx/views/disconnected_screen.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require "lipgloss"
+
+module Pbx
+  module Views
+    module DisconnectedScreen
+      ICON_STYLE = Lipgloss::Style.new
+        .foreground("#4b5563")
+        .bold(true)
+
+      TITLE_STYLE = Lipgloss::Style.new
+        .foreground("#9ca3af")
+        .bold(true)
+
+      BODY_STYLE = Lipgloss::Style.new
+        .foreground("#6b7280")
+
+      CODE_STYLE = Lipgloss::Style.new
+        .foreground("#a78bfa")
+        .bold(true)
+
+      HINT_STYLE = Lipgloss::Style.new
+        .foreground("#4b5563")
+        .italic(true)
+
+      BOX_STYLE = Lipgloss::Style.new
+        .border(:rounded)
+        .border_foreground("#374151")
+        .padding(1, 3)
+        .margin(1, 2)
+
+      def self.call(state)
+        missing = missing_params(state.config)
+
+        lines = [
+          ICON_STYLE.render("◌") + "  " + TITLE_STYLE.render("No connection configured"),
+          "",
+          BODY_STYLE.render("Missing parameters: ") + missing.map { |p| CODE_STYLE.render("--#{p}") }.join("  "),
+          "",
+          BODY_STYLE.render("Example:"),
+          "  " + CODE_STYLE.render("pbx monitor --host 192.168.1.10 --user admin --secret s3cret"),
+          "",
+          HINT_STYLE.render("or use a config file:"),
+          "  " + CODE_STYLE.render("pbx monitor --config /path/to/pbx.yml")
+        ]
+
+        BOX_STYLE.render(lines.join("\n"))
+      end
+
+      def self.missing_params(config)
+        params = []
+        params << "host" if config.host == "127.0.0.1"
+        params << "user" if config.user.to_s.strip.empty?
+        params << "secret" if config.secret.to_s.strip.empty?
+        params
+      end
+    end
+  end
+end

data/lib/pbx/views/extension_table.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require "lipgloss"
+require "bubbles"
+require_relative "../status"
+
+module Pbx
+  module Views
+    module ExtensionTable
+      COLUMNS = [
+        {title: "Peer", width: 16},
+        {title: "Status", width: 14},
+        {title: "IP Address", width: 17},
+        {title: "Port", width: 6},
+        {title: "Type", width: 8},
+        {title: "RTT (ms)", width: 9},
+        {title: "Changed", width: 12}
+      ].freeze
+
+      HEADER_STYLE = Lipgloss::Style.new.bold(true).foreground("#a78bfa")
+      SELECTED_STYLE = Lipgloss::Style.new.bold(true).foreground("#ffffff").background("#7c3aed")
+
+      EMPTY_STYLE = Lipgloss::Style.new.foreground("#6b7280").italic(true).padding(2, 4)
+
+      STATUS_DOTS = {
+        "registered" => "●",
+        "reachable" => "●",
+        "lagged" => "◑",
+        "unreachable" => "○",
+        "unregistered" => "·",
+        "unmonitored" => "·",
+        "unknown" => "·"
+      }.freeze
+
+      def self.build(peers, table_height)
+        rows = peers.values.sort_by(&:name).map { |peer|
+          [
+            peer.name,
+            status_text(peer.status),
+            peer.ip_address || "—",
+            peer.ip_port&.to_s || "—",
+            peer.type || "—",
+            peer.rtt_ms&.to_s || "—",
+            since(peer.last_change_at)
+          ]
+        }
+
+        Bubbles::Table.new(columns: COLUMNS, rows: rows, height: table_height).tap do |t|
+          t.header_style = HEADER_STYLE
+          t.selected_style = SELECTED_STYLE
+        end
+      end
+
+      def self.render_empty
+        EMPTY_STYLE.render("No SIP peers discovered yet…")
+      end
+
+      # Plain-text status for table cells — ANSI codes break Bubbles::Table width math.
+      def self.status_text(status)
+        dot = STATUS_DOTS.fetch(status.to_s, "·")
+        label = Status.describe(status)
+        "#{dot} #{label}"
+      end
+
+      # ANSI-colored status for use outside the table (info panels, etc.).
+      def self.colorized_status(status)
+        color = Status.color(status)
+        label = Status.describe(status)
+        Lipgloss::Style.new.foreground(color).bold(true).render(label)
+      end
+
+      def self.since(time)
+        return "—" unless time
+
+        secs = (Time.now - time).to_i
+        return "Just now" if secs < 5
+        return "#{secs}s ago" if secs < 60
+        return "#{secs / 60}m ago" if secs < 3600
+
+        "#{secs / 3600}h ago"
+      end
+    end
+  end
+end

data/lib/pbx/views/footer.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "lipgloss"
+
+module Pbx
+  module Views
+    module Footer
+      HINT_STYLE = Lipgloss::Style.new.foreground("#6b7280").faint(true)
+      KEY_STYLE = Lipgloss::Style.new.foreground("#9ca3af").bold(true)
+      SEP_STYLE = Lipgloss::Style.new.foreground("#4b5563")
+
+      ACTIVE_KEY_STYLE = Lipgloss::Style.new.foreground("#f59e0b").bold(true)
+
+      def self.call(state)
+        sep = SEP_STYLE.render("─" * ((state.width > 0) ? state.width : 80))
+        hints = build_hints(state)
+
+        right = if state.status == :disconnected
+          HINT_STYLE.render("pbx monitor --host HOST --user USER --secret SECRET")
+        else
+          HINT_STYLE.render("#{state.extensions.size} extension(s)")
+        end
+
+        bar = Lipgloss.join_horizontal(:center, hints, "   ", right)
+        Lipgloss.join_vertical(:left, sep, bar)
+      end
+
+      def self.build_hints(state)
+        connected = state.status == :connected
+
+        tab_peers = tab_hint("p", "peers", connected && state.view_mode == :peers)
+        tab_calls = tab_hint("c", "calls", connected && state.view_mode == :calls)
+        tab_queues = tab_hint("q", "queues", connected && state.view_mode == :queues)
+
+        static = [
+          "#{KEY_STYLE.render("↑/↓")} #{HINT_STYLE.render("scroll")}",
+          "#{KEY_STYLE.render("i")} #{HINT_STYLE.render("info")}",
+          "#{KEY_STYLE.render("e/Esc")} #{HINT_STYLE.render("quit")}"
+        ]
+
+        ([tab_peers, tab_calls, tab_queues] + static).join("  ")
+      end
+
+      def self.tab_hint(key, label, active)
+        key_s = active ? ACTIVE_KEY_STYLE.render(key) : KEY_STYLE.render(key)
+        lbl_s = active ? ACTIVE_KEY_STYLE.render(label) : HINT_STYLE.render(label)
+        "#{key_s} #{lbl_s}"
+      end
+    end
+  end
+end

data/lib/pbx/views/header.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "lipgloss"
+
+module Pbx
+  module Views
+    module Header
+      TITLE_STYLE = Lipgloss::Style.new
+        .bold(true)
+        .foreground("#7c3aed")
+        .padding(0, 1)
+
+      STATUS_DISCONNECTED_STYLE = Lipgloss::Style.new.foreground("#6b7280").italic(true)
+      STATUS_CONNECTING_STYLE = Lipgloss::Style.new.foreground("#f59e0b").italic(true)
+      STATUS_CONNECTED_STYLE = Lipgloss::Style.new.foreground("#22c55e").bold(true)
+      STATUS_LOST_STYLE = Lipgloss::Style.new.foreground("#ef4444").bold(true)
+
+      SEPARATOR_STYLE = Lipgloss::Style.new.foreground("#4b5563")
+      SYSINFO_STYLE = Lipgloss::Style.new.foreground("#6b7280")
+
+      def self.call(state)
+        title = TITLE_STYLE.render("PBX Monitor")
+        remote = "#{state.config.host}:#{state.config.port}"
+        status = case state.status
+        when :disconnected then STATUS_DISCONNECTED_STYLE.render("◌  Disconnected")
+        when :connecting then STATUS_CONNECTING_STYLE.render("#{state.spinner_view}  Connecting to #{remote}…")
+        when :connected then STATUS_CONNECTED_STYLE.render("● #{remote}")
+        when :lost then STATUS_LOST_STYLE.render("✗ #{remote}  #{state.error}")
+        end
+
+        sysinfo = build_sysinfo(state)
+        line = if sysinfo
+          Lipgloss.join_horizontal(:center, title, "  ", status, "  ", sysinfo)
+        else
+          Lipgloss.join_horizontal(:center, title, "  ", status)
+        end
+        sep = SEPARATOR_STYLE.render("─" * ((state.width > 0) ? state.width : 80))
+        Lipgloss.join_vertical(:left, line, sep)
+      end
+
+      def self.build_sysinfo(state)
+        return nil unless state.system_boot_at || state.last_reload_at
+
+        parts = []
+        parts << "Up #{format_duration((Time.now - state.system_boot_at).to_i)}" if state.system_boot_at
+        parts << "Reload #{format_duration((Time.now - state.last_reload_at).to_i)}" if state.last_reload_at
+        SYSINFO_STYLE.render(parts.join("  ·  "))
+      end
+
+      def self.format_duration(secs)
+        d = secs / 86_400
+        h = (secs % 86_400) / 3_600
+        m = (secs % 3_600) / 60
+
+        parts = []
+        parts << "#{d}d" if d > 0
+        parts << "#{h}h" if h > 0 || d > 0
+        parts << "#{m}m"
+        parts.join(" ")
+      end
+    end
+  end
+end

data/lib/pbx/views/info_modal.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "lipgloss"
+require_relative "../version"
+
+module Pbx
+  module Views
+    module InfoModal
+      TITLE_STYLE = Lipgloss::Style.new
+        .bold(true)
+        .foreground("#a78bfa")
+        .align(:center)
+
+      VERSION_STYLE = Lipgloss::Style.new
+        .foreground("#6b7280")
+        .align(:center)
+
+      LABEL_STYLE = Lipgloss::Style.new
+        .foreground("#9ca3af")
+
+      VALUE_STYLE = Lipgloss::Style.new
+        .foreground("#e5e7eb")
+        .bold(true)
+
+      URL_STYLE = Lipgloss::Style.new
+        .foreground("#60a5fa")
+        .underline(true)
+
+      HINT_STYLE = Lipgloss::Style.new
+        .foreground("#4b5563")
+        .italic(true)
+        .align(:center)
+
+      BOX_STYLE = Lipgloss::Style.new
+        .border(:rounded)
+        .border_foreground("#7c3aed")
+        .padding(1, 4)
+
+      REPO_URL = "https://github.com/emilianodellacasa/pbx"
+
+      def self.call(state)
+        inner_width = 36
+
+        title = TITLE_STYLE.width(inner_width).render("PBX Monitor")
+        version = VERSION_STYLE.width(inner_width).render("v#{Pbx::VERSION}")
+
+        divider = Lipgloss::Style.new.foreground("#374151").render("─" * inner_width)
+
+        author_row = "#{LABEL_STYLE.render("Author")}  #{VALUE_STYLE.render("Emiliano Della Casa")}"
+        repo_row = "#{LABEL_STYLE.render("GitHub")}  #{URL_STYLE.render(REPO_URL)}"
+
+        hint = HINT_STYLE.width(inner_width).render("Press any key to close")
+
+        content = Lipgloss.join_vertical(
+          :center,
+          title,
+          version,
+          "",
+          divider,
+          "",
+          author_row,
+          repo_row,
+          "",
+          hint
+        )
+
+        modal = BOX_STYLE.render(content)
+
+        w = (state.width > 0) ? state.width : 80
+        h = (state.height > 0) ? state.height : 24
+        Lipgloss.place(w, h, :center, :center, modal)
+      end
+    end
+  end
+end

data/lib/pbx/views/queue_table.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require "lipgloss"
+require "bubbles"
+
+module Pbx
+  module Views
+    module QueueTable
+      COLUMNS = [
+        {title: "Queue", width: 16},
+        {title: "Strategy", width: 12},
+        {title: "Waiting", width: 9},
+        {title: "Agents", width: 8},
+        {title: "Completed", width: 11},
+        {title: "Abandoned", width: 11},
+        {title: "Hold", width: 10}
+      ].freeze
+
+      HEADER_STYLE = Lipgloss::Style.new.bold(true).foreground("#34d399")
+      SELECTED_STYLE = Lipgloss::Style.new.bold(true).foreground("#ffffff").background("#059669")
+      TITLE_STYLE = Lipgloss::Style.new.bold(true).foreground("#34d399").padding(0, 1)
+      SEP_STYLE = Lipgloss::Style.new.foreground("#4b5563")
+      EMPTY_STYLE = Lipgloss::Style.new.foreground("#6b7280").italic(true).padding(2, 4)
+
+      def self.render(queues, width, table_height = 1, table: nil)
+        return EMPTY_STYLE.render("No queues discovered yet…") if queues.empty?
+
+        sep = SEP_STYLE.render("─" * [width, 1].max)
+        title = TITLE_STYLE.render("Queues (#{queues.size})")
+        t = table || build(queues, table_height)
+        Lipgloss.join_vertical(:left, sep, title, t.view)
+      end
+
+      def self.build(queues, table_height)
+        rows = queues.values.sort_by(&:name).map { |q|
+          avail = q.members.values.count(&:available?)
+          total = q.members.size
+          [
+            q.name,
+            q.strategy,
+            q.calls_waiting.to_s,
+            "#{avail}/#{total}",
+            q.completed.to_s,
+            q.abandoned.to_s,
+            format_holdtime(q.last_holdtime || q.holdtime)
+          ]
+        }
+
+        Bubbles::Table.new(columns: COLUMNS, rows: rows, height: table_height).tap do |t|
+          t.header_style = HEADER_STYLE
+          t.selected_style = SELECTED_STYLE
+        end
+      end
+
+      def self.format_holdtime(secs)
+        return "—" if secs.nil? || secs == 0
+
+        "#{secs / 60}m #{(secs % 60).to_s.rjust(2, "0")}s"
+      end
+    end
+  end
+end

data/lib/pbx.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative "pbx/version"
+require_relative "pbx/messages"
+require_relative "pbx/peer"
+require_relative "pbx/call"
+require_relative "pbx/call_queue"
+require_relative "pbx/queue_member"
+require_relative "pbx/status"
+require_relative "pbx/config"
+require_relative "pbx/ami_bridge"
+require_relative "pbx/views/header"
+require_relative "pbx/views/extension_table"
+require_relative "pbx/views/footer"
+require_relative "pbx/views/active_calls"
+require_relative "pbx/views/queue_table"
+require_relative "pbx/views/disconnected_screen"
+require_relative "pbx/views/info_modal"
+require_relative "pbx/app"
+require_relative "pbx/cli"