openc3 6.7.0 → 6.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35ed91c6cd987b0a1c139ef5cd9670d204eb524ae7eebdf971d58aef3dbc5faa
-  data.tar.gz: 1a0d8ca81f317a7a5227d56be83ab847bed1a7c4ac48ea991f34ed46a3e80e1d
+  metadata.gz: 0b3a2017659bdea9209911793ce6d8f53c28320df77e9c938e1a3ec6d0e88527
+  data.tar.gz: 950e4c86f740f303186262aa4c808f063219b7097e4b1a0c343aa83da9a71b48
 SHA512:
-  metadata.gz: f305acecd79bfd96b93829a7a3b67b4095ef45104fa7571f5d3c59ac70e753668f0a8e5bde7ad2818c3c22966bf55b524e1fa6bb41a14aa124a2c1f063115781
-  data.tar.gz: 85f4fc3479388969c39cdedcd180498cf1eeb3870d0c609590f4fb6c816d25efdbc02aff4cf499a96da88b3176846a6ba7e08e81dca483659928c475f673be36
+  metadata.gz: a6bcbc2924b4b7b0e7d961a0892f5e74fbb527998527f3c1ae1d7ba4c3213cbda5088864383c25bbebdeca01b09571efb596248d892fb513dc30181bbf376b1c
+  data.tar.gz: 0f42338482eb4069675bee41a29b0396ced047520a7300f7a627dcca2ff0fc483536448860f82e6e99a44a42b09ce64b261604fc35dd586b53ac764352ac9118

data/bin/openc3cli

@@ -24,17 +24,18 @@
 # This file will handle OpenC3 tasks such as instantiating a new project
 
 require 'openc3'
-require 'openc3/utilities/local_mode'
-require 'openc3/utilities/bucket'
-require 'openc3/utilities/cli_generator'
-require 'openc3/models/scope_model'
-require 'openc3/models/plugin_model'
+require 'openc3/bridge/bridge'
 require 'openc3/models/gem_model'
 require 'openc3/models/migration_model'
+require 'openc3/models/plugin_model'
 require 'openc3/models/python_package_model'
+require 'openc3/models/queue_model'
+require 'openc3/models/scope_model'
 require 'openc3/models/tool_model'
 require 'openc3/packets/packet_config'
-require 'openc3/bridge/bridge'
+require 'openc3/utilities/bucket'
+require 'openc3/utilities/cli_generator'
+require 'openc3/utilities/local_mode'
 require 'ostruct'
 require 'optparse'
 require 'openc3/utilities/zip'
@@ -1015,6 +1016,10 @@ if not ARGV[0].nil? # argument(s) given
       end
     end
 
+  when 'createqueue'
+    queue = OpenC3::QueueModel.new(name: ARGV[1], state: 'RELEASE', scope: ARGV[2])
+    queue.create
+
   when 'destroyscope'
     scope = OpenC3::ScopeModel.get_model(name: ARGV[1])
     scope.destroy

data/lib/openc3/api/cmd_api.rb

@@ -14,7 +14,7 @@
 # GNU Affero General Public License for more details.
 
 # Modified by OpenC3, Inc.
-# All changes Copyright 2024, OpenC3, Inc.
+# All changes Copyright 2025, OpenC3, Inc.
 # All Rights Reserved
 #
 # This file may also be used under the terms of a commercial license
@@ -24,6 +24,7 @@
 # See https://github.com/OpenC3/cosmos/pull/1963
 
 require 'openc3/api/interface_api'
+require 'openc3/models/queue_model'
 require 'openc3/models/target_model'
 require 'openc3/topics/command_topic'
 require 'openc3/topics/command_decom_topic'
@@ -452,7 +453,7 @@ module OpenC3
     end
 
     # NOTE: When adding new keywords to this method, make sure to update script/commands.rb
-    def _cmd_implementation(method_name, *args, range_check:, hazardous_check:, raw:, timeout: nil, log_message: nil, manual: false, validate: true,
+    def _cmd_implementation(method_name, *args, range_check:, hazardous_check:, raw:, timeout: nil, log_message: nil, manual: false, validate: true, queue: nil,
                             scope: $openc3_scope, token: $openc3_token, **kwargs)
       extract_string_kwargs_to_args(args, kwargs)
       unless [nil, true, false].include?(log_message)
@@ -538,9 +539,19 @@ module OpenC3
         'log_message' => log_message.to_s,
         'obfuscated_items' => packet['obfuscated_items'].to_s
       }
-      CommandTopic.send_command(command, timeout: timeout, scope: scope)
+      # Users have to explicitly opt into a default queue by setting the OPENC3_DEFAULT_QUEUE
+      # At which point ALL commands will go to that queue unless they specifically opt out with queue: false
+      if ENV['OPENC3_DEFAULT_QUEUE'] && queue.nil?
+        queue = ENV['OPENC3_DEFAULT_QUEUE']
+      end
+      if queue
+        # Pull the command out of the script string, e.g. cmd("INST ABORT")
+        queued = cmd_string.split('("')[1].split('")')[0]
+        QueueModel.queue_command(queue, command: queued, username: username, scope: scope)
+      else
+        CommandTopic.send_command(command, timeout: timeout, scope: scope)
+      end
       return command
     end
-
   end
 end

data/lib/openc3/api/tlm_api.rb

@@ -293,7 +293,8 @@ module OpenC3
               results << [target_name, orig_packet_name, item_name, 'WITH_UNITS'].join('__')
             elsif item['format_string']
               results << [target_name, orig_packet_name, item_name, 'FORMATTED'].join('__')
-            elsif item['read_conversion'] or item['states']
+            # This logic must match the logic in Packet#decom
+            elsif item['states'] or (item['read_conversion'] and item['data_type'] != 'DERIVED')
               results << [target_name, orig_packet_name, item_name, 'CONVERTED'].join('__')
             else
               results << [target_name, orig_packet_name, item_name, 'RAW'].join('__')
@@ -301,13 +302,15 @@ module OpenC3
           when 'FORMATTED'
             if item['format_string']
               results << [target_name, orig_packet_name, item_name, 'FORMATTED'].join('__')
-            elsif item['read_conversion'] or item['states']
+            # This logic must match the logic in Packet#decom
+            elsif item['states'] or (item['read_conversion'] and item['data_type'] != 'DERIVED')
               results << [target_name, orig_packet_name, item_name, 'CONVERTED'].join('__')
             else
               results << [target_name, orig_packet_name, item_name, 'RAW'].join('__')
             end
           when 'CONVERTED'
-            if item['read_conversion'] or item['states']
+            # This logic must match the logic in Packet#decom
+            if item['states'] or (item['read_conversion'] and item['data_type'] != 'DERIVED')
               results << [target_name, orig_packet_name, item_name, 'CONVERTED'].join('__')
             else
               results << [target_name, orig_packet_name, item_name, 'RAW'].join('__')

data/lib/openc3/microservices/interface_microservice.rb

@@ -298,7 +298,7 @@ module OpenC3
                 @interface.write(command)
 
                 command.obfuscate
-                
+
                 if command.validator and validate
                   begin
                     result, reason = command.validator.post_check(command)
@@ -559,6 +559,19 @@ module OpenC3
           target.interface = new_interface
         end
         @interface = new_interface
+
+        # Update the model
+        if @interface_or_router == 'INTERFACE'
+          interface_model = InterfaceModel.get(name: @interface.name, scope: @scope)
+          # config_params[0] is the filename so set the rest
+          interface_model['config_params'][1..-1] = *params
+          InterfaceModel.set(interface_model, scope: @scope)
+        else
+          router_model = RouterModel.get(name: @interface.name, scope: @scope)
+          # config_params[0] is the filename so set the rest
+          router_model['config_params'][1..-1] = *params
+          RouterModel.set(router_model, scope: @scope)
+        end
       end
 
       @interface.state = 'ATTEMPTING'

data/lib/openc3/microservices/queue_microservice.rb

@@ -0,0 +1,166 @@
+# encoding: ascii-8bit
+
+# Copyright 2025 OpenC3, Inc.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU Affero General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# This file may also be used under the terms of a commercial license
+# if purchased from OpenC3, Inc.
+
+require 'openc3/microservices/microservice'
+require 'openc3/topics/queue_topic'
+require 'openc3/utilities/authentication'
+require 'openc3/script'
+
+module OpenC3
+  # The queue processor runs in a single thread and processes commands via cmd_api.
+  class QueueProcessor
+    attr_accessor :state
+    attr_reader :name, :scope
+
+    def initialize(name:, state:, logger:, scope:)
+      @name = name
+      @logger = logger
+      @scope = scope
+      @state = state
+      @cancel_thread = false
+    end
+
+    def get_token(username)
+      if ENV['OPENC3_API_CLIENT'].nil?
+        ENV['OPENC3_API_PASSWORD'] ||= ENV['OPENC3_SERVICE_PASSWORD']
+        return OpenC3Authentication.new().token
+      else
+        # Check for offline access token
+        model = nil
+        model = OpenC3::OfflineAccessModel.get_model(name: username, scope: @scope) if username and username != ''
+        if model and model.offline_access_token
+          auth = OpenC3KeycloakAuthentication.new(ENV['OPENC3_KEYCLOAK_URL'])
+          return auth.get_token_from_refresh_token(model.offline_access_token)
+        else
+          return nil
+        end
+      end
+    end
+
+    def run
+      while true
+        if @state == 'RELEASE'
+          process_queued_commands()
+        else
+          sleep 0.2
+        end
+        break if @cancel_thread
+      end
+    end
+
+    def process_queued_commands
+      while @state == 'RELEASE'
+        begin
+          _queue_name, command_data, _timestamp = Store.bzpopmin("#{@scope}:#{@name}", timeout: 0.2)
+          if command_data
+            command = JSON.parse(command_data)
+            username = command['username']
+            token = get_token(username)
+            # It's important to set queue: false here to avoid infinite recursion when
+            # OPENC3_DEFAULT_QUEUE is set because commands would be re-queued to the default queue
+            cmd_no_hazardous_check(command['value'], queue: false, scope: @scope, token: token)
+          end
+        rescue StandardError => e
+          @logger.error "QueueProcessor failed to process command from queue #{@name}\n#{e.message}"
+        end
+        break if @cancel_thread
+      end
+    end
+
+    def shutdown
+      @cancel_thread = true
+    end
+  end
+
+  # The queue microservice starts a processor then gets the queue entries from redis.
+  # It then monitors the QueueTopic for changes.
+  class QueueMicroservice < Microservice
+    attr_reader :name, :processor, :processor_thread
+
+    def initialize(*args)
+      super(*args)
+      @queue_name = @name.split('__')[2]
+
+      initial_state = 'HOLD'
+      (@config['options'] || []).each do |option|
+        case option[0].upcase
+        when 'QUEUE_STATE'
+          initial_state = option[1]
+        else
+          @logger.error("Unknown option passed to microservice #{@name}: #{option}")
+        end
+      end
+
+      @processor = QueueProcessor.new(name: @queue_name, state: initial_state, logger: @logger, scope: @scope)
+      @processor_thread = nil
+      @read_topic = true
+    end
+
+    def run
+      @logger.info "QueueMicroservice running"
+      @processor_thread = Thread.new { @processor.run }
+
+      # Let the frontend know that the microservice has been deployed and is running
+      notification = {
+        'kind' => 'deployed',
+        # name and updated_at fields are required for Event formatting
+        'data' => JSON.generate({
+          'name' => @name,
+          'updated_at' => Time.now.to_nsec_from_epoch,
+        }),
+      }
+      QueueTopic.write_notification(notification, scope: @scope)
+
+      loop do
+        break if @cancel_thread
+        block_for_updates()
+      end
+      @processor.shutdown()
+      @processor_thread.join() if @processor_thread
+      @logger.info "QueueMicroservice exiting"
+    end
+
+    def block_for_updates
+      @read_topic = true
+      while @read_topic && !@cancel_thread
+        begin
+          QueueTopic.read_topics(@topics) do |_topic, _msg_id, msg_hash, _redis|
+            data = JSON.parse(msg_hash['data']) if msg_hash['data']
+            if data['name'] == @queue_name and msg_hash['kind'] == 'updated'
+              @processor.state = data['state']
+            end
+          end
+        rescue StandardError => e
+          @logger.error "QueueMicroservice failed to read topics #{@topics}\n#{e.formatted}"
+        end
+      end
+    end
+
+    def shutdown
+      @read_topic = false
+      @processor.shutdown() if @processor
+      super
+    end
+  end
+end
+
+if __FILE__ == $0
+  OpenC3::QueueMicroservice.run
+  OpenC3::ThreadManager.instance.shutdown
+  OpenC3::ThreadManager.instance.join
+end

data/lib/openc3/models/queue_model.rb

@@ -0,0 +1,232 @@
+# encoding: ascii-8bit
+
+# Copyright 2025 OpenC3, Inc.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU Affero General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+
+# This file may also be used under the terms of a commercial license
+# if purchased from OpenC3, Inc.
+
+require 'openc3/models/model'
+require 'openc3/models/microservice_model'
+require 'openc3/topics/queue_topic'
+require 'openc3/utilities/logger'
+
+module OpenC3
+  class QueueError < StandardError; end
+
+  class QueueModel < Model
+    PRIMARY_KEY = 'openc3__queue'.freeze
+
+    @@class_mutex = Mutex.new
+
+    # NOTE: The following three class methods are used by the ModelController
+    # and are reimplemented to enable various Model class methods to work
+    def self.get(name:, scope:)
+      super("#{scope}__#{PRIMARY_KEY}", name: name)
+    end
+
+    def self.names(scope:)
+      super("#{scope}__#{PRIMARY_KEY}")
+    end
+
+    def self.all(scope:)
+      super("#{scope}__#{PRIMARY_KEY}")
+    end
+    # END NOTE
+
+    def self.queue_command(name, command:, username:, scope:)
+      model = get_model(name: name, scope: scope)
+      raise QueueError, "Queue '#{name}' not found in scope '#{scope}'" unless model
+
+      if model.state != 'DISABLE'
+        result = Store.zrevrange("#{scope}:#{name}", 0, 0, with_scores: true)
+        if result.empty?
+          index = 1.0
+        else
+          index = result[0][1].to_f + 1
+        end
+        Store.zadd("#{scope}:#{name}", index, { username: username, value: command, timestamp: Time.now.to_nsec_from_epoch }.to_json)
+        model.notify(kind: 'command')
+      else
+        raise QueueError, "Queue '#{name}' is disabled. Command '#{command}' not queued."
+      end
+    end
+
+    attr_accessor :name, :state
+
+    def initialize(name:, scope:, state: 'HOLD', updated_at: nil)
+      super("#{scope}__#{PRIMARY_KEY}", name: name, updated_at: updated_at, scope: scope)
+      @microservice_name = "#{scope}__QUEUE__#{name}"
+      if %w(HOLD RELEASE DISABLE).include?(state)
+        @state = state
+      else
+        @state = 'HOLD'
+      end
+    end
+
+    def create(update: false, force: false, queued: false)
+      super(update: update, force: force, queued: queued)
+      if update
+        notify(kind: 'updated')
+      else
+        deploy()
+        notify(kind: 'created')
+      end
+    end
+
+    # @return [Hash] generated from the QueueModel
+    def as_json(*a)
+      return {
+        'name' => @name,
+        'scope' => @scope,
+        'state' => @state,
+        'updated_at' => @updated_at
+      }
+    end
+
+    # @return [] update the redis stream / queue topic that something has changed
+    def notify(kind:)
+      notification = {
+        'kind' => kind,
+        'data' => JSON.generate(as_json(:allow_nan => true)),
+      }
+      QueueTopic.write_notification(notification, scope: @scope)
+    end
+
+    def insert_command(index, command_data)
+      if @state == 'DISABLE'
+        raise QueueError, "Queue '#{@name}' is disabled. Command '#{command_data['value']}' not queued."
+      end
+
+      unless index
+        result = Store.zrevrange("#{@scope}:#{@name}", 0, 0, with_scores: true)
+        if result.empty?
+          index = 1.0
+        else
+          index = result[0][1].to_f + 1
+        end
+      end
+      Store.zadd("#{@scope}:#{@name}", index, command_data.to_json)
+      notify(kind: 'command')
+    end
+
+    def update_command(index:, command:, username:)
+      if @state == 'DISABLE'
+        raise QueueError, "Queue '#{@name}' is disabled. Command at index #{index} not updated."
+      end
+
+      # Check if command exists at the given index
+      existing = Store.zrangebyscore("#{@scope}:#{@name}", index, index)
+      if existing.empty?
+        raise QueueError, "No command found at index #{index} in queue '#{@name}'"
+      end
+
+      # Remove the existing command and add the new one at the same index
+      Store.zremrangebyscore("#{@scope}:#{@name}", index, index)
+      command_data = { username: username, value: command, timestamp: Time.now.to_nsec_from_epoch }
+      Store.zadd("#{@scope}:#{@name}", index, command_data.to_json)
+      notify(kind: 'command')
+    end
+
+    def remove_command(index = nil)
+      if @state == 'DISABLE'
+        raise QueueError, "Queue '#{@name}' is disabled. Command not removed."
+      end
+
+      if index
+        # Remove specific index
+        result = Store.zrangebyscore("#{@scope}:#{@name}", index, index)
+        if result.empty?
+          return nil
+        else
+          Store.zremrangebyscore("#{@scope}:#{@name}", index, index)
+          command_data = JSON.parse(result[0])
+          command_data['index'] = index.to_f
+          notify(kind: 'command')
+          return command_data
+        end
+      else
+        # Remove first element (lowest score)
+        result = Store.zrange("#{@scope}:#{@name}", 0, 0, with_scores: true)
+        if result.empty?
+          return nil
+        else
+          score = result[0][1]
+          Store.zremrangebyscore("#{@scope}:#{@name}", score, score)
+          command_data = JSON.parse(result[0][0])
+          command_data['index'] = score.to_f
+          notify(kind: 'command')
+          return command_data
+        end
+      end
+    end
+
+    def list
+      return Store.zrange("#{@scope}:#{@name}", 0, -1, with_scores: true).map do |item|
+        result = JSON.parse(item[0])
+        result['index'] = item[1].to_f
+        result
+      end
+    end
+
+    def create_microservice(topics:)
+      # queue Microservice
+      microservice = MicroserviceModel.new(
+        name: @microservice_name,
+        folder_name: nil,
+        cmd: ['ruby', 'queue_microservice.rb', @microservice_name],
+        work_dir: '/openc3/lib/openc3/microservices',
+        options: [
+          ["QUEUE_STATE", @state],
+        ],
+        topics: topics,
+        target_names: [],
+        plugin: nil,
+        scope: @scope
+      )
+      microservice.create
+    end
+
+    def deploy
+      topics = ["#{@scope}__#{QueueTopic::PRIMARY_KEY}"]
+      if MicroserviceModel.get_model(name: @microservice_name, scope: @scope).nil?
+        create_microservice(topics: topics)
+      end
+    end
+
+    def undeploy
+      model = MicroserviceModel.get_model(name: @microservice_name, scope: @scope)
+      if model
+        # Let the frontend know that the microservice is shutting down
+        # Custom event which matches the 'deployed' event in QueueMicroservice
+        notification = {
+          'kind' => 'undeployed',
+          # name and updated_at fields are required for Event formatting
+          'data' => JSON.generate({
+            'name' => @microservice_name,
+            'updated_at' => Time.now.to_nsec_from_epoch,
+          }),
+        }
+        QueueTopic.write_notification(notification, scope: @scope)
+        model.destroy
+      end
+    end
+
+    # Delete the model from the Store
+    def destroy
+      undeploy()
+      Store.zremrangebyrank("#{@scope}:#{@name}", 0, -1)
+      super()
+    end
+  end
+end

data/lib/openc3/script/commands.rb

@@ -122,7 +122,7 @@ module OpenC3
     # except for range_check, hazardous_check, and raw as they are part of the cmd name
     # manual is always false since this is called from script and that is the default
     # NOTE: This is a helper method and should not be called directly
-    def _cmd(cmd, cmd_no_hazardous, *args, timeout: nil, log_message: nil, validate: true, scope: $openc3_scope, token: $openc3_token, **kwargs)
+    def _cmd(cmd, cmd_no_hazardous, *args, timeout: nil, log_message: nil, validate: true, queue: nil, scope: $openc3_scope, token: $openc3_token, **kwargs)
       extract_string_kwargs_to_args(args, kwargs)
       raw = cmd.include?('raw')
       no_range = cmd.include?('no_range') || cmd.include?('no_checks')
@@ -132,7 +132,7 @@ module OpenC3
       else
         begin
           begin
-            command = $api_server.method_missing(cmd, *args, timeout: timeout, log_message: log_message, validate: validate, scope: scope, token: token)
+            command = $api_server.method_missing(cmd, *args, timeout: timeout, log_message: log_message, validate: validate, queue: queue, scope: scope, token: token)
             if log_message.nil? or log_message
               _log_cmd(command, raw, no_range, no_hazardous)
             end
@@ -140,7 +140,7 @@ module OpenC3
             # This opens a prompt at which point they can cancel and stop the script
             # or say Yes and send the command. Thus we don't care about the return value.
             prompt_for_hazardous(e.target_name, e.cmd_name, e.hazardous_description)
-            command = $api_server.method_missing(cmd_no_hazardous, *args, timeout: timeout, log_message: log_message, validate: validate, scope: scope, token: token)
+            command = $api_server.method_missing(cmd_no_hazardous, *args, timeout: timeout, log_message: log_message, validate: validate, queue: queue, scope: scope, token: token)
             if log_message.nil? or log_message
               _log_cmd(command, raw, no_range, no_hazardous)
             end

data/lib/openc3/script/queue.rb

@@ -0,0 +1,80 @@
+# encoding: ascii-8bit
+
+# Copyright 2025 OpenC3, Inc.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU Affero General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+
+# This file may also be used under the terms of a commercial license
+# if purchased from OpenC3, Inc.
+
+require 'openc3/script/extract'
+
+module OpenC3
+  module Script
+    include Extract
+
+    private
+
+    # Helper method that makes the request and parses the response
+    def _make_request(action:, verb:, uri:, scope:, data: nil)
+      response = $api_server.request(verb, uri, data: data, json: data.nil? ? false : true, scope: scope)
+      if response.nil?
+        raise "Failed to #{action}. No response from server."
+      elsif response.status != 200 and response.status != 201
+        result = JSON.parse(response.body, :allow_nan => true, :create_additions => true)
+        raise "Failed to #{action} due to #{result['message']}"
+      end
+      return JSON.parse(response.body, :allow_nan => true, :create_additions => true)
+    end
+
+    def queue_all(scope: $openc3_scope)
+      return _make_request(action: 'index queue', verb: 'get', uri: "/openc3-api/queues", scope: scope)
+    end
+
+    def queue_get(name, scope: $openc3_scope)
+      return _make_request(action: 'get queue', verb: 'get', uri: "/openc3-api/queues/#{name}", scope: scope)
+    end
+
+    def queue_list(name, scope: $openc3_scope)
+      return _make_request(action: 'list queue', verb: 'get', uri: "/openc3-api/queues/#{name}/list", scope: scope)
+    end
+
+    def queue_create(name, state: 'HOLD', scope: $openc3_scope)
+      data = {}
+      data['state'] = state
+      return _make_request(action: 'create queue', verb: 'post', uri: "/openc3-api/queues/#{name}", data: data, scope: scope)
+    end
+
+    def queue_hold(name, scope: $openc3_scope)
+      return _make_request(action: 'hold queue', verb: 'post', uri: "/openc3-api/queues/#{name}/hold", scope: scope)
+    end
+
+    def queue_release(name, scope: $openc3_scope)
+      return _make_request(action: 'release queue', verb: 'post', uri: "/openc3-api/queues/#{name}/release", scope: scope)
+    end
+
+    def queue_disable(name, scope: $openc3_scope)
+      return _make_request(action: 'disable queue', verb: 'post', uri: "/openc3-api/queues/#{name}/disable", scope: scope)
+    end
+
+    def queue_exec(name, index: nil, scope: $openc3_scope)
+      data = {}
+      data['index'] = index if index
+      return _make_request(action: 'exec command', verb: 'post', uri: "/openc3-api/queues/#{name}/exec_command", data: data, scope: scope)
+    end
+
+    def queue_delete(name, scope: $openc3_scope)
+      return _make_request(action: 'delete queue', verb: 'delete', uri: "/openc3-api/queues/#{name}", scope: scope)
+    end
+    alias queue_destroy queue_delete
+  end
+end

data/lib/openc3/script/script.rb

@@ -34,6 +34,7 @@ require 'openc3/script/limits'
 require 'openc3/script/metadata'
 require 'openc3/script/packages'
 require 'openc3/script/plugins'
+require 'openc3/script/queue'
 require 'openc3/script/screen'
 require 'openc3/script/script_runner'
 require 'openc3/script/storage'

data/lib/openc3/script/web_socket_api.rb

@@ -306,6 +306,17 @@ module OpenC3
     end
   end
 
+  # Queue WebSocket
+  class QueueEventsWebSocketApi < CmdTlmWebSocketApi
+    def initialize(history_count: 0, url: nil, write_timeout: 10.0, read_timeout: 10.0, connect_timeout: 5.0, authentication: nil, scope: $openc3_scope)
+      @identifier = {
+        channel: "QueueEventsChannel",
+        history_count: history_count
+      }
+      super(url: url, write_timeout: write_timeout, read_timeout: read_timeout, connect_timeout: connect_timeout, authentication: authentication, scope: scope)
+    end
+  end
+
   # Streaming API WebSocket
   class StreamingWebSocketApi < CmdTlmWebSocketApi
     def initialize(url: nil, write_timeout: 10.0, read_timeout: 10.0, connect_timeout: 5.0, authentication: nil, scope: $openc3_scope)

data/lib/openc3/topics/queue_topic.rb

@@ -0,0 +1,29 @@
+# encoding: ascii-8bit
+
+# Copyright 2025 OpenC3, Inc.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU Affero General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+
+# This file may also be used under the terms of a commercial license
+# if purchased from OpenC3, Inc.
+
+require 'openc3/topics/topic'
+
+module OpenC3
+  class QueueTopic < Topic
+    PRIMARY_KEY = "openc3_queue"
+
+    def self.write_notification(notification, scope:)
+      Topic.write_topic("#{scope}__#{PRIMARY_KEY}", notification, '*', 1000)
+    end
+  end
+end

data/lib/openc3/utilities/local_mode.rb

@@ -31,6 +31,7 @@ module OpenC3
       'openc3-cosmos-tool-admin',
       'openc3-cosmos-tool-bucketexplorer',
       'openc3-cosmos-tool-cmdsender',
+      'openc3-cosmos-tool-cmdqueue',
       'openc3-cosmos-tool-cmdhistory',
       'openc3-cosmos-tool-cmdtlmserver',
       'openc3-cosmos-tool-dataextractor',
@@ -50,6 +51,7 @@ module OpenC3
       'openc3-cosmos-tool-calendar',
       'openc3-cosmos-tool-grafana',
       'openc3-cosmos-tool-systemhealth',
+      'openc3-cosmos-tool-logexplorer',
       'openc3-tool-base',
     ]
 

data/lib/openc3/version.rb

@@ -1,14 +1,14 @@
 # encoding: ascii-8bit
 
-OPENC3_VERSION = '6.7.0'
+OPENC3_VERSION = '6.8.0'
 module OpenC3
   module Version
     MAJOR = '6'
-    MINOR = '7'
+    MINOR = '8'
     PATCH = '0'
     OTHER = ''
-    BUILD = '6c4726a21dd004109cf840f83a99f5a8614cfbe3'
+    BUILD = '35fc05d093679cc901fc15e31a9af4b71fad61b4'
   end
-  VERSION = '6.7.0'
-  GEM_VERSION = '6.7.0'
+  VERSION = '6.8.0'
+  GEM_VERSION = '6.8.0'
 end

data/templates/tool_angular/package.json

@@ -1,6 +1,6 @@
 {
   "name": "<%= tool_name %>",
-  "version": "6.7.0",
+  "version": "6.8.0",
   "scripts": {
     "ng": "ng",
     "start": "ng serve",
@@ -23,7 +23,7 @@
     "@angular/platform-browser-dynamic": "^18.2.6",
     "@angular/router": "^18.2.6",
     "@astrouxds/astro-web-components": "^7.24.0",
-    "@openc3/js-common": "6.7.0",
+    "@openc3/js-common": "6.8.0",
     "rxjs": "~7.8.0",
     "single-spa": "^5.9.5",
     "single-spa-angular": "^9.2.0",

data/templates/tool_react/package.json

@@ -16,7 +16,7 @@
     "@emotion/react": "^11.13.3",
     "@emotion/styled": "^11.11.0",
     "@mui/material": "^6.1.1",
-    "@openc3/js-common": "6.7.0",
+    "@openc3/js-common": "6.8.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "single-spa-react": "^5.1.4"

data/templates/tool_svelte/package.json

@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "@astrouxds/astro-web-components": "^7.24.0",
-    "@openc3/js-common": "6.7.0",
+    "@openc3/js-common": "6.8.0",
     "@smui/button": "^7.0.0",
     "@smui/common": "^7.0.0",
     "@smui/card": "^7.0.0",

data/templates/tool_vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "<%= tool_name %>",
-  "version": "6.7.0",
+  "version": "6.8.0",
   "private": true,
   "type": "module",
   "scripts": {
@@ -11,8 +11,8 @@
   },
   "dependencies": {
     "@astrouxds/astro-web-components": "^7.24.0",
-    "@openc3/js-common": "6.7.0",
-    "@openc3/vue-common": "6.7.0",
+    "@openc3/js-common": "6.8.0",
+    "@openc3/vue-common": "6.8.0",
     "axios": "^1.7.7",
     "date-fns": "^4.1.0",
     "lodash": "^4.17.21",

data/templates/widget/package.json

@@ -1,6 +1,6 @@
 {
   "name": "<%= widget_name %>",
-  "version": "6.7.0",
+  "version": "6.8.0",
   "private": true,
   "type": "module",
   "scripts": {
@@ -8,7 +8,7 @@
   },
   "dependencies": {
     "@astrouxds/astro-web-components": "^7.24.0",
-    "@openc3/vue-common": "6.7.0",
+    "@openc3/vue-common": "6.8.0",
     "vuetify": "^3.7.1"
   },
   "devDependencies": {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openc3
 version: !ruby/object:Gem::Version
-  version: 6.7.0
+  version: 6.8.0
 platform: ruby
 authors:
 - Ryan Melton
@@ -184,14 +184,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: rackup
   requirement: !ruby/object:Gem::Requirement
@@ -800,28 +800,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.21'
+        version: '0.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.21'
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.4.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.4.1
 - !ruby/object:Gem::Dependency
   name: simplecov-cobertura
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '3.0'
 description: |2
       OpenC3 provides all the functionality needed to send
       commands to and receive data from one or more embedded systems
@@ -1052,6 +1066,7 @@ files:
 - lib/openc3/microservices/multi_microservice.rb
 - lib/openc3/microservices/periodic_microservice.rb
 - lib/openc3/microservices/plugin_microservice.rb
+- lib/openc3/microservices/queue_microservice.rb
 - lib/openc3/microservices/reducer_microservice.rb
 - lib/openc3/microservices/router_microservice.rb
 - lib/openc3/microservices/scope_cleanup_microservice.rb
@@ -1087,6 +1102,7 @@ files:
 - lib/openc3/models/plugin_store_model.rb
 - lib/openc3/models/process_status_model.rb
 - lib/openc3/models/python_package_model.rb
+- lib/openc3/models/queue_model.rb
 - lib/openc3/models/reaction_model.rb
 - lib/openc3/models/reducer_model.rb
 - lib/openc3/models/router_model.rb
@@ -1145,6 +1161,7 @@ files:
 - lib/openc3/script/metadata.rb
 - lib/openc3/script/packages.rb
 - lib/openc3/script/plugins.rb
+- lib/openc3/script/queue.rb
 - lib/openc3/script/screen.rb
 - lib/openc3/script/script.rb
 - lib/openc3/script/script_runner.rb
@@ -1183,6 +1200,7 @@ files:
 - lib/openc3/topics/decom_interface_topic.rb
 - lib/openc3/topics/interface_topic.rb
 - lib/openc3/topics/limits_event_topic.rb
+- lib/openc3/topics/queue_topic.rb
 - lib/openc3/topics/router_topic.rb
 - lib/openc3/topics/system_events_topic.rb
 - lib/openc3/topics/telemetry_decom_topic.rb
@@ -1351,7 +1369,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 3.7.2
 specification_version: 4
 summary: OpenC3
 test_files: []