Class: Aidp::Providers::Codex

Inherits:
Base
  • Object
show all
Includes:
DebugMixin
Defined in:
lib/aidp/providers/codex.rb

Constant Summary

Constants included from DebugMixin

DebugMixin::DEBUG_BASIC, DebugMixin::DEBUG_OFF, DebugMixin::DEBUG_VERBOSE

Constants inherited from Base

Base::ACTIVITY_STATES, Base::DEFAULT_STUCK_TIMEOUT, Base::TIMEOUT_ARCHITECTURE_ANALYSIS, Base::TIMEOUT_DEFAULT, Base::TIMEOUT_DOCUMENTATION_ANALYSIS, Base::TIMEOUT_FUNCTIONALITY_ANALYSIS, Base::TIMEOUT_IMPLEMENTATION, Base::TIMEOUT_QUICK_MODE, Base::TIMEOUT_REFACTORING_RECOMMENDATIONS, Base::TIMEOUT_REPOSITORY_ANALYSIS, Base::TIMEOUT_STATIC_ANALYSIS, Base::TIMEOUT_TEST_ANALYSIS

Constants included from MessageDisplay

MessageDisplay::COLOR_MAP

Instance Attribute Summary

Attributes inherited from Base

#activity_state, #last_activity_time, #start_time, #step_name, #stuck_timeout

Class Method Summary collapse

Instance Method Summary collapse

Methods included from DebugMixin

#debug_basic?, #debug_command, #debug_enabled?, #debug_error, #debug_execute_command, #debug_level, #debug_log, #debug_logger, #debug_provider, #debug_step, #debug_timing, #debug_verbose?, included, shared_logger

Methods inherited from Base

#activity_summary, #execution_time, #fetch_mcp_servers, #harness_config, #harness_health_status, #harness_metrics, #harness_mode?, #initialize, #mark_completed, #mark_failed, #record_activity, #record_harness_request, #send_with_harness, #set_harness_context, #set_job_context, #setup_activity_monitoring, #stuck?, #supports_activity_monitoring?, #supports_mcp?, #time_since_last_activity, #update_activity_state

Methods included from Adapter

#capabilities, #classify_error, #dangerous_mode=, #dangerous_mode_enabled?, #dangerous_mode_flags, #error_metadata, #error_patterns, #fetch_mcp_servers, #health_status, #logging_metadata, #redact_secrets, #retryable_error?, #supports_dangerous_mode?, #supports_mcp?, #validate_config

Methods included from MessageDisplay

#display_message, #in_test_environment?, included, #message_display_prompt, #suppress_display_message?

Constructor Details

This class inherits a constructor from Aidp::Providers::Base

Class Method Details

.available? ⇒ Boolean

Returns:

  • (Boolean) 


13
14
15
 
# File 'lib/aidp/providers/codex.rb', line 13

def self.available?
  !!Aidp::Util.which("codex")
end

Instance Method Details

#available? ⇒ Boolean

Returns:

  • (Boolean) 


25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/aidp/providers/codex.rb', line 25

def available?
  return false unless self.class.available?

  # Additional check to ensure the CLI is properly configured
  begin
    result = Aidp::Util.execute_command("codex", ["--version"], timeout: 10)
    result.exit_status == 0
  rescue
    false
  end
end

#display_name ⇒ Object 



21
22
23
 
# File 'lib/aidp/providers/codex.rb', line 21

def display_name
  "Codex CLI"
end

#harness_healthy? ⇒ Boolean

Override health check for Codex specific considerations

Returns:

  • (Boolean) 


147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'lib/aidp/providers/codex.rb', line 147

def harness_healthy?
  return false unless super

  # Additional health checks specific to Codex CLI
  # Check if we can access the CLI (basic connectivity test)
  begin
    result = Aidp::Util.execute_command("codex", ["--help"], timeout: 5)
    result.exit_status == 0
  rescue
    false
  end
end

#name ⇒ Object 



17
18
19
 
# File 'lib/aidp/providers/codex.rb', line 17

def name
  "codex"
end

#send_message(prompt:, session: nil) ⇒ Object 



37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
 
# File 'lib/aidp/providers/codex.rb', line 37

def send_message(prompt:, session: nil)
  raise "codex CLI not available" unless self.class.available?

  # Smart timeout calculation
  timeout_seconds = calculate_timeout

  debug_provider("codex", "Starting execution", {timeout: timeout_seconds})
  debug_log("📝 Sending prompt to codex (length: #{prompt.length})", level: :info)

  # Check if streaming mode is enabled
  streaming_enabled = ENV["AIDP_STREAMING"] == "1" || ENV["DEBUG"] == "1"
  if streaming_enabled
    display_message("📺 Streaming mode enabled - output will appear in real-time", type: :info)
  end

  # Set up activity monitoring
  setup_activity_monitoring("codex", method(:activity_callback))
  record_activity("Starting codex execution")

  # Create a spinner for activity display
   = TTY::Spinner.new("[:spinner] :title", format: :dots, hide_cursor: true)
  .auto_spin

  activity_display_thread = Thread.new do
    start_time = Time.now
    loop do
      sleep 0.5 # Update every 500ms to reduce spam
      elapsed = Time.now - start_time

      # Break if we've been running too long or state changed
      break if elapsed > timeout_seconds || @activity_state == :completed || @activity_state == :failed

      (, elapsed, "🤖 Codex CLI")
    end
  end

  begin
    # Use non-interactive mode (exec) for automation
    args = ["exec", prompt]

    # Add session support if provided (codex may support session/thread continuation)
    if session && !session.empty?
      args += ["--session", session]
    end

    # In devcontainer, ensure sandbox mode and approval policy are set
    # These are already set via environment variables in devcontainer.json
    # but we verify and log them here for visibility
    if in_devcontainer_or_codespace?
      unless ENV["CODEX_SANDBOX_MODE"] == "danger-full-access"
        ENV["CODEX_SANDBOX_MODE"] = "danger-full-access"
        debug_log("🔓 Set CODEX_SANDBOX_MODE=danger-full-access for devcontainer", level: :info)
      end
      unless ENV["CODEX_APPROVAL_POLICY"] == "never"
        ENV["CODEX_APPROVAL_POLICY"] = "never"
        debug_log("🔓 Set CODEX_APPROVAL_POLICY=never for devcontainer", level: :info)
      end
    end

    # Use debug_execute_command for better debugging
    result = debug_execute_command("codex", args: args, timeout: timeout_seconds, streaming: streaming_enabled)

    # Log the results
    debug_command("codex", args: args, input: prompt, output: result.out, error: result.err, exit_code: result.exit_status)

    if result.exit_status == 0
      .success("✓")
      mark_completed
      result.out
    else
      .error("✗")
      mark_failed("codex failed with exit code #{result.exit_status}")
      debug_error(StandardError.new("codex failed"), {exit_code: result.exit_status, stderr: result.err})
      raise "codex failed with exit code #{result.exit_status}: #{result.err}"
    end
  rescue => e
    &.error("✗")
    mark_failed("codex execution failed: #{e.message}")
    debug_error(e, {provider: "codex", prompt_length: prompt.length})
    raise
  ensure
    cleanup_activity_display(activity_display_thread, )
  end
end

#send_with_options(prompt:, session: nil, model: nil, ask_for_approval: false) ⇒ Object

Enhanced send method with additional options



123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
 
# File 'lib/aidp/providers/codex.rb', line 123

def send_with_options(prompt:, session: nil, model: nil, ask_for_approval: false)
  args = ["exec", prompt]

  # Add session support
  if session && !session.empty?
    args += ["--session", session]
  end

  # Add model selection
  if model
    args += ["--model", model]
  end

  # Add approval flag - but warn about interactive behavior
  if ask_for_approval
    debug_log("⚠️  WARNING: --ask-for-approval flag may cause interactive prompts that could hang AIDP", level: :warn)
    args += ["--ask-for-approval"]
  end

  # Use the enhanced version of send
  send_with_custom_args(prompt: prompt, args: args)
end