intellicrack.ui.guest_process_picker

Guest process picker dialog for sandbox memory-dump target selection.

Presents the live process list returned by list_guest_processes() so the user can choose a target_pid before dumping a Windows Sandbox guest process (S17-D10b / audit7 F-0021: SandboxBridge.memory_dump requires an explicit, positive target_pid for Windows Sandbox instances, and the GUI could never supply one before this dialog existed).

class GuestProcessRow[source]

Bases: TypedDict

One guest process record as reported by the sandbox bridge.

Variables:

  • pid (int) – Guest-side process identifier.

  • name (str) – Process image name (e.g. notepad.exe).

  • path (str) – Full path to the process executable, or an empty string when the guest could not report it (commonly a protected process).

pid: int
name: str
path: str
class GuestProcessPickerDialog[source]

Bases: QDialog

Modal dialog that lets the user pick a live guest process by PID.

Displays the enumerated guest processes in a sortable, filterable table and returns the chosen PID via selected_pid(). Selecting a row enables OK; double-clicking a row accepts immediately. Cancelling, or closing the dialog without a selection, leaves selected_pid() returning None so the caller can distinguish “no target chosen” from a genuine PID.

__init__(processes, parent=None)[source]

Initialize the picker with the enumerated guest processes.

Parameters:

  • processes (Sequence[GuestProcessRow]) – Guest process records to display, in the order supplied by the caller.

  • parent (QWidget | None) – Parent widget.

Return type:

None

selected_pid()[source]

Return the PID chosen by the user.

Returns:

The selected guest PID, or None when the dialog was cancelled or closed without a selection.

Return type:

int | None