pwn 0.5.686 → 0.5.688

data/spec/lib/pwn/plugins/log_spec.rb

@@ -25,12 +25,15 @@ describe PWN::Plugins::Log do
       expect(PWN::Plugins::Log).to respond_to(:progress)
       expect(PWN::Plugins::Log).to respond_to(:debug_enabled?)
       expect(PWN::Plugins::Log).to respond_to(:debug_log_path)
+      expect(PWN::Plugins::Log).to respond_to(:next_request_log!)
+      expect(PWN::Plugins::Log).to respond_to(:finish_request_log!)
 
       tee = StringIO.new
-      path = PWN::Plugins::Log.start_debug(tee: tee, path: nil)
-      expect(path).to match(%r{\A/tmp/pwn-ai-DEBUG-.+\.log\z})
-      expect(File.file?(path)).to eq(true)
+      PWN::Plugins::Log.start_debug(tee: tee, path: nil)
       expect(PWN::Plugins::Log.debug_enabled?).to eq(true)
+      path = PWN::Plugins::Log.next_request_log!(session_id: "sess#{Process.pid}")
+      expect(path).to eq("/tmp/pwn-ai-DEBUG-sess#{Process.pid}-R1.log")
+      expect(File.file?(path)).to eq(true)
       expect(PWN::Plugins::Log.debug_log_path).to eq(path)
 
       ok = PWN::Plugins::Log.progress(msg: 'Loop.run start request=hi', which_self: PWN::AI::Agent::Loop)
@@ -61,21 +64,166 @@ describe PWN::Plugins::Log do
       expect(tee.string).to include('after-loud')
     end
 
-    it 'rolls the debug log to .N+1 when the file exceeds 1MB' do
-      stem = "/tmp/pwn-ai-DEBUG-#{Process.pid}-roll"
-      first = "#{stem}.1.log"
-      File.write(first, 'x' * (1_024_000 + 10))
-      path = PWN::Plugins::Log.start_debug(tee: StringIO.new, path: first)
-      expect(path).to eq(first)
-      PWN::Plugins::Log.progress(msg: 'overflow-line', which_self: PWN::AI::Agent::Loop)
-      second = "#{stem}.2.log"
-      expect(PWN::Plugins::Log.debug_log_path).to eq(second)
-      expect(File.file?(second)).to eq(true)
-      expect(File.read(second)).to include('overflow-line')
+    it 'tees debug lines with raw ANSI, not PS1 SOH/STX markers' do
+      tee = StringIO.new
+      PWN::Plugins::Log.start_debug(
+        tee: tee,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-ansi.log"
+      )
+      PWN::Plugins::Log.progress(msg: 'stage-line', which_self: PWN::AI::Agent::Loop)
+      shown = tee.string
+      expect(shown).to include('stage-line')
+      expect(shown).to include("\e[35m")
+      expect(shown).not_to include("\001")
+      expect(shown).not_to include("\002")
+    end
+
+    it 'writes a multiline final body when keep_newlines is set' do
+      path = PWN::Plugins::Log.start_debug(
+        tee: StringIO.new,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-finalbody.log"
+      )
+      PWN::Plugins::Log.progress(
+        msg: "final text:\nline-one\nline-two",
+        which_self: PWN::AI::Agent::Loop,
+        keep_newlines: true,
+        cap: 65_536
+      )
+      body = File.read(path)
+      expect(body).to include("final text:\nline-one\nline-two")
+    end
+
+    it 'writes a full tool request/result with no char cap when cap is 0' do
+      path = PWN::Plugins::Log.start_debug(
+        tee: StringIO.new,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-toolio.log"
+      )
+      blob = 'x' * 8_000
+      PWN::Plugins::Log.progress(
+        msg: "tool pwn_eval request:\n#{blob}\nresult:\n#{blob}",
+        which_self: PWN::AI::Agent::Loop,
+        keep_newlines: true,
+        cap: 0,
+        tee: nil
+      )
+      body = File.read(path)
+      expect(body).to include('tool pwn_eval request:')
+      expect(body).to include(blob)
+      expect(body).to include("result:\n#{blob}")
+    end
+
+    it 'timestamps an Interrupt line into the open request log' do
+      expect(PWN::Plugins::Log).to respond_to(:note_interrupt!)
+      path = PWN::Plugins::Log.start_debug(
+        tee: StringIO.new,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-int.log"
+      )
+      ok = PWN::Plugins::Log.note_interrupt!(where: 'CTRL+C')
+      expect(ok).to eq true
+      body = File.read(path)
+      expect(body).to match(/\[DEBUG \d{4}-\d{2}-\d{2} /)
+      expect(body).to include('Interrupt')
+      expect(body).to include('CTRL+C')
+    end
+
+    it 'still timestamps Interrupt when progress reentrancy is stuck mid-write' do
+      path = PWN::Plugins::Log.start_debug(
+        tee: StringIO.new,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-int-stuck.log"
+      )
+      Thread.current[:pwn_log_progress] = true
+      ok = PWN::Plugins::Log.note_interrupt!(where: 'CTRL+C')
+      expect(ok).to eq true
+      body = File.read(path)
+      expect(body).to include('Interrupt')
+      expect(body).to include('CTRL+C')
+      expect(body).to match(/at=|→ pwn-ai → Interrupt/)
+    ensure
+      Thread.current[:pwn_log_progress] = false
+    end
+
+    it 'timestamps an exception and backtrace into the open request log' do
+      expect(PWN::Plugins::Log).to respond_to(:note_exception!)
+      path = PWN::Plugins::Log.start_debug(
+        tee: StringIO.new,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-exc.log"
+      )
+      err = NoMethodError.new("undefined method '+' for nil")
+      err.set_backtrace(['/opt/pwn/lib/pwn/ai/grok.rb:470:in grok_rest_call', 'loop.rb:1'])
+      ok = PWN::Plugins::Log.note_exception!(error: err, where: 'Loop.run')
+      expect(ok).to eq true
+      body = File.read(path)
+      expect(body).to include('NoMethodError')
+      expect(body).to include("undefined method '+' for nil")
+      expect(body).to include('grok.rb:470')
+      expect(body).to include('Loop.run')
+    end
+
+    it 'mirrors TUI tool/task/result rows into the request log without ANSI' do
+      expect(PWN::Plugins::Log).to respond_to(:mirror_tui!)
+      path = PWN::Plugins::Log.start_debug(
+        tee: StringIO.new,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-tui.log"
+      )
+      ok = PWN::Plugins::Log.mirror_tui!(
+        msg: "\e[33m[ 2026-08-20 11:00:00-0600 → pwn-ai → pwn_eval ]\e[0m\n  {\"code\":\"1+1\"}\n"
+      )
+      expect(ok).not_to be_nil
+      PWN::Plugins::Log.mirror_tui!(msg: "2026-08-20 11:00:01-0600 → result\n  {\"value\":\"2\"}\n")
+      PWN::Plugins::Log.mirror_tui!(msg: '[ 2026-08-20 11:00:00-0600 → pwn-ai → task ] navigate')
+      body = File.read(path)
+      expect(body).to include('[ 2026-08-20 11:00:00-0600 → pwn-ai → pwn_eval ]')
+      expect(body).to include('{"code":"1+1"}')
+      expect(body).to include('→ result')
+      expect(body).to include('→ pwn-ai → task')
+      expect(body).not_to include("\e[33m")
+      expect(body).not_to include("\e[0m")
     end
 
-    it 'traces PWN module calls into the same debug log while the session is on' do
-      path = PWN::Plugins::Log.start_debug(tee: StringIO.new, path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-#{Time.now.to_i}.log")
+    it 'opens one debug log per request: SESSION_ID-R1 then SESSION_ID-R2' do
+      tee = StringIO.new
+      sid = "abc#{Process.pid}"
+      PWN::Plugins::Log.start_debug(tee: tee)
+      first = PWN::Plugins::Log.next_request_log!(session_id: sid)
+      PWN::Plugins::Log.progress(msg: 'req-one', which_self: PWN::AI::Agent::Loop)
+      PWN::Plugins::Log.finish_request_log!(iter: 1, tools_called: 0, engine_s: 0.1, final_chars: 4)
+      second = PWN::Plugins::Log.next_request_log!(session_id: sid)
+      PWN::Plugins::Log.progress(msg: 'req-two', which_self: PWN::AI::Agent::Loop)
+      expect(first).to eq("/tmp/pwn-ai-DEBUG-#{sid}-R1.log")
+      expect(second).to eq("/tmp/pwn-ai-DEBUG-#{sid}-R2.log")
+      expect(File.read(first)).to include('req-one')
+      expect(File.read(first)).to include('footer iter=1')
+      expect(File.read(first)).not_to include('req-two')
+      expect(File.read(second)).to include('req-two')
+      expect(File.read(second)).not_to include('req-one')
+    end
+
+    it 'does not roll RN when a request log is already open' do
+      tee = StringIO.new
+      sid = "nest#{Process.pid}"
+      PWN::Plugins::Log.start_debug(tee: tee)
+      first = PWN::Plugins::Log.next_request_log!(session_id: sid)
+      second = PWN::Plugins::Log.next_request_log!(session_id: sid)
+      expect(second).to eq(first)
+      expect(second).to eq("/tmp/pwn-ai-DEBUG-#{sid}-R1.log")
+    end
+
+    it 'does not TracePoint PWN calls unless trace: true' do
+      path = PWN::Plugins::Log.start_debug(
+        tee: StringIO.new,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-notrace.log"
+      )
+      PWN::AI::Agent::OpenGoal.current if defined?(PWN::AI::Agent::OpenGoal)
+      body = File.read(path)
+      expect(body).not_to match(/PWN::AI::Agent::OpenGoal\.current/)
+    end
+
+    it 'traces PWN module calls into the same debug log when trace: true' do
+      path = PWN::Plugins::Log.start_debug(
+        tee: StringIO.new,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-#{Time.now.to_i}.log",
+        trace: true
+      )
       PWN::AI::Agent::OpenGoal.current if defined?(PWN::AI::Agent::OpenGoal)
       body = File.read(path)
       expect(body).to match(/PWN::AI::Agent::OpenGoal/)
@@ -94,7 +242,8 @@ describe PWN::Plugins::Log do
       stub_const('PWN::AI::Agent::SymNameProbe', probe)
       PWN::Plugins::Log.start_debug(
         tee: StringIO.new,
-        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-sym.log"
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-sym.log",
+        trace: true
       )
       expect { PWN::AI::Agent::SymNameProbe.ping }.not_to raise_error
     end
@@ -108,7 +257,8 @@ describe PWN::Plugins::Log do
       stub_const('PWN::AI::Agent::ArgProbe', probe)
       path = PWN::Plugins::Log.start_debug(
         tee: StringIO.new,
-        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-args.log"
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-args.log",
+        trace: true
       )
       PWN::AI::Agent::ArgProbe.echo(
         msg: 'hello-browser',
@@ -132,7 +282,8 @@ describe PWN::Plugins::Log do
       stub_const('PWN::AI::Agent::ArgProbe', probe)
       path = PWN::Plugins::Log.start_debug(
         tee: StringIO.new,
-        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-redact.log"
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-redact.log",
+        trace: true
       )
       PWN::AI::Agent::ArgProbe.echo(
         header: 'Bearer eyJhbGciOiJIUzI1NiJ9.aaa.bbb',

data/spec/lib/pwn/plugins/repl_pwn_vault_spec.rb

@@ -12,7 +12,7 @@ describe 'pwn-vault Config RuntimeError retry' do
   let(:vault_src) { File.read(PWN::Plugins::Vault.method(:edit).source_location.first) }
   let(:block) do
     start = repl_src.index("Pry::Commands.create_command 'pwn-vault'")
-    stop = repl_src.index("Pry::Commands.create_command 'toggle-pwn-ai-debug'")
+    stop = repl_src.index("Pry::Commands.create_command 'toggle-debug'")
     repl_src[start...stop]
   end
 
@@ -133,10 +133,10 @@ describe 'pwn-vault Config RuntimeError retry' do
   end
 end
 
-describe 'toggle-pwn-ai-debug' do
+describe 'toggle-debug' do
   let(:repl_src) { File.read(PWN::Plugins::REPL.method(:add_commands).source_location.first) }
   let(:block) do
-    start = repl_src.index("Pry::Commands.create_command 'toggle-pwn-ai-debug'")
+    start = repl_src.index("Pry::Commands.create_command 'toggle-debug'")
     stop = repl_src.index("Pry::Commands.create_command 'toggle-pwn-ai-speaks'")
     repl_src[start...stop]
   end
@@ -145,6 +145,7 @@ describe 'toggle-pwn-ai-debug' do
     expect(block).to include('PWN::Plugins::Log.start_debug')
     expect(block).to include('PWN::Plugins::Log.stop_debug')
     expect(block).to include('pwn-ai-DEBUG')
+    expect(block).to include('-R')
   end
 end
 
@@ -157,9 +158,18 @@ describe 'pwn-ai debug final answer placement' do
 
   it 'prints the green final after Loop.run and does not pp the session after it' do
     expect(hook).to match(/Loop\.run\(/)
-    expect(hook).to match(/\\e\[32m\\002#\{final\}/)
+    expect(hook).to match(/\\e\[32m#\{final\}/)
+    expect(hook).not_to include('[0, 280]')
+    expect(hook).not_to include('[0, 700]')
     native = hook[hook.index('final = PWN::AI::Agent::Loop.run')..hook.index("request.replace('nil')")]
+    expect(native).not_to include('\001')
     expect(native).not_to match(/pp PWN::Sessions\.load/)
     expect(native).to match(/\$stdout\.flush/)
   end
+
+  it 'mirrors TUI task/tool/result rows into the debug RN log' do
+    expect(hook).to include('mirror_tui!')
+    expect(hook).to include('→ pwn-ai →')
+    expect(hook).to include('→ result')
+  end
 end

data/spec/lib/pwn/plugins/transparent_browser_spec.rb

@@ -12,4 +12,12 @@ describe PWN::Plugins::TransparentBrowser do
     help_response = PWN::Plugins::TransparentBrowser
     expect(help_response).to respond_to :help
   end
+
+  it 'caps Watir element waits and Selenium page_load / script timeouts' do
+    src = File.read(described_class.method(:open).source_location.first)
+    expect(src).to match(/Watir\.default_timeout\s*=\s*15/)
+    expect(src).not_to match(/Watir\.default_timeout\s*=\s*900/)
+    expect(src).to match(/page_load\s*=\s*45/)
+    expect(src).to match(/script\s*=\s*30/)
+  end
 end

data/spec/lib/pwn/sessions_spec.rb

@@ -90,4 +90,28 @@ describe PWN::Sessions do
   ensure
     FileUtils.rm_rf(tmp) if tmp
   end
+
+  it 'to_llm_messages returns this session user/assistant turns for the next LLM call' do
+    tmp = Dir.mktmpdir
+    stub_const('PWN::Sessions::SESSIONS_DIR', tmp)
+    sid = 'llm_hist_sess'
+    PWN::Sessions.create(id: sid, title: 'hist')
+    PWN::Sessions.append(session_id: sid, role: 'user', content: 'where is OpenGoal?')
+    PWN::Sessions.append(session_id: sid, role: 'assistant', content: 'in open_goal.rb')
+    PWN::Sessions.append(session_id: sid, role: 'tool', content: 'ignore me')
+    PWN::Sessions.append(session_id: sid, role: 'user', content: 'and Loop.run?')
+    PWN::Sessions.append(session_id: sid, role: 'assistant', content: 'in loop.rb around resume?')
+    msgs = PWN::Sessions.to_llm_messages(session_id: sid)
+    expect(msgs.map { |m| m[:role] }).to eq(%w[user assistant user assistant])
+    expect(msgs.map { |m| m[:content] }).to include('where is OpenGoal?', 'in open_goal.rb', 'and Loop.run?', 'in loop.rb around resume?')
+    expect(msgs.none? { |m| m[:content].to_s.include?('ignore me') }).to eq true
+    skip_last = PWN::Sessions.to_llm_messages(session_id: sid, skip_request: 'and Loop.run?')
+    expect(skip_last.last[:content]).to eq('in loop.rb around resume?')
+    expect(skip_last.none? { |m| m[:content] == 'and Loop.run?' && m[:role] == 'user' }).to eq true
+    tiny = PWN::Sessions.to_llm_messages(session_id: sid, max_chars: 40)
+    expect(tiny.last[:content]).to include('loop.rb')
+    expect(tiny.map { |m| m[:content].to_s.length }.sum).to be <= 80
+  ensure
+    FileUtils.rm_rf(tmp) if tmp
+  end
 end

data/third_party/pwn_rdoc.jsonl

@@ -283,6 +283,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.infer_success Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.infer_success`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.introspective_lessons Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.introspective_lessons`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.lean! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.lean!`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.locate_skill_for_update Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.locate_skill_for_update`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.maybe_prune_outcomes! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.maybe_prune_outcomes!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.merge_cluster Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.merge_cluster`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.note_outcome Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.note_outcome`: Supported Method Parameters\n\nentry = PWN::AI::Agent::Learning.note_outcome(\n\ntask: 'required - short description of what was attempted',\nsuccess: 'required - Boolean, did the attempt achieve its goal',\ndetails: 'optional - free-form notes / error / evidence',\nsession_id: 'optional - PWN::Sessions id this outcome belongs to',\ntags: 'optional - Array of String labels for later retrieval'\n\n)\n"}]}
@@ -296,13 +297,16 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.recover_predicted_from_session Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.recover_predicted_from_session`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.reflect Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.reflect`: Supported Method Parameters\n\nreport = PWN::AI::Agent::Learning.reflect(\n\nsession_id: 'required - PWN::Sessions id to analyse',\ndry_run: 'optional - when true, do not write to Memory/Skills (default false)'\n\n)\n\nUses PWN::AI::Agent::Reflect (when available) to LLM-summarise the session into structured lessons. Falls back to a heuristic extractor when module_reflection is disabled so learning never stops.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.reset Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.reset`: Supported Method Parameters\n\nPWN::AI::Agent::Learning.reset\n"}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.rl_skill_notes Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.rl_skill_notes`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.semantic_merge Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.semantic_merge`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.sharegpt_role Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.sharegpt_role`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.should_gc_stores? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.should_gc_stores?`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.skill_body_without_frontmatter Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.skill_body_without_frontmatter`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.skills_dir Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.skills_dir`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.stats Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.stats`: Supported Method Parameters\n\nstats = PWN::AI::Agent::Learning.stats\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.to_context Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.to_context`: Supported Method Parameters\n\nctx = PWN::AI::Agent::Learning.to_context(\n\nlimit: 'optional - number of recent outcomes to surface (default 5)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.transcript_text Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.transcript_text`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.update_skill Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.update_skill`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.verdict_for_score Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.verdict_for_score`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Learning.weighted_judge_mean Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Learning.weighted_judge_mean`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.active_engine Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.active_engine`: "}]}
@@ -319,9 +323,16 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.budget_hit? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.budget_hit?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.calibration_state Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.calibration_state`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.call_engine Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.call_engine`: Supported Method Parameters\n\nmsg = PWN::AI::Agent::Loop.call_engine(\n\nmessages: 'required - OpenAI-format messages array',\ntools: 'optional - OpenAI tools array'\n\n)\n\nReturns a normalised assistant message hash:\n\n{ role: 'assistant', content: String|nil,\n  tool_calls: [ {id:, type:'function', function:{name:, arguments:}} ],\n  _native_content: <provider raw>  (when adapter needs round-trip) }\n"}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.catalog_lookup? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.catalog_lookup?`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.chat_response_history Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.chat_response_history`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.compact_history! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.compact_history!`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.debug_final_text! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.debug_final_text!`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.debug_msgs_line Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.debug_msgs_line`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.debug_on? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.debug_on?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.debug_progress Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.debug_progress`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.debug_snippet Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.debug_snippet`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.debug_tool_io! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.debug_tool_io!`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.debug_tools_line Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.debug_tools_line`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.default_interactive_toolsets Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.default_interactive_toolsets`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.degrade_text_only Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.degrade_text_only`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.dispatch_fail_n Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.dispatch_fail_n`: "}]}
@@ -330,6 +341,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.evidence_enough_to_finalize? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.evidence_enough_to_finalize?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.expose_current_session Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.expose_current_session`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.extract_recall_match Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.extract_recall_match`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.finish_debug_request! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.finish_debug_request!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.guard_repeated_failure Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.guard_repeated_failure`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.help Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.incomplete_final? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.incomplete_final?`: "}]}
@@ -359,6 +371,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.request_need Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.request_need`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.request_unsatisfied? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.request_unsatisfied?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.run Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.run`: Supported Method Parameters\n\nfinal = PWN::AI::Agent::Loop.run(\n\nrequest: 'required - what the human typed',\nsession_id: 'optional - PWN::Sessions id (transcript is appended to it)',\nenabled_toolsets: 'optional - subset of Registry.toolsets, or nil for all',\non_tool: 'optional - ->(name, args, result) callback for live UI',\nsystem_role_content: 'optional - override default system prompt (built from session_id if not provided)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.session_chat_history Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.session_chat_history`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.should_auto_introspect? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.should_auto_introspect?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.stamped_effect Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.stamped_effect`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.start_debug_session Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.start_debug_session`: "}]}
@@ -495,6 +508,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::PromptBuilder.extrospection_block Usage"},{"role":"assistant","content":"`PWN::AI::Agent::PromptBuilder.extrospection_block`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::PromptBuilder.help Usage"},{"role":"assistant","content":"`PWN::AI::Agent::PromptBuilder.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::PromptBuilder.host_line Usage"},{"role":"assistant","content":"`PWN::AI::Agent::PromptBuilder.host_line`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::PromptBuilder.host_load_block Usage"},{"role":"assistant","content":"`PWN::AI::Agent::PromptBuilder.host_load_block`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::PromptBuilder.learning_block Usage"},{"role":"assistant","content":"`PWN::AI::Agent::PromptBuilder.learning_block`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::PromptBuilder.memory_block Usage"},{"role":"assistant","content":"`PWN::AI::Agent::PromptBuilder.memory_block`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::PromptBuilder.metrics_block Usage"},{"role":"assistant","content":"`PWN::AI::Agent::PromptBuilder.metrics_block`: "}]}
@@ -590,6 +604,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Reward.sentinel Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Reward.sentinel`: Supported Method Parameters\n\nr = PWN::AI::Agent::Reward.sentinel\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Reward.set_proxy_distrust Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Reward.set_proxy_distrust`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Reward.timeout_error? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Reward.timeout_error?`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Reward.timeout_result? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Reward.timeout_result?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Reward.usable_preference? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Reward.usable_preference?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Reward.user_correction_rate Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Reward.user_correction_rate`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Reward.verify_as_reward Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Reward.verify_as_reward`: Supported Method Parameters\n\ng = PWN::AI::Agent::Reward.verify_as_reward(final: text)\n"}]}
@@ -630,6 +645,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::TaskSummarizer.arg_snippet Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TaskSummarizer.arg_snippet`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::TaskSummarizer.authors Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TaskSummarizer.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::TaskSummarizer.brief_fingerprint Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TaskSummarizer.brief_fingerprint`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::TaskSummarizer.browse_shaped? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TaskSummarizer.browse_shaped?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::TaskSummarizer.bump_plan! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TaskSummarizer.bump_plan!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::TaskSummarizer.canonical_request Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TaskSummarizer.canonical_request`: Supported Method Parameters\n\ntext = PWN::AI::Agent::TaskSummarizer.canonical_request(\n\nrequest: 'required - raw user or wrapper string'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::TaskSummarizer.capabilities_for Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TaskSummarizer.capabilities_for`: "}]}
@@ -689,12 +705,17 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.authors Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.authors`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.bashism? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.bashism?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.coerce_args Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.coerce_args`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.deadline_s Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.deadline_s`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.help Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.host_load Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.host_load`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.invalid_payload Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.invalid_payload`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.placeholder? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.placeholder?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.present? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.present?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.shell_bash? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.shell_bash?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.shell_name Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.shell_name`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.timeout_lesson Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.timeout_lesson`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.timeout_prior_count Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.timeout_prior_count`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.timeout_result Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.timeout_result`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::TransparentBrowser.analyze Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TransparentBrowser.analyze`: Supported Method Parameters\n\nai_analysis = PWN::AI::Agent::TransparentBrowser.analyze(\n\nrequest: 'required - current step in the JavaScript debugging session to analyze',\nsource_to_review: 'required - the block of JavaScript code in which the current step resides'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::TransparentBrowser.authors Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TransparentBrowser.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::TransparentBrowser.help Usage"},{"role":"assistant","content":"`PWN::AI::Agent::TransparentBrowser.help`: "}]}
@@ -741,9 +762,9 @@
 {"messages":[{"role":"user","content":"PWN::AI::Gemini.oa_messages_to_gemini Usage"},{"role":"assistant","content":"`PWN::AI::Gemini.oa_messages_to_gemini`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.authors Usage"},{"role":"assistant","content":"`PWN::AI::Grok.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.chat Usage"},{"role":"assistant","content":"`PWN::AI::Grok.chat`: Supported Method Parameters\n\nresponse = PWN::AI::Grok.chat(\n\nrequest: 'required - message to Grok'\nmodel: 'optional - model to use for text generation (defaults to PWN::Env[:ai][:grok][:model])',\ntemp: 'optional - creative response float (deafults to PWN::Env[:ai][:grok][:temp])',\nsystem_role_content: 'optional - context to set up the model behavior for conversation (Default: PWN::Env[:ai][:grok][:system_role_content])',\nresponse_history: 'optional - pass response back in to have a conversation',\nspeak_answer: 'optional speak answer using PWN::Plugins::Voice.text_to_speech (Default: nil)',\ntimeout: 'optional timeout in seconds (defaults to 900)',\nspinner: 'optional - display spinner (defaults to false)'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::Grok.chat_with_tools Usage"},{"role":"assistant","content":"`PWN::AI::Grok.chat_with_tools`: Supported Method Parameters\n\nresponse = PWN::AI::Grok.chat_with_tools(\n\nmessages: 'required - full OpenAI-format messages array (system/user/assistant/tool)',\ntools: 'optional - OpenAI tools array [{type:\"function\", function:{...}}]',\ntool_choice: 'optional - \"auto\" | \"none\" | \"required\" | {type:\"function\", function:{name:..}}',\nmodel: 'optional - overrides PWN::Env[:ai][:grok][:model]',\ntemp: 'optional - temperature (defaults to PWN::Env[:ai][:grok][:temp] || 1)',\ntimeout: 'optional - seconds (default 900)',\nspinner: 'optional - display spinner (default false)'\n\n)\n\nReturns the raw chat/completions response Hash with :choices intact (including :message) — used by PWN::AI::Agent::Loop. xAI’s API is OpenAI-compatible for tool calling, so the request and response shapes are identical to PWN::AI::OpenAI.chat_with_tools.\n"}]}
+{"messages":[{"role":"user","content":"PWN::AI::Grok.chat_with_tools Usage"},{"role":"assistant","content":"`PWN::AI::Grok.chat_with_tools`: Supported Method Parameters\n\nresponse = PWN::AI::Grok.chat_with_tools(\n\nmessages: 'required - full OpenAI-format messages array (system/user/assistant/tool)',\ntools: 'optional - OpenAI tools array [{type:\"function\", function:{...}}]',\ntool_choice: 'optional - \"auto\" | \"none\" | \"required\" | {type:\"function\", function:{name:..}}',\nmodel: 'optional - overrides PWN::Env[:ai][:grok][:model]',\ntemp: 'optional - temperature (defaults to PWN::Env[:ai][:grok][:temp] || 1)',\ntimeout: 'optional - seconds (default 180)',\nspinner: 'optional - display spinner (default false)'\n\n)\n\nReturns the raw chat/completions response Hash with :choices intact (including :message) — used by PWN::AI::Agent::Loop. xAI’s API is OpenAI-compatible for tool calling, so the request and response shapes are identical to PWN::AI::OpenAI.chat_with_tools.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.get_models Usage"},{"role":"assistant","content":"`PWN::AI::Grok.get_models`: Supported Method Parameters\n\nmodels = PWN::AI::Grok.get_models\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::Grok.grok_rest_call Usage"},{"role":"assistant","content":"`PWN::AI::Grok.grok_rest_call`: Supported Method Parameters\n\ngrok_ai_rest_call(\n\ntoken: 'required - grok_ai bearer token',\nhttp_method: 'optional HTTP method (defaults to GET)\nbase_uri: 'optional base grok api URI (defaults to https://api.x.ai/v1)',\nrest_call: 'required rest call to make per the schema',\nparams: 'optional params passed in the URI or HTTP Headers',\nhttp_body: 'optional HTTP body sent in HTTP methods that support it e.g. POST',\ntimeout: 'optional timeout in seconds (defaults to 900)',\nspinner: 'optional - display spinner (defaults to false)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::AI::Grok.grok_rest_call Usage"},{"role":"assistant","content":"`PWN::AI::Grok.grok_rest_call`: Supported Method Parameters\n\ngrok_ai_rest_call(\n\ntoken: 'required - grok_ai bearer token',\nhttp_method: 'optional HTTP method (defaults to GET)\nbase_uri: 'optional base grok api URI (defaults to https://api.x.ai/v1)',\nrest_call: 'required rest call to make per the schema',\nparams: 'optional params passed in the URI or HTTP Headers',\nhttp_body: 'optional HTTP body sent in HTTP methods that support it e.g. POST',\ntimeout: 'optional timeout in seconds (defaults to 180; 5 attempts)',\nspinner: 'optional - display spinner (defaults to false)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.help Usage"},{"role":"assistant","content":"`PWN::AI::Grok.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.jwt_exp Usage"},{"role":"assistant","content":"`PWN::AI::Grok.jwt_exp`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.oauth_token_expiring? Usage"},{"role":"assistant","content":"`PWN::AI::Grok.oauth_token_expiring?`: "}]}
@@ -752,6 +773,12 @@
 {"messages":[{"role":"user","content":"PWN::AI::Grok.real_config_value? Usage"},{"role":"assistant","content":"`PWN::AI::Grok.real_config_value?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.refresh_oauth_bearer_token Usage"},{"role":"assistant","content":"`PWN::AI::Grok.refresh_oauth_bearer_token`: Supported Method Parameters\n\naccess_token = PWN::AI::Grok.refresh_oauth_bearer_token(\n\nrefresh_token: 'required - xAI OAuth refresh_token',\nclient_id:     'optional - defaults to public Grok-CLI client',\ntoken_uri:     'optional - defaults to https://auth.x.ai/oauth2/token'\n\n)\n\nExchanges a refresh_token for a fresh access_token at auth.x.ai. On success, writes :bearer_token (and a rotated :refresh_token if returned) back into the passed opts/oauth Hash so the live PWN::Env stays warm for the rest of the process. Also mirrors those values onto PWN::Env[:grok] when that Hash is available, then attempts to re-encrypt the updated tokens into ~/.pwn/pwn.yaml when the matching decryptor (key + iv) is present.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.sync_oauth_into_env Usage"},{"role":"assistant","content":"`PWN::AI::Grok.sync_oauth_into_env`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::HttpRetry.authors Usage"},{"role":"assistant","content":"`PWN::AI::HttpRetry.authors`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::HttpRetry.help Usage"},{"role":"assistant","content":"`PWN::AI::HttpRetry.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::HttpRetry.max_attempts Usage"},{"role":"assistant","content":"`PWN::AI::HttpRetry.max_attempts`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::HttpRetry.report_event Usage"},{"role":"assistant","content":"`PWN::AI::HttpRetry.report_event`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::HttpRetry.retry_after_s Usage"},{"role":"assistant","content":"`PWN::AI::HttpRetry.retry_after_s`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::HttpRetry.timeout_s Usage"},{"role":"assistant","content":"`PWN::AI::HttpRetry.timeout_s`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.assemble_native_chat_stream Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.assemble_native_chat_stream`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.assemble_ollama_stream Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.assemble_ollama_stream`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.assemble_openai_compat_stream Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.assemble_openai_compat_stream`: "}]}
@@ -1881,19 +1908,26 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::JiraDataCenter.update_issue Usage"},{"role":"assistant","content":"`PWN::Plugins::JiraDataCenter.update_issue`: Supported Method Parameters\n\nissue_resp = PWN::Plugins::JiraDataCenter.update_issue(\n\nfields: 'required - fields to update in the issue (e.g. summary, description, labels, components, custom fields, etc.)',\nattachments: 'optional - array of attachment paths to upload to the issue (e.g. [\"/tmp/file1.txt\", \"/tmp/file2.txt\"])',\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.append Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.append`: Supported Method Parameters\n\nPWN::Log.create( )\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.close_debug_file! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.close_debug_file!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.color_progress Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.color_progress`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.debug_enabled? Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.debug_enabled?`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.debug_log_path Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.debug_log_path`: "}]}
-{"messages":[{"role":"user","content":"PWN::Plugins::Log.debug_path_parts Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.debug_path_parts`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.finish_request_log! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.finish_request_log!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.format_debug_hash Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.format_debug_hash`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.format_progress Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.format_progress`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.format_trace_call Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.format_trace_call`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.help Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.inspect_debug Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.inspect_debug`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.loud_tui! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.loud_tui!`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.mirror_tui! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.mirror_tui!`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.next_debug_request_n Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.next_debug_request_n`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.next_request_log! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.next_request_log!`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.note_exception! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.note_exception!`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.note_interrupt! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.note_interrupt!`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.open_debug_file! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.open_debug_file!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.progress Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.progress`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.quiet_tui! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.quiet_tui!`: "}]}
-{"messages":[{"role":"user","content":"PWN::Plugins::Log.roll_debug_log! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.roll_debug_log!`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.sanitize_debug_session_id Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.sanitize_debug_session_id`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.sanitize_debug_text Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.sanitize_debug_text`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.secret_key? Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.secret_key?`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Log.start_debug Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.start_debug`: "}]}
@@ -2155,6 +2189,7 @@
 {"messages":[{"role":"user","content":"PWN::Plugins::Tor.stop Usage"},{"role":"assistant","content":"`PWN::Plugins::Tor.stop`: Supported Method Parameters\n\nPWN::Plugins::Tor.stop(\n\ntor_obj: 'required - tor_obj returned from #start method'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Tor.switch_exit_node Usage"},{"role":"assistant","content":"`PWN::Plugins::Tor.switch_exit_node`: Supported Method Parameters\n\nPWN::Plugins::Tor.switch_exit_node(\n\ntor_obj: 'required - tor_obj returned from #start method',\nresponse_timeout: 'optional - float in seconds to timeout (default: 3.0)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::Tor.tor_control_cmd Usage"},{"role":"assistant","content":"`PWN::Plugins::Tor.tor_control_cmd`: Supported Method Parameters\n\ntor_ctrl_cmd(\n\ntor_obj: 'required - tor_obj returned from #start method'\ncmd: 'required - Tor control command to execute',\nresponse_timeout: 'optional - float in seconds to timeout (default: 3.0)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.apply_driver_timeouts! Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.apply_driver_timeouts!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.breakpoint_locations Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.breakpoint_locations`: Supported Method Parameters\n\npage_state_arr = PWN::Plugins::TransparentBrowser.breakpoint_locations(\n\nbrowser_obj: 'required - browser_obj returned from #open method)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::TransparentBrowser.close Usage"},{"role":"assistant","content":"`PWN::Plugins::TransparentBrowser.close`: Supported Method Parameters\n\nbrowser_obj1 = PWN::Plugins::TransparentBrowser.close(\n\nbrowser_obj: 'required - browser_obj returned from #open method)'\n\n)\n"}]}
@@ -2722,7 +2757,7 @@
 {"messages":[{"role":"user","content":"PWN::Sessions.append Usage"},{"role":"assistant","content":"`PWN::Sessions.append`: Supported Method Parameters\n\nPWN::Sessions.append(\n\nsession_id: 'required',\nrole: 'user|assistant|system|observation',\ncontent: 'the message or obs'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.authors Usage"},{"role":"assistant","content":"`PWN::Sessions.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.compact_transcript! Usage"},{"role":"assistant","content":"`PWN::Sessions.compact_transcript!`: "}]}
-{"messages":[{"role":"user","content":"PWN::Sessions.create Usage"},{"role":"assistant","content":"`PWN::Sessions.create`: Supported Method Parameters\n\nsession = PWN::Sessions.create(\n\ntitle: 'optional - human title',\nsource: 'optional - e.g. pwn-ai-repl',\nid: 'optional - fixed session id (tests / replay); default timestamp_hex'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Sessions.create Usage"},{"role":"assistant","content":"`PWN::Sessions.create`: Supported Method Parameters\n\nsession = PWN::Sessions.create(\n\ntitle: 'optional - human title',\nsource: 'optional - e.g. pwn-ai',\nid: 'optional - fixed session id (tests / replay); default timestamp_hex'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.delete Usage"},{"role":"assistant","content":"`PWN::Sessions.delete`: Supported Method Parameters\n\nPWN::Sessions.delete(\n\nsession_id: 'required',\nforce: 'optional - Boolean bypass pin policy (default false)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.help Usage"},{"role":"assistant","content":"`PWN::Sessions.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.lean! Usage"},{"role":"assistant","content":"`PWN::Sessions.lean!`: Supported Method Parameters\n\nresult = PWN::Sessions.lean!(\n\ndry_run: 'optional - Boolean (default false)',\nretain_days: 'optional - drop unreferenced older than this',\nhot_days: 'optional - always keep newer than this',\nmax_files: 'optional - soft file cap after protections',\ncurrent_session_id: 'optional - never delete this id'\n\n)\n"}]}
@@ -2735,6 +2770,7 @@
 {"messages":[{"role":"user","content":"PWN::Sessions.sessions_dir Usage"},{"role":"assistant","content":"`PWN::Sessions.sessions_dir`: Supported Method Parameters\n\ndir = PWN::Sessions.sessions_dir\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.stats Usage"},{"role":"assistant","content":"`PWN::Sessions.stats`: Supported Method Parameters\n\nstats = PWN::Sessions.stats\n"}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.stub_session? Usage"},{"role":"assistant","content":"`PWN::Sessions.stub_session?`: "}]}
+{"messages":[{"role":"user","content":"PWN::Sessions.to_llm_messages Usage"},{"role":"assistant","content":"`PWN::Sessions.to_llm_messages`: "}]}
 {"messages":[{"role":"user","content":"PWN::Sessions.to_response_history Usage"},{"role":"assistant","content":"`PWN::Sessions.to_response_history`: Supported Method Parameters\n\nhistory_for_ai = PWN::Sessions.to_response_history(session_id:) (converts transcript to the response_history format used by PWN::AI::* .chat)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Setup.ai_active_engine Usage"},{"role":"assistant","content":"`PWN::Setup.ai_active_engine`: "}]}
 {"messages":[{"role":"user","content":"PWN::Setup.ai_key_configured? Usage"},{"role":"assistant","content":"`PWN::Setup.ai_key_configured?`: "}]}

data/tmp_pwn_critic_skills_flaw.txt

@@ -0,0 +1,9 @@
+pwn_critic swarm 20260819_214041_e6ff4d
+REQUEST: what skills are available?
+LIVE INDEX: /home/ninp0/.pwn/skills
+LIVE COUNT: 103
+CANDIDATE CLAIM: 103 skills, complete A-Z list
+CANDIDATE LISTED: 24 names, last item truncated at "document-to-action-items -- Extract cited obligations, deadli"
+MISSING COUNT: 79
+VERDICT: FLAW
+ONE LINE: Claims 103 skills from the live SKILLS index but the list stops at item 24 mid-word; 79 skills are omitted.