feat: Factory Droid Support and Enhanced Activity Monitoring

- Added Factory Droid client detection and tool translation layer.
- Added Connection Activity Monitoring documentation and CLI tool.
- Implemented Droid-specific tool mapping (Read->read_file, LS->list_dir, etc.).
- Added 'inspect_activity.py' for real-time connection visualization.
- Updated documentation with activity monitoring guide.

Author: Mateusz

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## [2025-12-05]
 
+### Added: Factory Droid Support and Enhanced Activity Monitoring
+
+- **Factory Droid Support**: Seamless integration for Factory Droid clients
+  - **Client Detection**: Automatic detection via User-Agent, system prompts, and tool signatures
+  - **Tool Translation**: Intelligent translation of Droid's PascalCase tools to Codex-compatible formats
+  - **Session Adaptation**: Droid-specific session handling and tool response formatting
+  - **Proxy-Side Tools**: Support for client-specific tools like TodoWrite and WebSearch
+
+- **Connection Activity Monitoring**: Real-time visibility into proxy traffic
+  - **CLI Tool**: New `inspect_activity.py` script for live monitoring of active connections
+  - **Documentation**: Comprehensive guide at `docs/user_guide/features/activity-monitoring.md`
+  - **Performance**: Optimized lock-free tracking with minimal overhead
+  - **Visualizations**: Rich terminal UI for monitoring connection states, RX/TX rates, and session details
+
 ### Added: Health Checks and Advanced Routing
 
 - **Backend Health Monitoring**: Comprehensive system for detecting and managing unhealthy backends

config/config.example.yaml

@@ -9,6 +9,11 @@ public_url: null
 proxy_timeout: 120
 command_prefix: "!/"
 
+# Activity tracking (disabled by default for performance)
+# Enable via CLI: --enable-activity-tracking
+# Enable via env: ENABLE_ACTIVITY_TRACKING=1
+enable_activity_tracking: false
+
 # Authentication
 auth:
   disable_auth: false  # Set to true to disable API key authentication

config/sample.env

@@ -74,6 +74,11 @@ TEST_EXECUTION_REMINDER_ENABLED=false
 # Set to true to disable health checks globally (enabled by default for better reliability)
 # DISABLE_HEALTH_CHECKS=false 
 
+# Activity Tracking Settings
+# Enable real-time connection activity tracking (RX/TX counters per session)
+# Disabled by default for performance - enable for debugging/monitoring
+# ENABLE_ACTIVITY_TRACKING=false
+
 # Anthropic API Keys for Round-Robin Configuration
 # WARNING: Replace these placeholder values with your actual API keys
 ANTHROPIC_API_KEY_1=your_first_anthropic_api_key_here

config/schemas/app_config.schema.yaml

@@ -10,6 +10,8 @@ properties:
   command_prefix: { type: string }
   strict_command_detection: { type: boolean }
   context_window_override: { type: ["integer", "null"], minimum: 1 }
+  disable_health_checks: { type: boolean }
+  enable_activity_tracking: { type: boolean }
   default_rate_limit: { type: integer, minimum: 0 }
   default_rate_window: { type: integer, minimum: 0 }
   model_defaults: { type: object, additionalProperties: true }
@@ -66,11 +68,11 @@ properties:
       enabled: { type: boolean }
       session_lifetime_hours: { type: integer, minimum: 1 }
       database_path: { type: string }
-      providers:
-        type: object
-        additionalProperties:
-          type: object
-          additionalProperties: false
+      providers:
+        type: object
+        additionalProperties:
+          type: object
+          additionalProperties: false
           properties:
             type: { type: string, enum: [oauth2, saml] }
             client_id: { type: string }
@@ -83,31 +85,31 @@ properties:
             scopes:
               type: array
               items: { type: string }
-      authorization:
-        type: object
-        additionalProperties: false
-        properties:
-          mode: { type: string, enum: [single_user, enterprise] }
-          api_url: { type: ["string", "null"] }
-          api_timeout: { type: integer, minimum: 1 }
-          confirmation_code_expiry_minutes: { type: integer, minimum: 1 }
-          max_confirmation_attempts: { type: integer, minimum: 1 }
-      captcha:
-        type: ["object", "null"]
-        additionalProperties: false
-        properties:
-          enabled: { type: boolean }
-          provider: { type: string, enum: [cloudflare_turnstile] }
-          site_key: { type: ["string", "null"] }
-          secret_key: { type: ["string", "null"] }
-          verify_url: { type: ["string", "null"] }
-          widget_mode: { type: string, enum: [invisible, managed] }
-          timeout_seconds: { type: number, minimum: 0 }
-  session:
-    type: object
-    additionalProperties: false
-    properties:
-      cleanup_enabled: { type: boolean }
+      authorization:
+        type: object
+        additionalProperties: false
+        properties:
+          mode: { type: string, enum: [single_user, enterprise] }
+          api_url: { type: ["string", "null"] }
+          api_timeout: { type: integer, minimum: 1 }
+          confirmation_code_expiry_minutes: { type: integer, minimum: 1 }
+          max_confirmation_attempts: { type: integer, minimum: 1 }
+      captcha:
+        type: ["object", "null"]
+        additionalProperties: false
+        properties:
+          enabled: { type: boolean }
+          provider: { type: string, enum: [cloudflare_turnstile] }
+          site_key: { type: ["string", "null"] }
+          secret_key: { type: ["string", "null"] }
+          verify_url: { type: ["string", "null"] }
+          widget_mode: { type: string, enum: [invisible, managed] }
+          timeout_seconds: { type: number, minimum: 0 }
+  session:
+    type: object
+    additionalProperties: false
+    properties:
+      cleanup_enabled: { type: boolean }
       cleanup_interval: { type: integer, minimum: 0 }
       max_age: { type: integer, minimum: 0 }
       default_interactive_mode: { type: boolean }

data/cli_flag_snapshot.txt

@@ -45,6 +45,7 @@
 --edit-precision-override-top-p
 --edit-precision-target-top-k
 --edit-precision-temperature
+--enable-activity-tracking
 --enable-anthropic-oauth-backend-debugging-override
 --enable-antigravity-backend-debugging-override
 --enable-brute-force-protection

data/test_suite_state.json

@@ -1,4 +1,4 @@
 {
-  "test_count": 7578,
+  "test_count": 7613,
   "last_updated": "1764197177.513252"
 }

docs/user_guide/cli-parameters.md

@@ -31,7 +31,7 @@ Configuration is resolved in the following order (highest to lowest priority):
 | `--disable-gemini-oauth-fallback` | `DISABLE_GEMINI_OAUTH_FALLBACK=1` | Disable automatic Gemini OAuth fallback to `gemini-2.5-flash`. |
 | `--disable-hybrid-backend` | `DISABLE_HYBRID_BACKEND=1` | Disable the hybrid backend (enabled by default). |
 | `--hybrid-backend-repeat-messages` | `HYBRID_BACKEND_REPEAT_MESSAGES=1` | Repeat reasoning output as an artificial message in the session. |
-| `--reasoning-injection-probability FLOAT` | `REASONING_INJECTION_PROBABILITY` | Probability of using the reasoning model in the hybrid backend (0.0 to 1.0). |
+| `--reasoning-injection-probability FLOAT` (or `--reasoning_injection_probability`) | `REASONING_INJECTION_PROBABILITY` | Probability of using the reasoning model in the hybrid backend (0.0 to 1.0). |
 | `--hybrid-reasoning-model-timeout SECONDS` | `HYBRID_REASONING_MODEL_TIMEOUT` | Timeout for the reasoning model call in hybrid scenarios (default: 60). |
 | `--hybrid-reasoning-force-initial-turns N` | `HYBRID_REASONING_FORCE_INITIAL_TURNS` | Number of turns at start of session to force reasoning model usage (default: 4). |
 | `--model-alias PATTERN=REPLACEMENT` | `MODEL_ALIASES` (JSON string) | Add a model name rewrite rule (regex pattern and replacement). Can be used multiple times. |
@@ -203,6 +203,14 @@ Configuration is resolved in the following order (highest to lowest priority):
 | `--edit-precision-override-top-k` | `EDIT_PRECISION_OVERRIDE_TOP_K` | Enable top_k override. |
 | `--edit-precision-exclude-agents REGEX` | `EDIT_PRECISION_EXCLUDE_AGENTS_REGEX` | Exclude agents matching regex. |
 
+### Activity Tracking
+
+Real-time connection activity tracking for debugging and monitoring. Disabled by default for performance.
+
+| CLI Argument | Environment Variable | Config File | Description |
+| :--- | :--- | :--- | :--- |
+| `--enable-activity-tracking` | `ENABLE_ACTIVITY_TRACKING=1` | `enable_activity_tracking: true` | Enable connection activity tracking (RX/TX counters per session). |
+
 ### LLM Assessment
 
 | CLI Argument | Environment Variable | Description |
@@ -317,3 +325,4 @@ See [Random Model Replacement Feature Guide](features/random-model-replacement.m
 | `--enable-gemini-oauth-free-backend-debugging-override` | Enable Gemini OAuth Free debugging. |
 | `--enable-gemini-oauth-plan-backend-debugging-override` | Enable Gemini OAuth Plan debugging. |
 | `--enable-qwen-oauth-backend-debugging-override` | Enable Qwen OAuth debugging. |
+| `--enable-droid-antigravity-path-fix` | Enable automatic path fixing for Droid agent with Gemini Antigravity backend. |