pwn 0.5.684 → 0.5.686

data/spec/lib/pwn/ai/ollama_spec.rb

@@ -321,12 +321,7 @@ describe PWN::AI::Ollama do
     expect(args[:command] || args['command']).to eq('id')
   end
 
-  it 'exposes get_plan_usage for the PS1 subscription suffix' do
-    expect(described_class).to respond_to(:get_plan_usage)
-  end
-  it 'marks local plan usage as unlimited so the PS1 shows infinity' do
-    usage = described_class.get_plan_usage
-    expect(usage[:available]).to be false
-    expect(usage[:unlimited]).to be true
+  it 'does not expose get_plan_usage' do
+    expect(described_class).not_to respond_to(:get_plan_usage)
   end
 end

data/spec/lib/pwn/ai/open_ai_spec.rb

@@ -18,29 +18,8 @@ describe PWN::AI::OpenAI do
     expect(src).to match(/openai_wire_messages/)
   end
 
-  it 'exposes get_plan_usage for the PS1 subscription suffix' do
-    expect(described_class).to respond_to(:get_plan_usage)
-  end
-  it 'computes a percentage from dashboard billing used vs hard limit' do
-    allow(described_class).to receive(:plan_usage_credentials?).and_return(true)
-    allow(described_class).to receive(:open_ai_rest_call) do |**kwargs|
-      case kwargs[:rest_call]
-      when 'dashboard/billing/subscription'
-        '{"hard_limit_usd":100.0}'
-      when 'dashboard/billing/usage'
-        '{"total_usage":1900}'
-      else
-        '{"error":"no"}'
-      end
-    end
-    usage = described_class.get_plan_usage
-    expect(usage[:available]).to be true
-    expect(usage[:percent]).to eq(19)
-  end
-
-  it 'returns unavailable when credentials are missing' do
-    allow(described_class).to receive(:plan_usage_credentials?).and_return(false)
-    expect(described_class.get_plan_usage[:available]).to be false
+  it 'does not expose get_plan_usage' do
+    expect(described_class).not_to respond_to(:get_plan_usage)
   end
 
   it 'open_ai_rest_call swallows ReadTimeout quietly without ERROR: print' do

data/spec/lib/pwn/ai/open_web_ui_spec.rb

@@ -300,12 +300,7 @@ describe PWN::AI::OpenWebUI do
     expect(args[:command] || args['command']).to eq('id')
   end
 
-  it 'exposes get_plan_usage for the PS1 subscription suffix' do
-    expect(described_class).to respond_to(:get_plan_usage)
-  end
-  it 'marks local plan usage as unlimited so the PS1 shows infinity' do
-    usage = described_class.get_plan_usage
-    expect(usage[:available]).to be false
-    expect(usage[:unlimited]).to be true
+  it 'does not expose get_plan_usage' do
+    expect(described_class).not_to respond_to(:get_plan_usage)
   end
 end

data/spec/lib/pwn/ai_spec.rb

@@ -8,26 +8,9 @@ describe PWN::AI do
     expect(help_response).not_to be_nil
   end
 
-  it 'normalizes used/limit into a clamped percentage' do
-    usage = described_class.normalize_plan_usage(used: 19, limit: 100, engine: :grok)
-    expect(usage[:available]).to be true
-    expect(usage[:percent]).to eq(19)
-  end
-
-  it 'returns the infinity glyph for ollama and openwebui' do
-    expect(described_class.plan_usage_glyph(engine: :ollama)).to eq("\u221E")
-    expect(described_class.plan_usage_glyph(engine: :openwebui)).to eq("\u221E")
-  end
-
-  it 'returns a percent glyph when usage data is available' do
-    glyph = described_class.plan_usage_glyph(
-      engine: :grok,
-      usage: { available: true, percent: 19 }
-    )
-    expect(glyph).to eq('19%')
-  end
-
-  it 'returns infinity when a hosted engine has no usage data' do
-    expect(described_class.plan_usage_glyph(engine: :gemini, usage: { available: false })).to eq("\u221E")
+  it 'does not expose plan-usage helpers' do
+    expect(described_class).not_to respond_to(:normalize_plan_usage)
+    expect(described_class).not_to respond_to(:plan_usage)
+    expect(described_class).not_to respond_to(:plan_usage_glyph)
   end
 end

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

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'spec_helper'
+require 'stringio'
 
 describe PWN::Plugins::Log do
   it 'should display information for authors' do
@@ -12,4 +13,142 @@ describe PWN::Plugins::Log do
     help_response = PWN::Plugins::Log
     expect(help_response).to respond_to :help
   end
+
+  describe 'pwn-ai debug session' do
+    after do
+      PWN::Plugins::Log.stop_debug if PWN::Plugins::Log.respond_to?(:stop_debug)
+    end
+
+    it 'starts a /tmp/pwn-ai-DEBUG-TIMESTAMP.log and tees progress to TUI + file' do
+      expect(PWN::Plugins::Log).to respond_to(:start_debug)
+      expect(PWN::Plugins::Log).to respond_to(:stop_debug)
+      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)
+
+      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)
+      expect(PWN::Plugins::Log.debug_enabled?).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)
+      expect(ok).to eq(true)
+      body = File.read(path)
+      expect(body).to include('Loop.run start request=hi')
+      expect(body).to include('PWN::AI::Agent::Loop')
+      expect(tee.string).to include('Loop.run start request=hi')
+
+      PWN::Plugins::Log.stop_debug
+      expect(PWN::Plugins::Log.debug_enabled?).to eq(false)
+      expect(PWN::Plugins::Log.progress(msg: 'after stop', which_self: self)).to eq(false)
+    end
+
+    it 'quiet_tui keeps writing the file but stops teeing to the TUI' do
+      expect(PWN::Plugins::Log).to respond_to(:quiet_tui!)
+      expect(PWN::Plugins::Log).to respond_to(:loud_tui!)
+      tee = StringIO.new
+      path = PWN::Plugins::Log.start_debug(tee: tee, path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-quiet.log")
+      PWN::Plugins::Log.progress(msg: 'before-quiet', which_self: PWN::AI::Agent::Loop)
+      PWN::Plugins::Log.quiet_tui!
+      PWN::Plugins::Log.progress(msg: 'after-quiet', which_self: PWN::AI::Agent::Loop)
+      expect(tee.string).to include('before-quiet')
+      expect(tee.string).not_to include('after-quiet')
+      expect(File.read(path)).to include('after-quiet')
+      PWN::Plugins::Log.loud_tui!
+      PWN::Plugins::Log.progress(msg: 'after-loud', which_self: PWN::AI::Agent::Loop)
+      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')
+    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")
+      PWN::AI::Agent::OpenGoal.current if defined?(PWN::AI::Agent::OpenGoal)
+      body = File.read(path)
+      expect(body).to match(/PWN::AI::Agent::OpenGoal/)
+    end
+
+    it 'does not raise when a traced module #name is a Symbol' do
+      probe = Module.new do
+        def self.name
+          :symname
+        end
+
+        def self.ping
+          :ok
+        end
+      end
+      stub_const('PWN::AI::Agent::SymNameProbe', probe)
+      PWN::Plugins::Log.start_debug(
+        tee: StringIO.new,
+        path: "/tmp/pwn-ai-DEBUG-#{Process.pid}-sym.log"
+      )
+      expect { PWN::AI::Agent::SymNameProbe.ping }.not_to raise_error
+    end
+
+    it 'logs the complete traced call including parameters' do
+      probe = Module.new do
+        def self.echo(opts = {})
+          opts[:msg]
+        end
+      end
+      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"
+      )
+      PWN::AI::Agent::ArgProbe.echo(
+        msg: 'hello-browser',
+        url: 'https://example.test/open',
+        password: 's3cret-token'
+      )
+      body = File.read(path)
+      expect(body).to include('PWN::AI::Agent::ArgProbe.echo')
+      expect(body).to include('hello-browser')
+      expect(body).to include('https://example.test/open')
+      expect(body).not_to include('s3cret-token')
+      expect(body).to match(/\[REDACTED\]/)
+    end
+
+    it 'redacts secret-shaped values even when the key is not a password name' do
+      probe = Module.new do
+        def self.echo(opts = {})
+          opts[:msg]
+        end
+      end
+      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"
+      )
+      PWN::AI::Agent::ArgProbe.echo(
+        header: 'Bearer eyJhbGciOiJIUzI1NiJ9.aaa.bbb',
+        blob: "-----BEGIN PRIVATE KEY-----\nMIIB\n-----END PRIVATE KEY-----",
+        note: 'xai-abcdefghijklmnopqrstuvwxyz0123456789ABCD'
+      )
+      PWN::Plugins::Log.progress(
+        msg: 'Loop.run start request=use key sk-live-SUPERSECRET999',
+        which_self: PWN::AI::Agent::Loop
+      )
+      body = File.read(path)
+      expect(body).not_to include('eyJhbGciOiJIUzI1NiJ9')
+      expect(body).not_to include('BEGIN PRIVATE KEY')
+      expect(body).not_to include('xai-abcdefghijklmnopqrstuvwxyz0123456789ABCD')
+      expect(body).not_to include('sk-live-SUPERSECRET999')
+      expect(body).to match(/\[REDACTED\]/)
+    end
+  end
 end

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

@@ -132,3 +132,34 @@ describe 'pwn-vault Config RuntimeError retry' do
     end
   end
 end
+
+describe 'toggle-pwn-ai-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'")
+    stop = repl_src.index("Pry::Commands.create_command 'toggle-pwn-ai-speaks'")
+    repl_src[start...stop]
+  end
+
+  it 'starts and stops PWN::Plugins::Log debug session on the TUI toggle' 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')
+  end
+end
+
+describe 'pwn-ai debug final answer placement' do
+  let(:repl_src) { File.read(PWN::Plugins::REPL.method(:add_commands).source_location.first) }
+  let(:hook) do
+    start = repl_src.index('Pry.config.hooks.add_hook(:after_read, :pwn_ai_hook)')
+    repl_src[start..]
+  end
+
+  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\}/)
+    native = hook[hook.index('final = PWN::AI::Agent::Loop.run')..hook.index("request.replace('nil')")]
+    expect(native).not_to match(/pp PWN::Sessions\.load/)
+    expect(native).to match(/\$stdout\.flush/)
+  end
+end

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

@@ -13,10 +13,11 @@ describe PWN::Plugins::REPL do
     expect(help_response).to respond_to :help
   end
 
-  it 'appends plan usage after the token budget in the pwn.ai PS1' do
+  it 'does not append plan usage to the pwn.ai PS1' do
     src = File.read(described_class.method(:refresh_ps1_proc).source_location.first)
-    expect(src).to include('PWN::AI.plan_usage_glyph(engine: engine)')
-    expect(src).to include("\#{current_context_length}/\#{plan_usage_glyph}")
+    expect(src).not_to include('plan_usage_glyph')
+    expect(src).not_to include('PWN::AI.plan_usage')
+    expect(src).to include('current_context_length')
   end
 
   it 'formats compact token counts for the PS1 budget' do

data/third_party/pwn_rdoc.jsonl

@@ -1,9 +1,6 @@
 {"messages":[{"role":"user","content":"PWN.help Usage"},{"role":"assistant","content":"`PWN.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI.authors Usage"},{"role":"assistant","content":"`PWN::AI.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI.help Usage"},{"role":"assistant","content":"`PWN::AI.help`: "}]}
-{"messages":[{"role":"user","content":"PWN::AI.normalize_plan_usage Usage"},{"role":"assistant","content":"`PWN::AI.normalize_plan_usage`: Supported Method Parameters\n\nusage = PWN::AI.normalize_plan_usage(\n\nused: 'required - numeric used amount',\nlimit: 'required - numeric limit / allowance',\nsource: 'optional - endpoint / origin label',\nengine: 'optional - engine symbol'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI.plan_usage Usage"},{"role":"assistant","content":"`PWN::AI.plan_usage`: Supported Method Parameters\n\nusage = PWN::AI.plan_usage(\n\nengine: 'optional - engine symbol (defaults to PWN::Env[:ai][:active])',\nttl: 'optional - cache seconds (default 60)',\nforce: 'optional - bypass cache (default false)'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI.plan_usage_glyph Usage"},{"role":"assistant","content":"`PWN::AI.plan_usage_glyph`: Supported Method Parameters\n\nglyph = PWN::AI.plan_usage_glyph(\n\nengine: 'optional - engine symbol (defaults to PWN::Env[:ai][:active])',\nusage: 'optional - precomputed usage hash'\n\n)\n\nReturns “19%” when used/limit are known, otherwise the infinity glyph. Local engines (ollama / openwebui) always return infinity.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent.authors Usage"},{"role":"assistant","content":"`PWN::AI::Agent.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent.help Usage"},{"role":"assistant","content":"`PWN::AI::Agent.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Assembly.analyze Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Assembly.analyze`: Supported Method Parameters\n\nai_analysis = PWN::AI::Agent::Assembly.analyze(\n\nrequest: 'required - the assembly opcodes or instructions to be analyzed',\ntype: 'required - :opcodes_to_asm|:asm_to_opcodes - specify the type of analysis to perform',\narch: 'required - name of arch returned from `PWN::Plugins::Assembly.list_supported_archs` (e.g., :i386|:i686|:x86|:x64|:arm|:arm64, etc.)',\nendian: 'required - the endianness of the assembly code (e.g., :little|:big)'\n\n)\n"}]}
@@ -323,6 +320,8 @@
 {"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.compact_history! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.compact_history!`: "}]}
+{"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.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`: "}]}
@@ -336,6 +335,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.incomplete_final? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.incomplete_final?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.inject_task_focus! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.inject_task_focus!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.local_engine? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.local_engine?`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.loud_debug_tui! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.loud_debug_tui!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.max_iters Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.max_iters`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.may_finalize? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.may_finalize?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.maybe_extinguish_parked! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.maybe_extinguish_parked!`: "}]}
@@ -352,8 +352,8 @@
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.parse_tool_arguments Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.parse_tool_arguments`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.plan_first Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.plan_first`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.publish_usage Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.publish_usage`: "}]}
+{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.quiet_debug_tui! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.quiet_debug_tui!`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.recall_target Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.recall_target`: "}]}
-{"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.recon_authorized? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.recon_authorized?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.record_metrics Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.record_metrics`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.request_intent Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.request_intent`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.request_need Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.request_need`: "}]}
@@ -361,6 +361,7 @@
 {"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.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`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.stringify_tool_arguments Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.stringify_tool_arguments`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.stub_outline? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.stub_outline?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Agent::Loop.task_summary_about_to! Usage"},{"role":"assistant","content":"`PWN::AI::Agent::Loop.task_summary_about_to!`: "}]}
@@ -692,9 +693,6 @@
 {"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.recon_authorized? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.recon_authorized?`: "}]}
-{"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.recon_blocked Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.recon_blocked`: "}]}
-{"messages":[{"role":"user","content":"PWN::AI::Agent::ToolGuard.recon_text? Usage"},{"role":"assistant","content":"`PWN::AI::Agent::ToolGuard.recon_text?`: "}]}
 {"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::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"}]}
@@ -721,21 +719,16 @@
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.authors Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.chat Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.chat`: Supported Method Parameters\n\nresponse = PWN::AI::Anthropic.chat(\n\nrequest: 'required - message to Anthropic',\nmodel: 'optional - model to use for text generation (defaults to PWN::Env[:ai][:anthropic][:model])',\ntemp: 'optional - creative response float (defaults to PWN::Env[:ai][:anthropic][:temp])',\nsystem_role_content: 'optional - context to set up the model behavior for conversation (Default: PWN::Env[:ai][:anthropic][: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::Anthropic.chat_with_tools Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.chat_with_tools`: Supported Method Parameters\n\nresponse = PWN::AI::Anthropic.chat_with_tools(\n\nmessages: 'required - 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][:anthropic][:model]',\ntemp: 'optional - temperature (defaults to PWN::Env[:ai][:anthropic][:temp] || 1)',\nmax_tokens: 'optional - defaults to PWN::Env[:ai][:anthropic][:max_tokens] || 128_000',\ntimeout: 'optional - seconds (default 900)',\nspinner: 'optional - display spinner (default false)'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::Anthropic.first_rate_limit Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.first_rate_limit`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.get_models Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.get_models`: Supported Method Parameters\n\nmodels = PWN::AI::Anthropic.get_models\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::Anthropic.get_plan_usage Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.get_plan_usage`: Supported Method Parameters\n\nusage = PWN::AI::Anthropic.get_plan_usage(\n\ntimeout: 'optional - seconds (default 8)'\n\n)\n\nAdmin Usage API (organizations/usage_report/messages) yields tokens used; organizations/rate_limits yields the configured ceiling so the PS1 can show a percent. Individual accounts without an Admin key return {available:false}. Never prompts for credentials.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.help Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.jwt_exp Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.jwt_exp`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.oa_messages_to_anthropic Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.oa_messages_to_anthropic`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.oauth_token_expiring? Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.oauth_token_expiring?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.obtain_oauth_bearer_token Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.obtain_oauth_bearer_token`: Supported Method Parameters\n\nbearer = PWN::AI::Anthropic.obtain_oauth_bearer_token(\n\nclient_id:    'optional - Claude Code public client id',\nscope:        'optional - space-delimited scopes',\nredirect_uri: 'optional - must match registered callback',\nauthorize_uri:'optional - claude.ai authorize endpoint',\ntoken_uri:    'optional - platform.claude.com token endpoint'\n\n)\n\nRuns the OAuth 2.0 Authorization Code + PKCE (S256) flow against Anthropic’s public Claude Code client. The hosted redirect returns a pasteable code (code=true) so this works over SSH with no localhost listener – same UX class as the Grok device flow.\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::Anthropic.parse_plan_usage_json Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.parse_plan_usage_json`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.persist_oauth_to_vault Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.persist_oauth_to_vault`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.pkce_pair Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.pkce_pair`: "}]}
-{"messages":[{"role":"user","content":"PWN::AI::Anthropic.plan_usage_credentials? Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.plan_usage_credentials?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.real_config_value? Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.real_config_value?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.refresh_oauth_bearer_token Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.refresh_oauth_bearer_token`: Supported Method Parameters\n\naccess_token = PWN::AI::Anthropic.refresh_oauth_bearer_token(\n\nrefresh_token: 'required - Anthropic OAuth refresh_token',\nclient_id:     'optional - defaults to Claude Code public client',\ntoken_uri:     'optional - defaults to platform.claude.com token endpoint'\n\n) 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[:anthropic] 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::Anthropic.sum_usage_tokens Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.sum_usage_tokens`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Anthropic.sync_oauth_into_env Usage"},{"role":"assistant","content":"`PWN::AI::Anthropic.sync_oauth_into_env`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Gemini.authors Usage"},{"role":"assistant","content":"`PWN::AI::Gemini.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Gemini.chat Usage"},{"role":"assistant","content":"`PWN::AI::Gemini.chat`: Supported Method Parameters\n\nresponse = PWN::AI::Gemini.chat(\n\nrequest: 'required - message to Gemini',\nmodel: 'optional - model to use for text generation (defaults to PWN::Env[:ai][:gemini][:model])',\ntemp: 'optional - creative response float (defaults to PWN::Env[:ai][:gemini][:temp])',\nsystem_role_content: 'optional - context to set up the model behavior for conversation (Default: PWN::Env[:ai][:gemini][: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"}]}
@@ -744,28 +737,21 @@
 {"messages":[{"role":"user","content":"PWN::AI::Gemini.gemini_rest_call Usage"},{"role":"assistant","content":"`PWN::AI::Gemini.gemini_rest_call`: Supported Method Parameters\n\ngemini_rest_call(\n\nhttp_method: 'optional HTTP method (defaults to GET)',\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::Gemini.gemini_tool_config Usage"},{"role":"assistant","content":"`PWN::AI::Gemini.gemini_tool_config`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Gemini.get_models Usage"},{"role":"assistant","content":"`PWN::AI::Gemini.get_models`: Supported Method Parameters\n\nmodels = PWN::AI::Gemini.get_models\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::Gemini.get_plan_usage Usage"},{"role":"assistant","content":"`PWN::AI::Gemini.get_plan_usage`: Supported Method Parameters\n\nusage = PWN::AI::Gemini.get_plan_usage(\n\ntimeout: 'optional - seconds (default 8)'\n\n)\n\nGemini Generative Language has no subscription-usage endpoint that returns used-vs-limit for an API key. Cached-miss / unavailable so the PS1 shows ∞ unless the operator later injects used/limit.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Gemini.help Usage"},{"role":"assistant","content":"`PWN::AI::Gemini.help`: "}]}
 {"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.cents_val Usage"},{"role":"assistant","content":"`PWN::AI::Grok.cents_val`: "}]}
 {"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.first_numeric Usage"},{"role":"assistant","content":"`PWN::AI::Grok.first_numeric`: "}]}
 {"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.get_plan_usage Usage"},{"role":"assistant","content":"`PWN::AI::Grok.get_plan_usage`: Supported Method Parameters\n\nusage = PWN::AI::Grok.get_plan_usage(\n\ntimeout: 'optional - seconds (default 8)'\n\n)\n\nSubscription / team usage for the PS1 percent suffix. GET /v1/api-key yields team_id; then billing preview / spending-limits / prepaid balance compute used vs limit. GET /v1/me is also tried (OAuth personal-team payload).\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.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?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.obtain_oauth_bearer_token Usage"},{"role":"assistant","content":"`PWN::AI::Grok.obtain_oauth_bearer_token`: Supported Method Parameters\n\nbearer = PWN::AI::Grok.obtain_oauth_bearer_token(\n\nclient_id: 'optional - xAI OAuth Client ID (defaults to public Grok-CLI client)',\nscope:     'optional - space-delimited scopes (defaults to XAI_OAUTH_SCOPE)',\ntimeout:   'optional - seconds to wait for user consent (default 300)'\n\n)\n\nRuns the RFC 8628 OAuth 2.0 Device Authorization Grant against auth.x.ai using xAI’s public Grok-CLI client (no client_secret). This is the same identity path ‘hermes auth add xai-oauth` uses – a SuperGrok / X Premium+ subscription on the account is what grants api:access at consent time.\n\n1. POST /oauth2/device/code    -> device_code, user_code, verification_uri\n2. User opens verification_uri_complete in a browser and approves.\n3. Poll POST /oauth2/token (grant_type=device_code) until access_token.\n\nOn success the access_token + refresh_token are written back into the passed opts/oauth Hash (so PWN::Env[:grok] is live-cached) and the operator is told exactly what to persist via pwn-vault.\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::Grok.parse_plan_usage_json Usage"},{"role":"assistant","content":"`PWN::AI::Grok.parse_plan_usage_json`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Grok.persist_oauth_to_vault Usage"},{"role":"assistant","content":"`PWN::AI::Grok.persist_oauth_to_vault`: "}]}
-{"messages":[{"role":"user","content":"PWN::AI::Grok.plan_usage_credentials? Usage"},{"role":"assistant","content":"`PWN::AI::Grok.plan_usage_credentials?`: "}]}
 {"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::Grok.to_f_or_nil Usage"},{"role":"assistant","content":"`PWN::AI::Grok.to_f_or_nil`: "}]}
 {"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`: "}]}
@@ -773,7 +759,6 @@
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.chat Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.chat`: Supported Method Parameters\n\nresponse = PWN::AI::Ollama.chat(\n\nrequest: 'required - message to Ollama'\nmodel: 'optional - model to use for text generation (defaults to PWN::Env[:ai][:ollama][:model])',\ntemp: 'optional - creative response float (defaults to PWN::Env[:ai][:ollama][:temp])',\nsystem_role_content: 'optional - context to set up the model behavior for conversation (Default: PWN::Env[:ai][:ollama][: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::Ollama.chat_with_tools Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.chat_with_tools`: Supported Method Parameters\n\nresponse = PWN::AI::Ollama.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\" | {type:\"function\", function:{name:..}}',\nmodel: 'optional - overrides PWN::Env[:ai][:ollama][:model]',\ntemp: 'optional - temperature (defaults to PWN::Env[:ai][:ollama][:temp] || 1)',\ntimeout: 'optional - seconds (default 900)',\nspinner: 'optional - display spinner (default false)'\n\n)\n\nHits Ollama NATIVE POST /api/chat so options.num_ctx / num_predict / keep_alive take effect. Streaming is ON; ollama_rest_call assembles NDJSON chunks back into a single response.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.get_models Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.get_models`: Supported Method Parameters\n\nresponse = PWN::AI::Ollama.get_models\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::Ollama.get_plan_usage Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.get_plan_usage`: Supported Method Parameters\n\nusage = PWN::AI::Ollama.get_plan_usage\n\nLocal Ollama has no subscription / plan-usage endpoint. Always unavailable so the PS1 shows the infinity glyph.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.help Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.normalize_messages_for_ollama Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.normalize_messages_for_ollama`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::Ollama.ollama_rest_call Usage"},{"role":"assistant","content":"`PWN::AI::Ollama.ollama_rest_call`: Supported Method Parameters\n\nollama_rest_call(\n\nhttp_method: 'optional HTTP method (defaults to GET)',\nrest_call: 'required rest call path relative to base_uri (e.g. api/chat)',\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"}]}
@@ -791,7 +776,6 @@
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.get_fine_tune_events Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.get_fine_tune_events`: Supported Method Parameters\n\nresponse = PWN::AI::OpenAI.get_fine_tune_events(\n\nfine_tune_id: 'required - respective :id value returned from #list_fine_tunes',\ntimeout: 'optional - timeout in seconds (defaults to 900)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.get_fine_tune_status Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.get_fine_tune_status`: Supported Method Parameters\n\nresponse = PWN::AI::OpenAI.get_fine_tune_status(\n\nfine_tune_id: 'required - respective :id value returned from #list_fine_tunes',\ntimeout: 'optional - timeout in seconds (defaults to 900)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.get_models Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.get_models`: Supported Method Parameters\n\nmodels = PWN::AI::OpenAI.get_models\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::OpenAI.get_plan_usage Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.get_plan_usage`: Supported Method Parameters\n\nusage = PWN::AI::OpenAI.get_plan_usage(\n\ntimeout: 'optional - seconds (default 8)'\n\n)\n\nSubscription / billing usage for the PS1 percent suffix. Tries (1) dashboard billing hard-limit vs month-to-date spend, then (2) Admin organization costs. Returns {available:false} when neither yields used+limit (never prompts for credentials).\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.help Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.img_gen Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.img_gen`: Supported Method Parameters\n\nresponse = PWN::AI::OpenAI.img_gen(\n\nrequest: 'required - message to ChatGPT',\nn: 'optional - number of images to generate (defaults to 1)',\nsize: 'optional - size of image (defaults to \"1024x1024\")',\ntimeout: 'optional - timeout in seconds (defaults to 900)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.jwt_exp Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.jwt_exp`: "}]}
@@ -800,9 +784,7 @@
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.oauth_token_expiring? Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.oauth_token_expiring?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.obtain_oauth_bearer_token Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.obtain_oauth_bearer_token`: Supported Method Parameters\n\nbearer = PWN::AI::OpenAI.obtain_oauth_bearer_token(\n\nclient_id: 'optional - Codex public client id',\nissuer:    'optional - defaults to https://auth.openai.com',\ntimeout:   'optional - seconds to wait for user consent (default 900)'\n\n)\n\nRuns the Codex device-code login:\n\n1. POST /api/accounts/deviceauth/usercode  -> device_auth_id, user_code\n2. User opens https://auth.openai.com/codex/device and enters code\n3. Poll POST /api/accounts/deviceauth/token until authorization_code + pkce\n4. POST /oauth/token authorization_code grant -> access/refresh/id tokens\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.open_ai_rest_call Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.open_ai_rest_call`: Supported Method Parameters\n\nopen_ai_rest_call(\n\nhttp_method: 'optional HTTP method (defaults to GET)\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::OpenAI.parse_plan_usage_json Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.parse_plan_usage_json`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.persist_oauth_to_vault Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.persist_oauth_to_vault`: "}]}
-{"messages":[{"role":"user","content":"PWN::AI::OpenAI.plan_usage_credentials? Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.plan_usage_credentials?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.real_config_value? Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.real_config_value?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.reasoning_model? Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.reasoning_model?`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenAI.refresh_oauth_bearer_token Usage"},{"role":"assistant","content":"`PWN::AI::OpenAI.refresh_oauth_bearer_token`: Supported Method Parameters\n\naccess_token = PWN::AI::OpenAI.refresh_oauth_bearer_token(\n\nrefresh_token: 'required - OpenAI/ChatGPT OAuth refresh_token',\nclient_id:     'optional - defaults to Codex public client',\ntoken_uri:     'optional - defaults to https://auth.openai.com/oauth/token'\n\n)\n\nCodex posts JSON (not form-urlencoded) to the refresh endpoint. 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[:openai] 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"}]}
@@ -817,7 +799,6 @@
 {"messages":[{"role":"user","content":"PWN::AI::OpenWebUI.chat Usage"},{"role":"assistant","content":"`PWN::AI::OpenWebUI.chat`: Supported Method Parameters\n\nresponse = PWN::AI::OpenWebUI.chat(\n\nrequest: 'required - message to Open WebUI'\nmodel: 'optional - model to use for text generation (defaults to PWN::Env[:ai][:openwebui][:model])',\ntemp: 'optional - creative response float (deafults to PWN::Env[:ai][:openwebui][:temp])',\nsystem_role_content: 'optional - context to set up the model behavior for conversation (Default: PWN::Env[:ai][:openwebui][: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::OpenWebUI.chat_with_tools Usage"},{"role":"assistant","content":"`PWN::AI::OpenWebUI.chat_with_tools`: Supported Method Parameters\n\nresponse = PWN::AI::OpenWebUI.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\" | {type:\"function\", function:{name:..}}',\nmodel: 'optional - overrides PWN::Env[:ai][:openwebui][:model]',\ntemp: 'optional - temperature (defaults to PWN::Env[:ai][:openwebui][:temp] || 1)',\ntimeout: 'optional - seconds (default 900)',\nspinner: 'optional - display spinner (default false)'\n\n)\n\nHits Open WebUI’s PROXIED Ollama POST /ollama/api/chat so options.num_ctx / num_predict / keep_alive take effect. Streaming is ON; openwebui_rest_call assembles NDJSON chunks back into a single response. Bare POST /api/chat is not an API route on stock Open WebUI (405).\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenWebUI.get_models Usage"},{"role":"assistant","content":"`PWN::AI::OpenWebUI.get_models`: Supported Method Parameters\n\nresponse = PWN::AI::OpenWebUI.get_models\n"}]}
-{"messages":[{"role":"user","content":"PWN::AI::OpenWebUI.get_plan_usage Usage"},{"role":"assistant","content":"`PWN::AI::OpenWebUI.get_plan_usage`: Supported Method Parameters\n\nusage = PWN::AI::OpenWebUI.get_plan_usage\n\nOpen WebUI is a local gateway with no subscription / plan-usage endpoint. Always unavailable so the PS1 shows the infinity glyph.\n"}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenWebUI.help Usage"},{"role":"assistant","content":"`PWN::AI::OpenWebUI.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenWebUI.normalize_messages_for_ollama Usage"},{"role":"assistant","content":"`PWN::AI::OpenWebUI.normalize_messages_for_ollama`: "}]}
 {"messages":[{"role":"user","content":"PWN::AI::OpenWebUI.openwebui_rest_call Usage"},{"role":"assistant","content":"`PWN::AI::OpenWebUI.openwebui_rest_call`: Supported Method Parameters\n\nopenwebui_rest_call(\n\nhttp_method: 'optional HTTP method (defaults to GET)',\nrest_call: 'required rest call path relative to base_uri',\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"}]}
@@ -1326,9 +1307,12 @@
 {"messages":[{"role":"user","content":"PWN::Config.authors Usage"},{"role":"assistant","content":"`PWN::Config.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.deep_fill! Usage"},{"role":"assistant","content":"`PWN::Config.deep_fill!`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.default_env Usage"},{"role":"assistant","content":"`PWN::Config.default_env`: Supported Method Parameters\n\nenv = PWN::Config.default_env(\n\npwn_env_path: 'optional - Path to pwn.yaml file.  Defaults to ~/.pwn/pwn.yaml'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::Config.default_skill_names Usage"},{"role":"assistant","content":"`PWN::Config.default_skill_names`: "}]}
+{"messages":[{"role":"user","content":"PWN::Config.default_skills_dir Usage"},{"role":"assistant","content":"`PWN::Config.default_skills_dir`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.env_template Usage"},{"role":"assistant","content":"`PWN::Config.env_template`: Supported Method Parameters\n\ntmpl = PWN::Config.env_template\n\nThe canonical current-release ~/.pwn/pwn.yaml shape as a pure Hash (no I/O, no vault write, no puts).  Single source of truth used by:\n\n* PWN::Config.default_env      — seed a fresh ~/.pwn/pwn.yaml\n* PWN::Migrate.vault_drift     — diff a user vault against this release\n* PWN::Migrate.backfill_vault  — deep-merge missing keys UNDER the\n  user values on `pwn setup --migrate --fix`\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.help Usage"},{"role":"assistant","content":"`PWN::Config.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.init_driver_options Usage"},{"role":"assistant","content":"`PWN::Config.init_driver_options`: Supported Method Parameters\n\nenv = PWN::Config.init_driver_options\n"}]}
+{"messages":[{"role":"user","content":"PWN::Config.install_default_skills Usage"},{"role":"assistant","content":"`PWN::Config.install_default_skills`: "}]}
 {"messages":[{"role":"user","content":"PWN::Config.load_memory Usage"},{"role":"assistant","content":"`PWN::Config.load_memory`: Supported Method Parameters\n\nPWN::Config.load_memory\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.load_skills Usage"},{"role":"assistant","content":"`PWN::Config.load_skills`: Supported Method Parameters\n\nskills = PWN::Config.load_skills(\n\npwn_skills_path: 'optional - Path to skills folder.  Defaults to ~/.pwn/skills'\n\n)\n\nLoads skills into the PWN::Skills constant. Two on-disk shapes are accepted so upgrades are seamless:\n\nagentskills.io  →  <root>/<name>/SKILL.md      (preferred; written by write_skill)\nlegacy flat     →  <root>/<name>.{md,txt,rb,skill,yml,yaml}\n\nEach entry: { type:, format:, path:, dir:, content:, description:,\n\nreferences:, frontmatter:, loaded:?, error:? }\n"}]}
 {"messages":[{"role":"user","content":"PWN::Config.merge_ai_defaults! Usage"},{"role":"assistant","content":"`PWN::Config.merge_ai_defaults!`: "}]}
@@ -1897,7 +1881,28 @@
 {"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.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.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.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_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`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.start_trace! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.start_trace!`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.stop_debug Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.stop_debug`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.stop_trace! Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.stop_trace!`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.trace_arguments Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.trace_arguments`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.trace_module_name Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.trace_module_name`: "}]}
+{"messages":[{"role":"user","content":"PWN::Plugins::Log.traceable? Usage"},{"role":"assistant","content":"`PWN::Plugins::Log.traceable?`: "}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::MSR206.authors Usage"},{"role":"assistant","content":"`PWN::Plugins::MSR206.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::MSR206.backup_card Usage"},{"role":"assistant","content":"`PWN::Plugins::MSR206.backup_card`: Supported Method Parameters\n\nPWN::Plugins::MSR206.backup_card(\n\nmsr206_obj: 'required - msr206_obj returned from #connect method'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::Plugins::MSR206.binary Usage"},{"role":"assistant","content":"`PWN::Plugins::MSR206.binary`: Supported Method Parameters\n\nparsed_cmd_resp_arr = binary(\n\nraw_byte_arr: 'required - raw_byte_arr produced in #parse_responses'\n\n)\n"}]}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.684
+  version: 0.5.686
 platform: ruby
 authors:
 - 0day Inc.
@@ -1441,7 +1441,6 @@ files:
 - documentation/Mistakes.md
 - documentation/NmapIt.md
 - documentation/PWN.png
-- documentation/PWN_Contributors_and_Users.png
 - documentation/Persistence.md
 - documentation/Plugins.md
 - documentation/Reinforcement-Learning.md
@@ -1527,6 +1526,17 @@ files:
 - documentation/pwn_wallpaper.jpg
 - documentation/ringing-spectrogram.png
 - documentation/ringing-waveform.png
+- etc/default_skills/bug-bounty-hunting/SKILL.md
+- etc/default_skills/deep-exploitation/SKILL.md
+- etc/default_skills/hardware-and-firmware-testing/SKILL.md
+- etc/default_skills/osint/SKILL.md
+- etc/default_skills/penetration-testing/SKILL.md
+- etc/default_skills/red-teaming/SKILL.md
+- etc/default_skills/reverse-engineering-binaries/SKILL.md
+- etc/default_skills/sast-code-scans/SKILL.md
+- etc/default_skills/social-engineering/SKILL.md
+- etc/default_skills/vulnerability-research-fundamentals/SKILL.md
+- etc/default_skills/web-application-penetration-testing/SKILL.md
 - etc/osint/social_sites.json
 - etc/systemd/msfrpcd.service
 - etc/systemd/openvas.service