harnex 0.6.5 → 0.7.3

data/lib/harnex/runtime/session.rb

@@ -6,16 +6,20 @@ module Harnex
   class Session
     OUTPUT_BUFFER_LIMIT = 64 * 1024
     TRANSCRIPT_TAIL_BYTES = 16 * 1024
+    AUTOSTOP_TEARDOWN_GRACE_SECONDS_DEFAULT = 5.0
     USAGE_FIELDS = %i[
       input_tokens output_tokens reasoning_tokens cached_tokens total_tokens agent_session_id
     ].freeze
+    BUDGET_META_FIELDS = %w[read_budget_lines output_ceiling_lines].freeze
     class EventCounters
       def initialize
         @counts = {
           stalls: 0,
           force_resumes: 0,
           disconnections: 0,
-          compactions: 0
+          compactions: 0,
+          tool_calls: 0,
+          commands_executed: 0
         }
       end
 
@@ -32,17 +36,31 @@ module Harnex
         end
       end
 
+      def record_item(item)
+        return unless item.is_a?(Hash)
+
+        case item["type"]
+        when "mcpToolCall", "dynamicToolCall"
+          @counts[:tool_calls] += 1
+        when "commandExecution"
+          @counts[:commands_executed] += 1
+        end
+      end
+
       def snapshot
         @counts.dup
       end
     end
 
-    attr_reader :repo_root, :host, :port, :session_id, :token, :command, :pid, :id, :adapter, :watch, :inbox, :description, :meta, :summary_out, :output_log_path, :events_log_path
+    attr_reader :repo_root, :launch_cwd, :host, :port, :session_id, :token, :command, :pid, :id, :adapter, :watch,
+                :inbox, :description, :meta, :summary_out, :output_log_path, :events_log_path,
+                :started_at, :ended_at, :exit_code, :term_signal
 
-    def initialize(adapter:, command:, repo_root:, host:, port: nil, id: DEFAULT_ID, watch: nil, description: nil, meta: nil, summary_out: nil, inbox_ttl: Inbox::DEFAULT_TTL, auto_stop: false)
+    def initialize(adapter:, command:, repo_root:, host:, port: nil, id: DEFAULT_ID, watch: nil, description: nil, meta: nil, summary_out: nil, inbox_ttl: Inbox::DEFAULT_TTL, auto_stop: false, launch_cwd: nil)
       @adapter = adapter
       @command = command
       @repo_root = repo_root
+      @launch_cwd = File.expand_path(launch_cwd.to_s.empty? ? repo_root : launch_cwd)
       @host = host
       @id = Harnex.normalize_id(id)
       @watch = watch
@@ -83,6 +101,7 @@ module Harnex
       @auto_stop = !!auto_stop
       @auto_stop_fired = false
       @auto_stop_seen_busy = false
+      @auto_stop_threads = []
       @stop_requested = false
       @writer = nil
       @pid = nil
@@ -91,6 +110,9 @@ module Harnex
       @output_buffer.force_encoding(Encoding::BINARY)
       @state_machine = SessionState.new(adapter)
       @inbox = Inbox.new(self, @state_machine, ttl: inbox_ttl)
+      @rate_limits = nil
+      @parent_harnex_id = ENV["HARNEX_ID"].to_s.strip
+      @parent_harnex_id = nil if @parent_harnex_id.empty?
     end
 
     def self.validate_binary!(command)
@@ -145,6 +167,8 @@ module Harnex
       @exit_code = status.exited? ? status.exitstatus : 128 + status.termsig
       @ended_at = Time.now
 
+      normalize_auto_stop_exit_code!
+      drain_auto_stop_threads
       output_thread.join(1)
       finalize_session!
       input_thread&.kill
@@ -200,6 +224,18 @@ module Harnex
       payload
     end
 
+    def task_complete?
+      !!@last_completed_at
+    end
+
+    def git_start
+      @git_start || {}
+    end
+
+    def git_end
+      @git_end || {}
+    end
+
     def auth_ok?(header)
       header == "Bearer #{token}"
     end
@@ -218,14 +254,6 @@ module Harnex
       return { ok: true, signal: "already_requested" } if stop_requested!
 
       if adapter.transport == :stdio_jsonrpc
-        @inject_mutex.synchronize do
-          begin
-            adapter.interrupt(turn_id: turn_id)
-          rescue StandardError
-            nil
-          end
-          @state_machine.force_busy!
-        end
         if adapter.respond_to?(:terminate_subprocess)
           Thread.new do
             begin
@@ -235,6 +263,14 @@ module Harnex
             end
           end
         end
+        @inject_mutex.synchronize do
+          begin
+            adapter.interrupt(turn_id: turn_id)
+          rescue StandardError
+            nil
+          end
+          @state_machine.force_busy!
+        end
         return { ok: true, signal: "interrupt_sent" }
       end
 
@@ -359,6 +395,8 @@ module Harnex
       end
       @ended_at = Time.now
 
+      normalize_auto_stop_exit_code!
+      drain_auto_stop_threads
       finalize_session!
       watch_thread&.kill
       @exit_code
@@ -406,6 +444,7 @@ module Harnex
         schedule_auto_stop("task_complete", turn_id: payload[:turnId])
       when "item/completed"
         emit_event("item_completed", item: params["item"])
+        @event_counters.record_item(params["item"])
         text = render_item_text(params["item"])
         record_synthesized(text) if text
       when "thread/compacted"
@@ -745,6 +784,7 @@ module Harnex
       end
       @exit_reason ||= classify_exit
       append_summary_record(build_summary_record)
+      append_dispatch_history_record
       emit_summary_event
       emit_exit_event
     end
@@ -789,13 +829,59 @@ module Harnex
       end
       return unless should_fire
 
-      Thread.new do
+      thread = Thread.new do
         begin
           inject_stop(turn_id: turn_id)
         rescue StandardError => e
           warn("harnex: auto-stop failed after #{reason}: #{e.message}")
         end
       end
+      track_auto_stop_thread(thread)
+    end
+
+    def track_auto_stop_thread(thread)
+      @auto_stop_mutex.synchronize { @auto_stop_threads << thread }
+    end
+
+    def drain_auto_stop_threads
+      return unless @auto_stop
+
+      threads = @auto_stop_mutex.synchronize { @auto_stop_threads.dup }
+      return if threads.empty?
+
+      grace_seconds = auto_stop_teardown_grace_seconds
+      deadline = Time.now + grace_seconds
+      timed_out = []
+
+      threads.each do |thread|
+        remaining = deadline - Time.now
+        thread.join(remaining) if remaining.positive?
+        timed_out << thread if thread.alive?
+      end
+      return if timed_out.empty?
+
+      timed_out.each(&:kill)
+      @exit_code = 1 if @exit_code.nil? || @exit_code.zero?
+      @term_signal = nil if @exit_code == 1
+      emit_event("auto_stop_teardown_timeout", grace_seconds: grace_seconds, threads: timed_out.size)
+    end
+
+    def auto_stop_teardown_grace_seconds
+      override = ENV["HARNEX_AUTOSTOP_TEARDOWN_GRACE_SECONDS"]
+      return AUTOSTOP_TEARDOWN_GRACE_SECONDS_DEFAULT if override.to_s.strip.empty?
+
+      Float(override)
+    rescue ArgumentError
+      AUTOSTOP_TEARDOWN_GRACE_SECONDS_DEFAULT
+    end
+
+    def normalize_auto_stop_exit_code!
+      return unless @auto_stop
+      return unless @last_completed_at
+      return unless @auto_stop_fired
+
+      @exit_code = 0
+      @term_signal = nil
     end
 
     def classify_exit
@@ -833,22 +919,21 @@ module Harnex
 
       {
         id: id,
-        tmux_session: id,
+        tmux_session: summary_tmux_session,
         description: description,
         started_at: @started_at.iso8601,
         ended_at: @ended_at&.iso8601,
         harness: "harnex",
         harness_version: Harnex.harness_version,
         agent: adapter.key,
-        agent_version: nil,
-        agent_provider: nil,
-        agent_deployment: nil,
+        agent_version: adapter.agent_version,
+        agent_provider: adapter.provider,
         host: info[:host],
         platform: info[:platform],
         orchestrator: passthrough["orchestrator"],
         orchestrator_session: passthrough["orchestrator_session"],
         chain_id: passthrough["chain_id"],
-        parent_dispatch_id: passthrough["parent_dispatch_id"],
+        parent_dispatch_id: passthrough["parent_dispatch_id"] || @parent_harnex_id,
         tier: passthrough["tier"],
         phase: passthrough["phase"],
         issue: passthrough["issue"],
@@ -858,11 +943,12 @@ module Harnex
         branch: @git_start[:branch],
         start_sha: @git_start[:sha],
         end_sha: @git_end[:sha]
-      }
+      }.merge(summary_budget_meta)
     end
 
     def build_summary_actual
       counters = @event_counters.snapshot
+      output_measurements = summary_output_measurements
       if %w[disconnected boot_failure].include?(@exit_reason)
         counters[:disconnections] = [counters[:disconnections], 1].max
       end
@@ -875,24 +961,72 @@ module Harnex
         output_tokens: @usage_summary[:output_tokens],
         reasoning_tokens: @usage_summary[:reasoning_tokens],
         cached_tokens: @usage_summary[:cached_tokens],
-        cost_usd: nil,
+        total_tokens: @usage_summary[:total_tokens],
+        agent_session_id: summary_agent_session_id,
+        adapter_transport: adapter.transport.to_s,
         loc_added: @git_end[:loc_added],
         loc_removed: @git_end[:loc_removed],
+        lines_changed: summary_lines_changed,
         files_changed: @git_end[:files_changed],
         commits: @git_end[:commits],
         exit: @exit_reason,
+        task_complete: !!@last_completed_at,
+        signal: @term_signal,
+        exit_code: @exit_code,
+        last_error: @last_error,
         stalls: counters[:stalls],
         force_resumes: counters[:force_resumes],
         disconnections: counters[:disconnections],
         compactions: counters[:compactions],
-        tests_run: nil,
-        tests_passed: nil,
-        tests_failed: nil
+        turn_count: @injected_count,
+        tool_calls: counters[:tool_calls],
+        commands_executed: counters[:commands_executed],
+        rate_limits: @rate_limits,
+        output_lines: output_measurements[:lines],
+        output_bytes: output_measurements[:bytes],
+        event_records: @events_log_seq,
+        output_log_path: output_log_path,
+        events_log_path: events_log_path
       }
-      actual[:last_error] = @last_error if @exit_reason == "boot_failure" && @last_error
       actual
     end
 
+    def summary_budget_meta
+      BUDGET_META_FIELDS.each_with_object({}) do |field, values|
+        values[field.to_sym] = meta_hash[field] if meta_hash.key?(field)
+      end
+    end
+
+    def summary_lines_changed
+      added = @git_end[:loc_added]
+      removed = @git_end[:loc_removed]
+      return nil if added.nil? && removed.nil?
+
+      added.to_i + removed.to_i
+    end
+
+    def summary_output_measurements
+      size = File.size?(output_log_path)
+      return { lines: nil, bytes: nil } unless size
+
+      lines = 0
+      File.foreach(output_log_path) { lines += 1 }
+      { lines: lines, bytes: size }
+    rescue StandardError
+      { lines: nil, bytes: size }
+    end
+
+    def summary_tmux_session
+      value = load_existing_registry_metadata["tmux_session"]
+      value.to_s.empty? ? nil : value
+    end
+
+    def summary_agent_session_id
+      @usage_summary[:agent_session_id] ||
+        @rpc_thread_id ||
+        (adapter.thread_id if adapter.respond_to?(:thread_id))
+    end
+
     def summary_predicted_payload
       predicted = meta_hash["predicted"]
       predicted.is_a?(Hash) ? predicted : {}
@@ -914,6 +1048,13 @@ module Harnex
       warn("harnex: failed to write dispatch summary #{summary_out}: #{e.message}")
     end
 
+    def append_dispatch_history_record
+      path = DispatchHistory.path_for(launch_cwd)
+      DispatchHistory.append(path, DispatchHistory.build_record(self))
+    rescue StandardError => e
+      warn("harnex: failed to write dispatch history: #{e.message}")
+    end
+
     def normalized_usage_summary(summary)
       summary ||= {}
       USAGE_FIELDS.to_h { |field| [field, summary[field] || summary[field.to_s]] }

data/lib/harnex/version.rb

@@ -1,4 +1,4 @@
 module Harnex
-  VERSION = "0.6.5"
-  RELEASE_DATE = "2026-05-07"
+  VERSION = "0.7.3"
+  RELEASE_DATE = "2026-05-13"
 end

data/lib/harnex.rb

@@ -4,6 +4,7 @@ require "open3"
 
 require_relative "harnex/version"
 require_relative "harnex/core"
+require_relative "harnex/dispatch_history"
 require_relative "harnex/watcher"
 require_relative "harnex/adapters"
 require_relative "harnex/runtime/session_state"
@@ -21,6 +22,7 @@ require_relative "harnex/commands/stop"
 require_relative "harnex/commands/status"
 require_relative "harnex/commands/logs"
 require_relative "harnex/commands/events"
+require_relative "harnex/commands/history"
 require_relative "harnex/commands/pane"
 require_relative "harnex/commands/recipes"
 require_relative "harnex/commands/guide"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: harnex
 version: !ruby/object:Gem::Version
-  version: 0.6.5
+  version: 0.7.3
 platform: ruby
 authors:
 - Jikku Jose
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-05-07 00:00:00.000000000 Z
+date: 2026-05-13 00:00:00.000000000 Z
 dependencies: []
 description: A local PTY harness that wraps terminal AI agents (Claude, Codex) and
   adds a control plane for discovery, messaging, and coordination.
@@ -38,11 +38,14 @@ files:
 - lib/harnex/adapters/codex.rb
 - lib/harnex/adapters/codex_appserver.rb
 - lib/harnex/adapters/generic.rb
+- lib/harnex/adapters/opencode.rb
 - lib/harnex/cli.rb
+- lib/harnex/codex/app_server/client.rb
 - lib/harnex/commands/agents_guide.rb
 - lib/harnex/commands/doctor.rb
 - lib/harnex/commands/events.rb
 - lib/harnex/commands/guide.rb
+- lib/harnex/commands/history.rb
 - lib/harnex/commands/logs.rb
 - lib/harnex/commands/pane.rb
 - lib/harnex/commands/recipes.rb
@@ -54,6 +57,7 @@ files:
 - lib/harnex/commands/watch.rb
 - lib/harnex/commands/watch_presets.rb
 - lib/harnex/core.rb
+- lib/harnex/dispatch_history.rb
 - lib/harnex/runtime/api_server.rb
 - lib/harnex/runtime/file_change_hook.rb
 - lib/harnex/runtime/inbox.rb