Skip to content

The agent that turns websites into APIs!

feat: js / ts client generation

kalil032147c2064cd6cf
diff --git a/src/reverse_api/auto_engineer.py b/src/reverse_api/auto_engineer.py
index 67663e5..c12c39b 100644
--- a/src/reverse_api/auto_engineer.py
+++ b/src/reverse_api/auto_engineer.py
@@ -5,7 +5,7 @@ Combines browser automation via MCP with simultaneous API reverse engineering.
import asyncio
import logging
-from typing import Any, Dict
+from typing import Any
import httpx
from claude_agent_sdk import (
@@ -24,9 +24,7 @@ from .utils import get_har_dir
# Suppress claude_agent_sdk logs
logging.getLogger("claude_agent_sdk").setLevel(logging.WARNING)
-logging.getLogger("claude_agent_sdk._internal.transport.subprocess_cli").setLevel(
- logging.WARNING
-)
+logging.getLogger("claude_agent_sdk._internal.transport.subprocess_cli").setLevel(logging.WARNING)
class ClaudeAutoEngineer(ClaudeEngineer):
@@ -58,8 +56,99 @@ class ClaudeAutoEngineer(ClaudeEngineer):
def _build_auto_prompt(self) -> str:
"""Build autonomous browsing + engineering prompt."""
+ language_name = {
+ "python": "Python",
+ "javascript": "JavaScript",
+ "typescript": "TypeScript",
+ }.get(self.output_language, "Python")
+
+ client_filename = self._get_client_filename()
+ run_command = self._get_run_command()
+
+ # Build language-specific generation instructions
+ if self.output_language == "javascript":
+ generation_instructions = f"""2. **Generate JavaScript API client** at `{self.scripts_dir}/{client_filename}`:
+ - Use modern JavaScript (ES2022+) with ESM modules (import/export)
+ - Use native `fetch` API for HTTP requests (Node.js 18+ built-in)
+ - If advanced features needed (retries, interceptors), use `axios`
+ - Include proper authentication handling
+ - Create separate async functions for each API endpoint
+ - Add JSDoc comments for type documentation
+ - Include example usage in main section
+ - Make it production-ready and maintainable
+ - If using external dependencies, generate package.json
+
+3. **Create documentation** at `{self.scripts_dir}/README.md`:
+ - Explain what APIs were discovered
+ - How authentication works
+ - How to use each function
+ - Requirements: Node.js 18+
+ - Any limitations or requirements
+
+4. **Test your implementation**:
+ - If package.json was generated, first run: npm install
+ - Run with: {run_command}
+ - You have up to 5 attempts to fix any issues
+ - If initial implementation fails, analyze errors and iterate"""
+ output_files = f"""1. `{self.scripts_dir}/{client_filename}` - Production JavaScript API client
+2. `{self.scripts_dir}/README.md` - Documentation with usage examples
+3. `{self.scripts_dir}/package.json` - Only if external dependencies are needed"""
+
+ elif self.output_language == "typescript":
+ generation_instructions = f"""2. **Generate TypeScript API client** at `{self.scripts_dir}/{client_filename}`:
+ - Use TypeScript with strict typing enabled
+ - Use ESM modules (import/export syntax)
+ - Use native `fetch` API for HTTP requests (Node.js 18+ built-in)
+ - If advanced features needed, use `axios`
+ - Define TypeScript interfaces for all request/response types
+ - Include proper authentication handling
+ - Create separate async functions for each API endpoint
+ - Export a class-based API client with proper encapsulation
+ - Include example usage in main section
+ - Make it production-ready and maintainable
+ - Generate package.json with tsx, typescript, @types/node
+
+3. **Create documentation** at `{self.scripts_dir}/README.md`:
+ - Explain what APIs were discovered
+ - How authentication works
+ - How to use each function
+ - Requirements: Node.js 18+
+ - Any limitations or requirements
+
+4. **Test your implementation**:
+ - Run: npm install && {run_command}
+ - You have up to 5 attempts to fix any issues
+ - If initial implementation fails, analyze errors and iterate"""
+ output_files = f"""1. `{self.scripts_dir}/{client_filename}` - Production TypeScript API client
+2. `{self.scripts_dir}/README.md` - Documentation with usage examples
+3. `{self.scripts_dir}/package.json` - Dependencies and run scripts"""
+
+ else: # python
+ generation_instructions = f"""2. **Generate Python API client** at `{self.scripts_dir}/{client_filename}`:
+ - Use `requests` library as default (or Playwright if needed for bot detection)
+ - Include proper authentication handling
+ - Create separate functions for each API endpoint
+ - Add type hints, docstrings, error handling
+ - Include example usage in main section
+ - Make it production-ready and maintainable
+
+3. **Create documentation** at `{self.scripts_dir}/README.md`:
+ - Explain what APIs were discovered
+ - How authentication works
+ - How to use each function
+ - Example usage
+ - Any limitations or requirements
+
+4. **Test your implementation**:
+ - After generating the code, test it to ensure it works
+ - Run with: {run_command}
+ - You have up to 5 attempts to fix any issues
+ - If initial implementation fails, analyze errors and iterate"""
+ output_files = f"""1. `{self.scripts_dir}/{client_filename}` - Production Python API client
+2. `{self.scripts_dir}/README.md` - Documentation with usage examples"""
+
return f"""You are an autonomous AI agent with browser control via MCP tools.
- Your mission is to browse, monitor network traffic, and generate production-ready Python API code.
+ Your mission is to browse, monitor network traffic, and generate production-ready {language_name} API code.
<mission>
{self.prompt}
@@ -109,31 +198,13 @@ When you have sufficient data or have accomplished the mission goal, call `brows
- Returns: {{"har_path": str, "resources": {{...}}}}
### Phase 4: REVERSE ENGINEER
-Based on the network traffic you observed, generate production-ready Python code:
+Based on the network traffic you observed, generate production-ready {language_name} code:
1. **Analyze the HAR file** you just captured at {self.har_path}
- Read and parse the HAR file
- Extract all API calls, authentication, patterns
-2. **Generate Python API client** at `{self.scripts_dir}/api_client.py`:
- - Use `requests` library as default (or Playwright if needed for bot detection)
- - Include proper authentication handling
- - Create separate functions for each API endpoint
- - Add type hints, docstrings, error handling
- - Include example usage in main section
- - Make it production-ready and maintainable
-
-3. **Create documentation** at `{self.scripts_dir}/README.md`:
- - Explain what APIs were discovered
- - How authentication works
- - How to use each function
- - Example usage
- - Any limitations or requirements
-
-4. **Test your implementation**:
- - After generating the code, test it to ensure it works
- - You have up to 5 attempts to fix any issues
- - If initial implementation fails, analyze errors and iterate
+{generation_instructions}
## IMPORTANT NOTES
@@ -146,8 +217,7 @@ Based on the network traffic you observed, generate production-ready Python code
## OUTPUT FILES REQUIRED
-1. `{self.scripts_dir}/api_client.py` - Production Python API client
-2. `{self.scripts_dir}/README.md` - Documentation with usage examples
+{output_files}
Your final response should confirm the files were created and provide a brief summary of:
- What APIs were discovered
@@ -156,7 +226,7 @@ Your final response should confirm the files were created and provide a brief su
- Any limitations or caveats
"""
- async def analyze_and_generate(self) -> Dict[str, Any] | None:
+ async def analyze_and_generate(self) -> dict[str, Any] | None:
"""Run auto mode with MCP browser integration."""
self.ui.header(self.run_id, self.prompt, self.model)
self.ui.start_analysis()
@@ -196,9 +266,7 @@ Your final response should confirm the files were created and provide a brief su
# Process response and show progress with TUI
async for message in client.receive_response():
# Check for usage metadata
- if hasattr(message, "usage") and isinstance(
- message.usage, dict
- ):
+ if hasattr(message, "usage") and isinstance(message.usage, dict):
self.usage_metadata.update(message.usage)
if isinstance(message, AssistantMessage):
@@ -207,9 +275,7 @@ Your final response should confirm the files were created and provide a brief su
if isinstance(block, ToolUseBlock):
last_tool_name = block.name
self.ui.tool_start(block.name, block.input)
- self.message_store.save_tool_start(
- block.name, block.input
- )
+ self.message_store.save_tool_start(block.name, block.input)
elif isinstance(block, ToolResultBlock):
is_error = block.is_error if block.is_error else False
@@ -224,9 +290,7 @@ Your final response should confirm the files were created and provide a brief su
tool_name = last_tool_name or "Tool"
self.ui.tool_result(tool_name, is_error, output)
- self.message_store.save_tool_result(
- tool_name, is_error, str(output) if output else None
- )
+ self.message_store.save_tool_result(tool_name, is_error, str(output) if output else None)
elif isinstance(block, TextBlock):
self.ui.thinking(block.text)
self.message_store.save_thinking(block.text)
@@ -234,33 +298,19 @@ Your final response should confirm the files were created and provide a brief su
elif isinstance(message, ResultMessage):
if message.is_error:
self.ui.error(message.result or "Unknown error")
- self.message_store.save_error(
- message.result or "Unknown error"
- )
+ self.message_store.save_error(message.result or "Unknown error")
return None
else:
- script_path = str(self.scripts_dir / "api_client.py")
- local_path = (
- str(self.local_scripts_dir / "api_client.py")
- if self.local_scripts_dir
- else None
- )
+ script_path = str(self.scripts_dir / self._get_client_filename())
+ local_path = str(self.local_scripts_dir / self._get_client_filename()) if self.local_scripts_dir else None
self.ui.success(script_path, local_path)
# Calculate estimated cost if we have usage data
if self.usage_metadata:
- input_tokens = self.usage_metadata.get(
- "input_tokens", 0
- )
- output_tokens = self.usage_metadata.get(
- "output_tokens", 0
- )
- cache_creation_tokens = self.usage_metadata.get(
- "cache_creation_input_tokens", 0
- )
- cache_read_tokens = self.usage_metadata.get(
- "cache_read_input_tokens", 0
- )
+ input_tokens = self.usage_metadata.get("input_tokens", 0)
+ output_tokens = self.usage_metadata.get("output_tokens", 0)
+ cache_creation_tokens = self.usage_metadata.get("cache_creation_input_tokens", 0)
+ cache_read_tokens = self.usage_metadata.get("cache_read_input_tokens", 0)
# Calculate cost using shared pricing module
from .pricing import calculate_cost
@@ -277,26 +327,16 @@ Your final response should confirm the files were created and provide a brief su
# Display usage breakdown
self.ui.console.print(f" [dim]Usage:[/dim]") # noqa: F541
if input_tokens > 0:
- self.ui.console.print(
- f" [dim] input: {input_tokens:,} tokens[/dim]"
- )
+ self.ui.console.print(f" [dim] input: {input_tokens:,} tokens[/dim]")
if cache_creation_tokens > 0:
- self.ui.console.print(
- f" [dim] cache creation: {cache_creation_tokens:,} tokens[/dim]"
- )
+ self.ui.console.print(f" [dim] cache creation: {cache_creation_tokens:,} tokens[/dim]")
if cache_read_tokens > 0:
- self.ui.console.print(
- f" [dim] cache read: {cache_read_tokens:,} tokens[/dim]"
- )
+ self.ui.console.print(f" [dim] cache read: {cache_read_tokens:,} tokens[/dim]")
if output_tokens > 0:
- self.ui.console.print(
- f" [dim] output: {output_tokens:,} tokens[/dim]"
- )
- self.ui.console.print(
- f" [dim] total cost: ${cost:.4f}[/dim]"
- )
+ self.ui.console.print(f" [dim] output: {output_tokens:,} tokens[/dim]")
+ self.ui.console.print(f" [dim] total cost: ${cost:.4f}[/dim]")
- result: Dict[str, Any] = {
+ result: dict[str, Any] = {
"script_path": script_path,
"usage": self.usage_metadata,
}
@@ -309,31 +349,17 @@ Your final response should confirm the files were created and provide a brief su
self.message_store.save_error(error_msg)
# Handle screenshot buffer size errors specifically
- if (
- "buffer size" in error_msg.lower()
- or "1048576" in error_msg
- or "exceeded maximum buffer" in error_msg.lower()
- ):
- self.ui.console.print(
- "\n[yellow]⚠ Screenshot too large (exceeds 1MB limit)[/yellow]"
- )
- self.ui.console.print(
- "[dim]Tip: The AI should take element-specific screenshots instead of full-page screenshots.[/dim]"
- )
+ if "buffer size" in error_msg.lower() or "1048576" in error_msg or "exceeded maximum buffer" in error_msg.lower():
+ self.ui.console.print("\n[yellow]⚠ Screenshot too large (exceeds 1MB limit)[/yellow]")
+ self.ui.console.print("[dim]Tip: The AI should take element-specific screenshots instead of full-page screenshots.[/dim]")
self.ui.console.print(
"[dim]Consider using browser_snapshot() for accessibility tree information when screenshots aren't needed.[/dim]"
)
# Provide helpful error messages
elif "MCP server" in error_msg or "npx" in error_msg:
- self.ui.console.print(
- "\n[dim]Make sure rae-playwright-mcp is installed: "
- "npm install -g rae-playwright-mcp[/dim]"
- )
+ self.ui.console.print("\n[dim]Make sure rae-playwright-mcp is installed: npm install -g rae-playwright-mcp[/dim]")
else:
- self.ui.console.print(
- "\n[dim]Make sure Claude Code CLI is installed: "
- "npm install -g @anthropic-ai/claude-code[/dim]"
- )
+ self.ui.console.print("\n[dim]Make sure Claude Code CLI is installed: npm install -g @anthropic-ai/claude-code[/dim]")
return None
return None
@@ -342,9 +368,7 @@ Your final response should confirm the files were created and provide a brief su
class OpenCodeAutoEngineer(OpenCodeEngineer):
"""Auto mode using OpenCode SDK: Register MCP server dynamically."""
- def __init__(
- self, run_id: str, prompt: str, output_dir: str | None = None, **kwargs
- ):
+ def __init__(self, run_id: str, prompt: str, output_dir: str | None = None, **kwargs):
"""Initialize auto engineer with expected HAR path (created by MCP)."""
# Calculate expected HAR path - MCP will create it during execution
har_dir = get_har_dir(run_id, output_dir)
@@ -365,16 +389,14 @@ class OpenCodeAutoEngineer(OpenCodeEngineer):
# Reuse the same prompt from ClaudeAutoEngineer
return ClaudeAutoEngineer._build_auto_prompt(self)
- async def analyze_and_generate(self) -> Dict[str, Any] | None:
+ async def analyze_and_generate(self) -> dict[str, Any] | None:
"""Run auto mode with OpenCode MCP integration."""
self.opencode_ui.header(self.run_id, self.prompt, self.opencode_model)
self.opencode_ui.start_analysis()
self.message_store.save_prompt(self._build_auto_prompt())
try:
- async with httpx.AsyncClient(
- base_url=self.BASE_URL, timeout=600.0
- ) as client:
+ async with httpx.AsyncClient(base_url=self.BASE_URL, timeout=600.0) as client:
try:
health_r = await client.get("/global/health")
health_r.raise_for_status()
@@ -382,9 +404,7 @@ class OpenCodeAutoEngineer(OpenCodeEngineer):
self.opencode_ui.health_check(health)
except Exception as e:
debug_log(f"Health check failed: {e}")
- self.opencode_ui.error(
- f"OpenCode server not responding. Is it running on {self.BASE_URL}?"
- )
+ self.opencode_ui.error(f"OpenCode server not responding. Is it running on {self.BASE_URL}?")
return None
# Create session first
@@ -439,9 +459,7 @@ class OpenCodeAutoEngineer(OpenCodeEngineer):
"parts": [{"type": "text", "text": self._build_auto_prompt()}],
}
- prompt_r = await client.post(
- f"/session/{self._session_id}/message", json=prompt_body
- )
+ prompt_r = await client.post(f"/session/{self._session_id}/message", json=prompt_body)
prompt_r.raise_for_status()
# Wait for events to complete
@@ -470,16 +488,12 @@ class OpenCodeAutoEngineer(OpenCodeEngineer):
return None
# Success
- script_path = str(self.scripts_dir / "api_client.py")
+ script_path = str(self.scripts_dir / self._get_client_filename())
# Fetch actual provider and model used
try:
- async with httpx.AsyncClient(
- base_url=self.BASE_URL, timeout=10.0
- ) as client:
- messages_r = await client.get(
- f"/session/{self._session_id}/message"
- )
+ async with httpx.AsyncClient(base_url=self.BASE_URL, timeout=10.0) as client:
+ messages_r = await client.get(f"/session/{self._session_id}/message")
if messages_r.status_code == 200:
messages = messages_r.json()
for msg in messages:
@@ -495,14 +509,10 @@ class OpenCodeAutoEngineer(OpenCodeEngineer):
# Show session summary
self.opencode_ui.session_summary(self.usage_metadata)
- local_path = (
- str(self.local_scripts_dir / "api_client.py")
- if self.local_scripts_dir
- else None
- )
+ local_path = str(self.local_scripts_dir / self._get_client_filename()) if self.local_scripts_dir else None
self.opencode_ui.success(script_path, local_path)
- result_data: Dict[str, Any] = {
+ result_data: dict[str, Any] = {
"script_path": script_path,
"usage": self.usage_metadata,
"session_id": self._session_id,
@@ -512,9 +522,7 @@ class OpenCodeAutoEngineer(OpenCodeEngineer):
except httpx.ConnectError:
self.opencode_ui.error("Connection error")
- self.opencode_ui.console.print(
- "\n[dim]Make sure OpenCode is running: opencode[/dim]"
- )
+ self.opencode_ui.console.print("\n[dim]Make sure OpenCode is running: opencode[/dim]")
self.message_store.save_error("Connection error")
return None
@@ -524,17 +532,9 @@ class OpenCodeAutoEngineer(OpenCodeEngineer):
self.message_store.save_error(error_msg)
# Handle screenshot buffer size errors specifically
- if (
- "buffer size" in error_msg.lower()
- or "1048576" in error_msg
- or "exceeded maximum buffer" in error_msg.lower()
- ):
- self.opencode_ui.console.print(
- "\n[yellow]⚠ Screenshot too large (exceeds 1MB limit)[/yellow]"
- )
- self.opencode_ui.console.print(
- "[dim]Tip: The AI should take element-specific screenshots instead of full-page screenshots.[/dim]"
- )
+ if "buffer size" in error_msg.lower() or "1048576" in error_msg or "exceeded maximum buffer" in error_msg.lower():
+ self.opencode_ui.console.print("\n[yellow]⚠ Screenshot too large (exceeds 1MB limit)[/yellow]")
+ self.opencode_ui.console.print("[dim]Tip: The AI should take element-specific screenshots instead of full-page screenshots.[/dim]")
self.opencode_ui.console.print(
"[dim]Consider using browser_snapshot() for accessibility tree information when screenshots aren't needed.[/dim]"
)
@@ -545,9 +545,7 @@ class OpenCodeAutoEngineer(OpenCodeEngineer):
# Best effort cleanup - deregister MCP server
if self.mcp_name:
try:
- async with httpx.AsyncClient(
- base_url=self.BASE_URL, timeout=5.0
- ) as client:
+ async with httpx.AsyncClient(base_url=self.BASE_URL, timeout=5.0) as client:
await client.delete(f"/mcp/{self.mcp_name}")
debug_log(f"Cleaned up MCP server: {self.mcp_name}")
except Exception:
diff --git a/src/reverse_api/base_engineer.py b/src/reverse_api/base_engineer.py
index 14bb150..24232b2 100644
--- a/src/reverse_api/base_engineer.py
+++ b/src/reverse_api/base_engineer.py
@@ -25,6 +25,7 @@ class BaseEngineer(ABC):
enable_sync: bool = False,
sdk: str = "claude",
is_fresh: bool = False,
+ output_language: str = "python",
):
self.run_id = run_id
self.har_path = har_path
@@ -38,6 +39,7 @@ class BaseEngineer(ABC):
self.enable_sync = enable_sync
self.sdk = sdk
self.is_fresh = is_fresh
+ self.output_language = output_language
self.sync_watcher: FileSyncWatcher | None = None
self.local_scripts_dir: Path | None = None
@@ -88,10 +90,160 @@ class BaseEngineer(ABC):
return self.sync_watcher.get_status()
return None
+ def _get_output_extension(self) -> str:
+ """Return file extension based on output language."""
+ return {
+ "python": ".py",
+ "javascript": ".js",
+ "typescript": ".ts",
+ }.get(self.output_language, ".py")
+
+ def _get_client_filename(self) -> str:
+ """Return the API client filename."""
+ return f"api_client{self._get_output_extension()}"
+
+ def _get_run_command(self) -> str:
+ """Return the command to run the generated client."""
+ return {
+ "python": "python api_client.py",
+ "javascript": "node api_client.js",
+ "typescript": "npx tsx api_client.ts",
+ }.get(self.output_language, "python api_client.py")
+
+ def _get_language_instructions(self) -> str:
+ """Return language-specific code generation instructions."""
+ client_filename = self._get_client_filename()
+ run_command = self._get_run_command()
+
+ if self.output_language == "javascript":
+ return f"""4. **Generate a JavaScript module** that replicates these API calls with the following requirements:
+ - Use modern JavaScript (ES2022+) with ESM modules (import/export)
+ - Use native `fetch` API for HTTP requests (Node.js 18+ built-in)
+ - If advanced features are needed (retries, interceptors), use `axios` instead
+ - Include proper authentication handling (sessions, headers, tokens)
+ - Create separate async functions for each distinct API endpoint
+ - Use JSDoc comments for type documentation on all functions
+ - Implement proper error handling with try-catch blocks
+ - Create custom Error classes for API errors
+ - Add console logging for debugging purposes
+ - Make the code production-ready and maintainable
+ - Include a main section with example usage (wrapped in async IIFE or top-level await)
+ - If using external dependencies (like axios), generate a package.json with:
+ - "type": "module" for ESM support
+ - Required dependencies
+ - scripts: {{ "start": "node api_client.js" }}
+
+5. **Create documentation**:
+ - Generate a README.md file that explains:
+ - What APIs were discovered
+ - How authentication works
+ - How to use each function
+ - Example usage
+ - Requirements: Node.js 18+
+ - Any limitations or requirements
+
+6. **Test your implementation**:
+ - If package.json was generated, first run: npm install
+ - Run with: {run_command}
+ - You have up to 5 attempts to fix any issues
+ - If the initial implementation fails, analyze the error and try again
+
+After your analysis, generate the files:
+
+1. Save the JavaScript module to: {self.scripts_dir}/{client_filename}
+2. Save the documentation to: {self.scripts_dir}/README.md
+3. If external dependencies are used, save: {self.scripts_dir}/package.json"""
+
+ elif self.output_language == "typescript":
+ return f"""4. **Generate a TypeScript module** that replicates these API calls with the following requirements:
+ - Use TypeScript with strict typing enabled
+ - Use ESM modules (import/export syntax)
+ - Use native `fetch` API for HTTP requests (Node.js 18+ built-in)
+ - If advanced features are needed (retries, interceptors), use `axios` instead
+ - Define TypeScript interfaces for all request/response types
+ - Include proper authentication handling (sessions, headers, tokens)
+ - Create separate async functions for each distinct API endpoint
+ - Use async/await patterns throughout
+ - Export a class-based API client with proper encapsulation
+ - Implement proper error handling with custom error types
+ - Add console logging for debugging purposes
+ - Make the code production-ready and maintainable
+ - Include a main section with example usage
+ - Generate a package.json with:
+ - "type": "module" for ESM support
+ - devDependencies: tsx, typescript, @types/node
+ - dependencies: axios (only if used)
+ - scripts: {{ "start": "npx tsx api_client.ts" }}
+
+5. **Create documentation**:
+ - Generate a README.md file that explains:
+ - What APIs were discovered
+ - How authentication works
+ - How to use each function
+ - Example usage
+ - Requirements: Node.js 18+
+ - Any limitations or requirements
+
+6. **Test your implementation**:
+ - Run: npm install && {run_command}
+ - npx auto-downloads tsx if not installed
+ - You have up to 5 attempts to fix any issues
+ - If the initial implementation fails, analyze the error and try again
+
+After your analysis, generate the files:
+
+1. Save the TypeScript module to: {self.scripts_dir}/{client_filename}
+2. Save the documentation to: {self.scripts_dir}/README.md
+3. Save the package.json to: {self.scripts_dir}/package.json"""
+
+ else: # python (default)
+ return f"""4. **Generate a Python script** that replicates these API calls with the following requirements:
+ - Use the `requests` library as the default choice
+ - Include proper authentication handling (sessions, headers, tokens)
+ - Create separate functions for each distinct API endpoint
+ - Include type hints for all function parameters and return values
+ - Write comprehensive docstrings for each function
+ - Implement proper error handling with try-except blocks
+ - Add logging for debugging purposes
+ - Make the code production-ready and maintainable
+ - Include a main section with example usage
+
+5. **Create documentation**:
+ - Generate a README.md file that explains:
+ - What APIs were discovered
+ - How authentication works
+ - How to use each function
+ - Example usage
+ - Any limitations or requirements
+
+6. **Test your implementation**:
+ - After generating the code, test it to ensure it works
+ - Run with: {run_command}
+ - You have up to 5 attempts to fix any issues
+ - If the initial implementation fails, analyze the error and try again
+ - Keep in mind that some websites have bot detection mechanisms
+
+7. **Handle bot detection**:
+ - If you encounter bot detection, CAPTCHA, or anti-scraping measures with `requests`
+ - Consider switching to Playwright with CDP (Chrome DevTools Protocol)
+ - Use the real user browser context to bypass detection
+ - Maintain the same code quality standards regardless of approach
+
+After your analysis, generate the files:
+
+1. Save the Python script to: {self.scripts_dir}/{client_filename}
+2. Save the documentation to: {self.scripts_dir}/README.md"""
+
def _build_analysis_prompt(self) -> str:
"""Build the prompt for analyzing the HAR file."""
+ language_name = {
+ "python": "Python",
+ "javascript": "JavaScript",
+ "typescript": "TypeScript",
+ }.get(self.output_language, "Python")
+
base_prompt = f"""You are tasked with analyzing a HAR (HTTP Archive) file to reverse engineer API calls,
- and generate production-ready Python code that replicates those calls.
+ and generate production-ready {language_name} code that replicates those calls.
Here is the HAR file path you need to analyze:
<har_path>
@@ -130,36 +282,7 @@ Your task is to:
- Query parameters vs body parameters
- Response data structures
-4. **Generate a Python script** that replicates these API calls with the following requirements:
- - Use the `requests` library as the default choice
- - Include proper authentication handling (sessions, headers, tokens)
- - Create separate functions for each distinct API endpoint
- - Include type hints for all function parameters and return values
- - Write comprehensive docstrings for each function
- - Implement proper error handling with try-except blocks
- - Add logging for debugging purposes
- - Make the code production-ready and maintainable
- - Include a main section with example usage
-
-5. **Create documentation**:
- - Generate a README.md file that explains:
- - What APIs were discovered
- - How authentication works
- - How to use each function
- - Example usage
- - Any limitations or requirements
-
-6. **Test your implementation**:
- - After generating the code, test it to ensure it works
- - You have up to 5 attempts to fix any issues
- - If the initial implementation fails, analyze the error and try again
- - Keep in mind that some websites have bot detection mechanisms
-
-7. **Handle bot detection**:
- - If you encounter bot detection, CAPTCHA, or anti-scraping measures with `requests`
- - Consider switching to Playwright with CDP (Chrome DevTools Protocol)
- - Use the real user browser context to bypass detection
- - Maintain the same code quality standards regardless of approach
+{self._get_language_instructions()}
Before generating your code, use a scratchpad to plan your approach:
@@ -168,16 +291,10 @@ In your scratchpad:
- Summarize the key API endpoints found in the HAR file
- Note the authentication mechanism being used
- Identify any patterns or commonalities between requests
-- Plan the structure of your Python script
+- Plan the structure of your {language_name} code
- Consider potential issues (rate limiting, bot detection, etc.)
-- Decide whether `requests` will be sufficient or if Playwright is needed
</scratchpad>
-After your analysis, generate the files:
-
-1. Save the Python script to: {self.scripts_dir}/api_client.py
-2. Save the documentation to: {self.scripts_dir}/README.md
-
If your first attempt doesn't work, analyze what went wrong and try again. Document each attempt and what you learned.
<attempt_log>
diff --git a/src/reverse_api/browser.py b/src/reverse_api/browser.py
index cf05725..b729c75 100644
--- a/src/reverse_api/browser.py
+++ b/src/reverse_api/browser.py
@@ -246,9 +246,7 @@ class ManualBrowser:
chrome_profile = get_chrome_profile_dir()
if not chrome_profile:
- console.print(
- " [yellow]chrome profile not found, falling back to stealth mode[/yellow]"
- )
+ console.print(" [yellow]chrome profile not found, falling back to stealth mode[/yellow]")
return self._start_with_stealth_chromium(start_url)
# Create a temporary profile directory
@@ -473,9 +471,7 @@ class ManualBrowser:
return self.har_path
-def parse_agent_model(
- agent_model: str, agent_provider: str = "browser-use"
-) -> tuple[str, str | None]:
+def parse_agent_model(agent_model: str, agent_provider: str = "browser-use") -> tuple[str, str | None]:
"""Parse agent_model string into provider and model name.
Args:
@@ -512,15 +508,11 @@ def parse_agent_model(
if provider == "openai":
if model_name not in openai_cua_models:
- raise ValueError(
- f"Unsupported OpenAI model: {model_name}. "
- f"Supported OpenAI CUA models: {', '.join(openai_cua_models)}"
- )
+ raise ValueError(f"Unsupported OpenAI model: {model_name}. Supported OpenAI CUA models: {', '.join(openai_cua_models)}")
elif provider == "anthropic":
if model_name not in anthropic_cua_models:
raise ValueError(
- f"Unsupported Anthropic model: {model_name}. "
- f"Supported Anthropic CUA models: {', '.join(anthropic_cua_models)}"
+ f"Unsupported Anthropic model: {model_name}. Supported Anthropic CUA models: {', '.join(anthropic_cua_models)}"
)
else:
raise ValueError(
@@ -530,10 +522,7 @@ def parse_agent_model(
return (provider, model_name)
- raise ValueError(
- f"Invalid agent_model format: {agent_model}. "
- f"Expected 'bu-llm' or '{{provider}}/{{model_name}}' (e.g., 'openai/gpt-4')"
- )
+ raise ValueError(f"Invalid agent_model format: {agent_model}. Expected 'bu-llm' or '{{provider}}/{{model_name}}' (e.g., 'openai/gpt-4')")
def get_required_api_key(provider: str, agent_provider: str = "browser-use") -> tuple[str, str]:
@@ -634,9 +623,7 @@ class AgentBrowser:
def _save_metadata(self, end_time: str, result: dict | None = None) -> None:
"""Save run metadata to JSON file."""
# Select the appropriate model based on agent_provider
- agent_model = (
- self.stagehand_model if self.agent_provider == "stagehand" else self.browser_use_model
- )
+ agent_model = self.stagehand_model if self.agent_provider == "stagehand" else self.browser_use_model
metadata = {
"run_id": self.run_id,
@@ -707,9 +694,7 @@ class AgentBrowser:
try:
# Parse agent model and validate API key
try:
- provider, model_name = parse_agent_model(
- self.browser_use_model, self.agent_provider
- )
+ provider, model_name = parse_agent_model(self.browser_use_model, self.agent_provider)
except ValueError as e:
result["error"] = str(e)
console.print(f" [red]error:[/red] {e}")
@@ -785,11 +770,7 @@ class AgentBrowser:
final_message = None
if agent_result and hasattr(agent_result, "final_result"):
final_result_attr = agent_result.final_result
- final_message = (
- final_result_attr()
- if callable(final_result_attr)
- else final_result_attr
- )
+ final_message = final_result_attr() if callable(final_result_attr) else final_result_attr
result["success"] = True
result["message"] = final_message or "Task completed"
@@ -919,8 +900,7 @@ class AgentBrowser:
agent_result = await agent.execute(
{
"instruction": task_instruction,
- "maxSteps": self.timeout
- // 10, # Convert timeout seconds to reasonable step limit
+ "maxSteps": self.timeout // 10, # Convert timeout seconds to reasonable step limit
}
)
@@ -934,11 +914,7 @@ class AgentBrowser:
if agent_result:
if isinstance(agent_result, dict):
task_success = agent_result.get("success", False)
- final_message = (
- agent_result.get("message")
- or agent_result.get("result")
- or agent_result.get("text")
- )
+ final_message = agent_result.get("message") or agent_result.get("result") or agent_result.get("text")
elif hasattr(agent_result, "success"):
task_success = agent_result.success
# Only extract message field, ignore actions, usage, etc.
diff --git a/src/reverse_api/cli.py b/src/reverse_api/cli.py
index 5b18b1d..e46f2be 100644
--- a/src/reverse_api/cli.py
+++ b/src/reverse_api/cli.py
@@ -461,7 +461,8 @@ def handle_settings(mode_color=THEME_PRIMARY):
config_table.add_column(style="dim", justify="left")
config_table.add_column(style=mode_color, justify="left")
- for k, v in config_manager.config.items():
+ # Sort config items alphabetically by key
+ for k, v in sorted(config_manager.config.items()):
display_val = str(v) if v is not None else "default"
# Make the key more readable
key_display = k.replace("_", " ").title()
@@ -472,17 +473,18 @@ def handle_settings(mode_color=THEME_PRIMARY):
console.print(config_table)
console.print()
- # Settings menu
+ # Settings menu (sorted alphabetically)
choices = [
- Choice(title="Claude Code Model", value="claude_code_model"),
- Choice(title="SDK", value="sdk"),
- Choice(title="OpenCode Provider", value="opencode_provider"),
- Choice(title="OpenCode Model", value="opencode_model"),
Choice(title="Agent Provider", value="agent_provider"),
Choice(title="Browser-Use Model", value="browser_use_model"),
- Choice(title="Stagehand Model", value="stagehand_model"),
- Choice(title="Real-time Sync", value="real_time_sync"),
+ Choice(title="Claude Code Model", value="claude_code_model"),
+ Choice(title="OpenCode Model", value="opencode_model"),
+ Choice(title="OpenCode Provider", value="opencode_provider"),
Choice(title="Output Directory", value="output_dir"),
+ Choice(title="Output Language", value="output_language"),
+ Choice(title="Real-time Sync", value="real_time_sync"),
+ Choice(title="SDK", value="sdk"),
+ Choice(title="Stagehand Model", value="stagehand_model"),
Choice(title="Back", value="back"),
]
@@ -545,6 +547,29 @@ def handle_settings(mode_color=THEME_PRIMARY):
config_manager.set("sdk", sdk)
console.print(f" [dim]updated[/dim] sdk: {sdk}\n")
+ elif action == "output_language":
+ lang_choices = [
+ Choice(title="python", value="python"),
+ Choice(title="javascript", value="javascript"),
+ Choice(title="typescript", value="typescript"),
+ Choice(title="back", value="back"),
+ ]
+ lang = questionary.select(
+ "",
+ choices=lang_choices,
+ pointer=">",
+ qmark="",
+ style=questionary.Style(
+ [
+ ("pointer", f"fg:{mode_color} bold"),
+ ("highlighted", f"fg:{mode_color} bold"),
+ ]
+ ),
+ ).ask()
+ if lang and lang != "back":
+ config_manager.set("output_language", lang)
+ console.print(f" [dim]updated[/dim] output language: {lang}\n")
+
elif action == "agent_provider":
provider_choices = [
Choice(title="browser-use", value="browser-use"),
@@ -1227,6 +1252,7 @@ def run_auto_capture(prompt=None, url=None, model=None, output_dir=None):
# Run auto engineer based on SDK
try:
+ output_language = config_manager.get("output_language", "python")
if sdk == "opencode":
from .auto_engineer import OpenCodeAutoEngineer
@@ -1235,11 +1261,10 @@ def run_auto_capture(prompt=None, url=None, model=None, output_dir=None):
prompt=prompt,
output_dir=output_dir,
opencode_provider=config_manager.get("opencode_provider", "anthropic"),
- opencode_model=config_manager.get(
- "opencode_model", "claude-sonnet-4-5"
- ),
+ opencode_model=config_manager.get("opencode_model", "claude-sonnet-4-5"),
enable_sync=config_manager.get("real_time_sync", False),
sdk=sdk,
+ output_language=output_language,
)
else:
from .auto_engineer import ClaudeAutoEngineer
@@ -1247,11 +1272,11 @@ def run_auto_capture(prompt=None, url=None, model=None, output_dir=None):
engineer = ClaudeAutoEngineer(
run_id=run_id,
prompt=prompt,
- model=model
- or config_manager.get("claude_code_model", "claude-sonnet-4-5"),
+ model=model or config_manager.get("claude_code_model", "claude-sonnet-4-5"),
output_dir=output_dir,
enable_sync=config_manager.get("real_time_sync", False),
sdk=sdk,
+ output_language=output_language,
)
# Start sync before analysis
@@ -1328,6 +1353,7 @@ def run_engineer(
sdk = config_manager.get("sdk", "claude")
enable_sync = config_manager.get("real_time_sync", True)
+ output_language = config_manager.get("output_language", "python")
if sdk == "opencode":
result = run_reverse_engineering(
@@ -1342,6 +1368,7 @@ def run_engineer(
enable_sync=enable_sync,
additional_instructions=additional_instructions,
is_fresh=is_fresh,
+ output_language=output_language,
)
else:
result = run_reverse_engineering(
@@ -1354,6 +1381,7 @@ def run_engineer(
enable_sync=enable_sync,
additional_instructions=additional_instructions,
is_fresh=is_fresh,
+ output_language=output_language,
)
if result:
diff --git a/src/reverse_api/config.py b/src/reverse_api/config.py
index 2f7e8dc..fff483f 100644
--- a/src/reverse_api/config.py
+++ b/src/reverse_api/config.py
@@ -5,15 +5,16 @@ from pathlib import Path
from typing import Any
DEFAULT_CONFIG = {
+ "agent_provider": "auto", # "auto" (default, MCP-based browser + engineering), "browser-use", or "stagehand"
+ "browser_use_model": "bu-llm", # "bu-llm" or "{provider}/{model_name}" (e.g. "openai/gpt-5-mini")
"claude_code_model": "claude-sonnet-4-5",
- "opencode_provider": "anthropic",
"opencode_model": "claude-sonnet-4-5",
+ "opencode_provider": "anthropic",
"output_dir": None, # None means use ~/.reverse-api/runs
+ "output_language": "python", # "python", "javascript", or "typescript"
+ "real_time_sync": True, # Enable real-time file sync during engineering
"sdk": "claude", # "opencode" or "claude"
- "agent_provider": "auto", # "auto" (default, MCP-based browser + engineering), "browser-use", or "stagehand"
- "browser_use_model": "bu-llm", # "bu-llm" or "{provider}/{model_name}" (e.g. "openai/gpt-5-mini")
"stagehand_model": "openai/computer-use-preview-2025-03-11", # "{provider}/{model_name}" format
- "real_time_sync": True, # Enable real-time file sync during engineering
}
diff --git a/src/reverse_api/engineer.py b/src/reverse_api/engineer.py
index ddb0269..591e1dd 100644
--- a/src/reverse_api/engineer.py
+++ b/src/reverse_api/engineer.py
@@ -19,9 +19,7 @@ from .base_engineer import BaseEngineer
# Suppress claude_agent_sdk logs
logging.getLogger("claude_agent_sdk").setLevel(logging.WARNING)
-logging.getLogger("claude_agent_sdk._internal.transport.subprocess_cli").setLevel(
- logging.WARNING
-)
+logging.getLogger("claude_agent_sdk._internal.transport.subprocess_cli").setLevel(logging.WARNING)
class ClaudeEngineer(BaseEngineer):
@@ -79,9 +77,7 @@ class ClaudeEngineer(BaseEngineer):
tool_name = last_tool_name or "Tool"
self.ui.tool_result(tool_name, is_error, output)
- self.message_store.save_tool_result(
- tool_name, is_error, str(output) if output else None
- )
+ self.message_store.save_tool_result(tool_name, is_error, str(output) if output else None)
elif isinstance(block, TextBlock):
self.ui.thinking(block.text)
self.message_store.save_thinking(block.text)
@@ -92,24 +88,16 @@ class ClaudeEngineer(BaseEngineer):
self.message_store.save_error(message.result or "Unknown error")
return None
else:
- script_path = str(self.scripts_dir / "api_client.py")
- local_path = (
- str(self.local_scripts_dir / "api_client.py")
- if self.local_scripts_dir
- else None
- )
+ script_path = str(self.scripts_dir / self._get_client_filename())
+ local_path = str(self.local_scripts_dir / self._get_client_filename()) if self.local_scripts_dir else None
self.ui.success(script_path, local_path)
# Calculate estimated cost if we have usage data
if self.usage_metadata:
input_tokens = self.usage_metadata.get("input_tokens", 0)
output_tokens = self.usage_metadata.get("output_tokens", 0)
- cache_creation_tokens = self.usage_metadata.get(
- "cache_creation_input_tokens", 0
- )
- cache_read_tokens = self.usage_metadata.get(
- "cache_read_input_tokens", 0
- )
+ cache_creation_tokens = self.usage_metadata.get("cache_creation_input_tokens", 0)
+ cache_read_tokens = self.usage_metadata.get("cache_read_input_tokens", 0)
# Calculate cost using shared pricing module
from .pricing import calculate_cost
@@ -126,21 +114,13 @@ class ClaudeEngineer(BaseEngineer):
# Display usage breakdown
self.ui.console.print(" [dim]Usage:[/dim]")
if input_tokens > 0:
- self.ui.console.print(
- f" [dim] input: {input_tokens:,} tokens[/dim]"
- )
+ self.ui.console.print(f" [dim] input: {input_tokens:,} tokens[/dim]")
if cache_creation_tokens > 0:
- self.ui.console.print(
- f" [dim] cache creation: {cache_creation_tokens:,} tokens[/dim]"
- )
+ self.ui.console.print(f" [dim] cache creation: {cache_creation_tokens:,} tokens[/dim]")
if cache_read_tokens > 0:
- self.ui.console.print(
- f" [dim] cache read: {cache_read_tokens:,} tokens[/dim]"
- )
+ self.ui.console.print(f" [dim] cache read: {cache_read_tokens:,} tokens[/dim]")
if output_tokens > 0:
- self.ui.console.print(
- f" [dim] output: {output_tokens:,} tokens[/dim]"
- )
+ self.ui.console.print(f" [dim] output: {output_tokens:,} tokens[/dim]")
self.ui.console.print(f" [dim] total cost: ${cost:.4f}[/dim]")
result: dict[str, Any] = {
@@ -153,10 +133,7 @@ class ClaudeEngineer(BaseEngineer):
except Exception as e:
self.ui.error(str(e))
self.message_store.save_error(str(e))
- self.ui.console.print(
- "\n[dim]Make sure Claude Code CLI is installed: "
- "npm install -g @anthropic-ai/claude-code[/dim]"
- )
+ self.ui.console.print("\n[dim]Make sure Claude Code CLI is installed: npm install -g @anthropic-ai/claude-code[/dim]")
return None
return None
@@ -179,6 +156,7 @@ def run_reverse_engineering(
opencode_model: str | None = None,
enable_sync: bool = False,
is_fresh: bool = False,
+ output_language: str = "python",
) -> dict[str, Any] | None:
"""Run reverse engineering with the specified SDK.
@@ -188,6 +166,7 @@ def run_reverse_engineering(
opencode_model: Model ID for OpenCode (e.g., "claude-sonnet-4-5")
enable_sync: Enable real-time file syncing during engineering
is_fresh: Whether to start fresh (ignore previous scripts)
+ output_language: Target language - "python", "javascript", or "typescript"
"""
if sdk == "opencode":
from .opencode_engineer import OpenCodeEngineer
@@ -205,6 +184,7 @@ def run_reverse_engineering(
enable_sync=enable_sync,
sdk=sdk,
is_fresh=is_fresh,
+ output_language=output_language,
)
else:
engineer = ClaudeEngineer(
@@ -218,6 +198,7 @@ def run_reverse_engineering(
enable_sync=enable_sync,
sdk=sdk,
is_fresh=is_fresh,
+ output_language=output_language,
)
# Start sync before analysis
diff --git a/src/reverse_api/messages.py b/src/reverse_api/messages.py
index 23520c5..52276e4 100644
--- a/src/reverse_api/messages.py
+++ b/src/reverse_api/messages.py
@@ -38,9 +38,7 @@ class MessageStore:
"""Save a tool start event."""
self.append("tool_start", {"name": tool_name, "input": tool_input})
- def save_tool_result(
- self, tool_name: str, is_error: bool = False, output: str | None = None
- ) -> None:
+ def save_tool_result(self, tool_name: str, is_error: bool = False, output: str | None = None) -> None:
"""Save a tool result event."""
self.append(
"tool_result",
diff --git a/src/reverse_api/opencode_engineer.py b/src/reverse_api/opencode_engineer.py
index 7fe98cd..dcc682d 100644
--- a/src/reverse_api/opencode_engineer.py
+++ b/src/reverse_api/opencode_engineer.py
@@ -44,7 +44,6 @@ class OpenCodeEngineer(BaseEngineer):
self.opencode_provider = kwargs.pop("opencode_provider", "anthropic")
self.opencode_model = kwargs.pop("opencode_model", "claude-sonnet-4-5")
-
super().__init__(*args, **kwargs)
# Override UI with OpenCode-specific version
@@ -72,9 +71,7 @@ class OpenCodeEngineer(BaseEngineer):
self.opencode_ui.health_check(health)
except Exception as e:
debug_log(f"Health check failed: {e}")
- self.opencode_ui.error(
- f"OpenCode server not responding. Is it running on {self.BASE_URL}?"
- )
+ self.opencode_ui.error(f"OpenCode server not responding. Is it running on {self.BASE_URL}?")
return None
# Create a new session
@@ -104,9 +101,7 @@ class OpenCodeEngineer(BaseEngineer):
"parts": [{"type": "text", "text": self._build_analysis_prompt()}],
}
- prompt_r = await client.post(
- f"/session/{self._session_id}/message", json=prompt_body
- )
+ prompt_r = await client.post(f"/session/{self._session_id}/message", json=prompt_body)
prompt_r.raise_for_status()
# Wait for events to complete
@@ -126,7 +121,7 @@ class OpenCodeEngineer(BaseEngineer):
return None
# Success
- script_path = str(self.scripts_dir / "api_client.py")
+ script_path = str(self.scripts_dir / self._get_client_filename())
# Fetch actual provider and model used from session messages
try:
@@ -148,11 +143,7 @@ class OpenCodeEngineer(BaseEngineer):
# Show session summary before success message
self.opencode_ui.session_summary(self.usage_metadata)
- local_path = (
- str(self.local_scripts_dir / "api_client.py")
- if self.local_scripts_dir
- else None
- )
+ local_path = str(self.local_scripts_dir / self._get_client_filename()) if self.local_scripts_dir else None
self.opencode_ui.success(script_path, local_path)
result_data: dict[str, Any] = {
@@ -215,13 +206,11 @@ class OpenCodeEngineer(BaseEngineer):
except json.JSONDecodeError as e:
error_str = str(e)
# Check if this is a buffer size error
- if (
- "buffer size" in error_str.lower()
- or "1048576" in error_str
- or "exceeded maximum buffer" in error_str.lower()
- ):
+ if "buffer size" in error_str.lower() or "1048576" in error_str or "exceeded maximum buffer" in error_str.lower():
debug_log(f"Buffer size error detected: {e}")
- self._last_error = "Screenshot too large (exceeds 1MB limit). Try element-specific screenshots instead of full-page screenshots."
+ self._last_error = (
+ "Screenshot too large (exceeds 1MB limit). Try element-specific screenshots instead of full-page screenshots."
+ )
self.opencode_ui.error(self._last_error)
self.opencode_ui.console.print(
"[dim]Tip: Use browser_snapshot() for page structure or take smaller, element-specific screenshots.[/dim]"
@@ -242,9 +231,7 @@ class OpenCodeEngineer(BaseEngineer):
elif event_type == "session.idle":
event_sid = properties.get("sessionID")
- debug_log(
- f"session.idle: sessionID={event_sid}, our session={self._session_id}"
- )
+ debug_log(f"session.idle: sessionID={event_sid}, our session={self._session_id}")
if event_sid == self._session_id:
debug_log("Our session is idle, returning!")
self.opencode_ui.session_status("idle")
@@ -274,9 +261,7 @@ class OpenCodeEngineer(BaseEngineer):
perm_type = properties.get("type", "")
perm_title = properties.get("title", "")
- debug_log(
- f"permission.updated: id={permission_id}, type={perm_type}, title={perm_title}"
- )
+ debug_log(f"permission.updated: id={permission_id}, type={perm_type}, title={perm_title}")
if perm_session == self._session_id and permission_id:
# Show permission request in UI
@@ -343,17 +328,11 @@ class OpenCodeEngineer(BaseEngineer):
elif error_name == "APIError":
msg = error_data.get("message", "API error")
status = error_data.get("statusCode", "")
- self._last_error = (
- f"API error{' (' + str(status) + ')' if status else ''}: {msg}"
- )
+ self._last_error = f"API error{' (' + str(status) + ')' if status else ''}: {msg}"
elif error_name == "MessageAbortedError":
self._last_error = "Aborted"
else:
- msg = (
- error_data.get("message", "")
- if isinstance(error_data, dict)
- else str(error_data)
- )
+ msg = error_data.get("message", "") if isinstance(error_data, dict) else str(error_data)
self._last_error = f"{error_name}: {msg}" if msg else error_name
else:
self._last_error = str(error_obj)
@@ -381,9 +360,7 @@ class OpenCodeEngineer(BaseEngineer):
if part_type == "text":
text = part.get("text", "")
- debug_log(
- f"Handling text part: id={part_id}, delta={'yes' if delta else 'no'}, len={len(text)}"
- )
+ debug_log(f"Handling text part: id={part_id}, delta={'yes' if delta else 'no'}, len={len(text)}")
# Use delta for incremental updates if available
self.opencode_ui.update_text(text, delta)
@@ -444,36 +421,16 @@ class OpenCodeEngineer(BaseEngineer):
else:
cost = api_cost
- self.usage_metadata["input_tokens"] = (
- self.usage_metadata.get("input_tokens", 0) + input_tokens
- )
- self.usage_metadata["output_tokens"] = (
- self.usage_metadata.get("output_tokens", 0) + output_tokens
- )
- self.usage_metadata["reasoning_tokens"] = (
- self.usage_metadata.get("reasoning_tokens", 0) + reasoning_tokens
- )
- self.usage_metadata["cache_read_tokens"] = (
- self.usage_metadata.get("cache_read_tokens", 0) + cache_read
- )
- self.usage_metadata["cache_creation_tokens"] = (
- self.usage_metadata.get("cache_creation_tokens", 0) + cache_write
- )
- self.usage_metadata["input_tokens"] = (
- self.usage_metadata.get("input_tokens", 0) + input_tokens
- )
- self.usage_metadata["output_tokens"] = (
- self.usage_metadata.get("output_tokens", 0) + output_tokens
- )
- self.usage_metadata["reasoning_tokens"] = (
- self.usage_metadata.get("reasoning_tokens", 0) + reasoning_tokens
- )
- self.usage_metadata["cache_read_tokens"] = (
- self.usage_metadata.get("cache_read_tokens", 0) + cache_read
- )
- self.usage_metadata["cache_creation_tokens"] = (
- self.usage_metadata.get("cache_creation_tokens", 0) + cache_write
- )
+ self.usage_metadata["input_tokens"] = self.usage_metadata.get("input_tokens", 0) + input_tokens
+ self.usage_metadata["output_tokens"] = self.usage_metadata.get("output_tokens", 0) + output_tokens
+ self.usage_metadata["reasoning_tokens"] = self.usage_metadata.get("reasoning_tokens", 0) + reasoning_tokens
+ self.usage_metadata["cache_read_tokens"] = self.usage_metadata.get("cache_read_tokens", 0) + cache_read
+ self.usage_metadata["cache_creation_tokens"] = self.usage_metadata.get("cache_creation_tokens", 0) + cache_write
+ self.usage_metadata["input_tokens"] = self.usage_metadata.get("input_tokens", 0) + input_tokens
+ self.usage_metadata["output_tokens"] = self.usage_metadata.get("output_tokens", 0) + output_tokens
+ self.usage_metadata["reasoning_tokens"] = self.usage_metadata.get("reasoning_tokens", 0) + reasoning_tokens
+ self.usage_metadata["cache_read_tokens"] = self.usage_metadata.get("cache_read_tokens", 0) + cache_read
+ self.usage_metadata["cache_creation_tokens"] = self.usage_metadata.get("cache_creation_tokens", 0) + cache_write
self.usage_metadata["cost"] = self.usage_metadata.get("cost", 0) + cost
diff --git a/src/reverse_api/opencode_ui.py b/src/reverse_api/opencode_ui.py
index 37b1799..370784a 100644
--- a/src/reverse_api/opencode_ui.py
+++ b/src/reverse_api/opencode_ui.py
@@ -42,9 +42,7 @@ class OpenCodeUI:
self.console.print(f" [white]reverse-api[/white] [dim]v{__version__}[/dim]")
self.console.print(f" [dim]━[/dim] [white]{run_id}[/white]")
if sdk:
- self.console.print(
- f" [red]sdk[/red] [red]{sdk}[/red] [red]|[/red] [red]model[/red] [red]{model or '---'}[/red]"
- )
+ self.console.print(f" [red]sdk[/red] [red]{sdk}[/red] [red]|[/red] [red]model[/red] [red]{model or '---'}[/red]")
else:
self.console.print(f" [dim]model[/dim] [white]{model or '---'}[/white]")
self.console.print(f" [{THEME_PRIMARY}]task[/{THEME_PRIMARY}] [white]{prompt}[/white]")
@@ -119,9 +117,7 @@ class OpenCodeUI:
if self._live:
self._live.update(self._build_display())
- def tool_result(
- self, tool_name: str, is_error: bool = False, output: str | None = None
- ) -> None:
+ def tool_result(self, tool_name: str, is_error: bool = False, output: str | None = None) -> None:
"""Display when a tool completes."""
self._current_tool = None
self._tool_status = "completed" if not is_error else "error"
diff --git a/src/reverse_api/pricing.py b/src/reverse_api/pricing.py
index 06d0272..1c5083e 100644
--- a/src/reverse_api/pricing.py
+++ b/src/reverse_api/pricing.py
@@ -167,8 +167,7 @@ def _get_pricing_from_litellm(model_id: str) -> dict[str, float] | None:
pricing = {
"input": litellm_pricing.get("input_cost_per_token", 0) * 1_000_000,
"output": litellm_pricing.get("output_cost_per_token", 0) * 1_000_000,
- "cache_creation": litellm_pricing.get("cache_creation_input_token_cost", 0)
- * 1_000_000,
+ "cache_creation": litellm_pricing.get("cache_creation_input_token_cost", 0) * 1_000_000,
"cache_read": litellm_pricing.get("cache_read_input_token_cost", 0) * 1_000_000,
"reasoning": litellm_pricing.get("output_cost_per_token", 0) * 1_000_000,
}
diff --git a/src/reverse_api/sync.py b/src/reverse_api/sync.py
index f1e7793..d3c51e9 100644
--- a/src/reverse_api/sync.py
+++ b/src/reverse_api/sync.py
@@ -244,15 +244,11 @@ class FileSyncWatcher:
"error": "Observer stopped",
}
- seconds_since_sync = (
- time.time() - self.handler.last_sync_time if self.handler.last_sync_time > 0 else 0
- )
+ seconds_since_sync = time.time() - self.handler.last_sync_time if self.handler.last_sync_time > 0 else 0
return {
"active": True,
- "last_sync": f"{int(seconds_since_sync)}s ago"
- if self.handler.last_sync_time > 0
- else "never",
+ "last_sync": f"{int(seconds_since_sync)}s ago" if self.handler.last_sync_time > 0 else "never",
"file_count": self.handler.file_count,
}
diff --git a/src/reverse_api/tui.py b/src/reverse_api/tui.py
index c82e990..d5afac1 100644
--- a/src/reverse_api/tui.py
+++ b/src/reverse_api/tui.py
@@ -57,9 +57,7 @@ class ClaudeUI:
self._tool_count = 0
self._tools_used: list[str] = []
- def header(
- self, run_id: str, prompt: str, model: str | None = None, sdk: str | None = None
- ) -> None:
+ def header(self, run_id: str, prompt: str, model: str | None = None, sdk: str | None = None) -> None:
"""Display the session header."""
from . import __version__
@@ -67,9 +65,7 @@ class ClaudeUI:
self.console.print(f" [white]reverse-api[/white] [dim]v{__version__}[/dim]")
self.console.print(f" [dim]━[/dim] [white]{run_id}[/white]")
if sdk:
- self.console.print(
- f" [red]sdk[/red] [red]{sdk}[/red] [red]|[/red] [red]model[/red] [red]{model or '---'}[/red]"
- )
+ self.console.print(f" [red]sdk[/red] [red]{sdk}[/red] [red]|[/red] [red]model[/red] [red]{model or '---'}[/red]")
else:
self.console.print(f" [dim]model[/dim] [white]{model or '---'}[/white]")
self.console.print(f" [{THEME_PRIMARY}]task[/{THEME_PRIMARY}] [white]{prompt}[/white]")
@@ -91,13 +87,9 @@ class ClaudeUI:
input_summary = self._summarize_input(tool_name, tool_input)
# Compact single-line format
- self.console.print(
- f" [dim]>[/dim] {icon} [white]{tool_name.lower():8}[/white] {input_summary}"
- )
+ self.console.print(f" [dim]>[/dim] {icon} [white]{tool_name.lower():8}[/white] {input_summary}")
- def tool_result(
- self, tool_name: str, is_error: bool = False, output: str | None = None
- ) -> None:
+ def tool_result(self, tool_name: str, is_error: bool = False, output: str | None = None) -> None:
"""Display when a tool completes."""
if is_error:
self.console.print(f" [dim]![/dim] [red]{tool_name.lower()} failed[/red]")
@@ -110,9 +102,7 @@ class ClaudeUI:
for line in output_lines[:max_lines]:
self.console.print(f" [dim]│[/dim] [dim]{line}[/dim]")
if len(output_lines) > max_lines:
- self.console.print(
- f" [dim]│[/dim] [dim]... ({len(output_lines) - max_lines} more lines)[/dim]"
- )
+ self.console.print(f" [dim]│[/dim] [dim]... ({len(output_lines) - max_lines} more lines)[/dim]")
def thinking(self, text: str, max_length: int = 100) -> None:
"""Display Claude's thinking/response text."""
@@ -209,9 +199,7 @@ def display_banner(console: Console, sdk: str | None = None, model: str | None =
console.print(" [bold white]reverse-api[/bold white]")
console.print(f" [bold {THEME_PRIMARY}]━━[/bold {THEME_PRIMARY}]")
if sdk and model:
- console.print(
- f" [red]sdk[/red] [red]{sdk}[/red] [red]|[/red] [red]model[/red] [red]{model}[/red]"
- )
+ console.print(f" [red]sdk[/red] [red]{sdk}[/red] [red]|[/red] [red]model[/red] [red]{model}[/red]")
console.print()
console.print(" [dim white]AI agents for API reverse engineering.[/dim white]")
console.print()
diff --git a/src/reverse_api/utils.py b/src/reverse_api/utils.py
index 753590b..67b0d85 100644
--- a/src/reverse_api/utils.py
+++ b/src/reverse_api/utils.py
@@ -53,9 +53,7 @@ async def _generate_folder_name_async(prompt: str) -> str:
# Suppress claude_agent_sdk logs
logging.getLogger("claude_agent_sdk").setLevel(logging.WARNING)
- logging.getLogger("claude_agent_sdk._internal.transport.subprocess_cli").setLevel(
- logging.WARNING
- )
+ logging.getLogger("claude_agent_sdk._internal.transport.subprocess_cli").setLevel(logging.WARNING)
options = ClaudeAgentOptions(
allowed_tools=[], # No tools needed for simple text generation