Create OpenAI client with disabled SSL verification and optional client certificates.

Atomic write: write to ``.tmp`` then rename.

Run an async coroutine synchronously in IDA's context. This is a blocking call that waits for the coroutine to complete. On Windows,

Add a message, automatically grouping into blocks. Block boundaries: - Assistant message starts a new block - Tool r

Run a synchronous function in a background daemon thread. This is a convenience wrapper for the common pattern of: threading.Thread(t

Get the appropriate data directory path based on platform.

Starts a pipeline coroutine on the dedicated pipeline worker thread. This is the generic entry point for any long-running task.

Replace the cached index and optionally persist to disk.

Persist heartbeat/progress so users can tell indexer is alive.

Clear all blocks.

Gets pseudocode for a function with line numbers and addresses. Args: function_name_or_address: Function name (str) or address (

Protect content from further processing, like hilite.html.

Protect content from further processing, like hilite.html.

Refresh/decompile changed functions so IDA and Hex-Rays register updates.

Get the index for the currently loaded binary. Tries (in order): in-memory cache → on-disk file → fresh empty index.

Public accessor for index filepath (used by manager).

Return a stable unique identifier for the current binary/IDB. Strategy (all steps execute on the main thread): 1. Check the IDB netnode for

Return whether optional debug/trace file writing is enabled.

Sets or clears a comment in the IDA decompiler view at a specific address. Args: address (int or str): The address for the comment,

Close a coroutine that was never scheduled to avoid runtime warnings.

Add a tool call to the group.

Extract the importance tag (CRITICAL/HIGH/MEDIUM/LOW/MINIMAL).

Append an error message to the Fanalysis error log and keep console visibility.

Adds a new analysis entry to the history.

Create (if needed) and return the shared async worker pool.

Safely retrieves a function name from the main thread.

Normalize address to 0x-prefixed, zero-padded hex string.

Validate basic configuration requirements (no network calls).

Update the display based on current function address.

Wrapper for execute_sync that checks for shutdown to avoid crashes.

Only block invalid JSON; key/item correction is handled by save_config.

Count tokens using tiktoken when available, otherwise estimate via chars/4. The char/4 heuristic is deliberately conservative for code (real

Updates or creates a struct using a list of tuples. :param struct_name: Name of the struct (e.g., "MyStruct") :param fields_list: List of

All tags that are *not* importance levels.

Get context management statistics.

Shared activate() setup for handlers that need validated config and current function context. Returns: tuple[dict | None, str | None

Reads the analysis history from the netnode.

Test MCP server connection and metadata retrieval.

Validate configuration before running analysis.

Set the generating state and update display.

Call the LLM and require tool calls. Returns (tool_calls, tokens, text, message).

Generate a simple fallback summary if LLM fails.

Ensure *value* is a list of strings. Wraps single strings in a list.

Normalize potentially unsafe LLM names into valid C-like identifiers.

Helper to thread-safely update the IDA Viewer.

Common function to check config and show error dialog if invalid.