subprojects: Prepare for release

Expose Device.override_option() for overriding backend-specific
options on a device.

Overrides apply when establishing a host session. If one already
exists, changes take effect on the next connection.

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: frida

.gitignore

@@ -1,5 +1,6 @@
 *.pyc
-*.user
 /*.egg-info/
 /build/
+/deps/
 /dist/
+/subprojects/*

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "releng"]
+	path = releng
+	url = https://github.com/frida/releng.git

BSDmakefile

@@ -0,0 +1,6 @@
+all: .DEFAULT
+
+.DEFAULT:
+	@gmake ${.MAKEFLAGS} ${.TARGETS}
+
+.PHONY: all

MANIFEST.in

@@ -0,0 +1,19 @@
+include meson.build
+include frida/meson.build
+include frida/_frida/extension.c
+include frida/_frida/extension.version
+include frida/_frida/meson.build
+include subprojects/frida-core.wrap
+
+include BSDmakefile
+include Makefile
+include configure
+include configure.bat
+include make.bat
+include releng/*.py
+include releng/*.toml
+graft releng/devkit-assets/
+graft releng/meson-scripts/
+include releng/meson/meson.py
+graft releng/meson/mesonbuild/
+graft releng/tomlkit/tomlkit/

Makefile

@@ -0,0 +1,16 @@
+PYTHON ?= $(shell which python3 >/dev/null && echo python3 || echo python)
+
+all $(MAKECMDGOALS):
+	@$(PYTHON) \
+		-c "import sys; sys.path.insert(0, sys.argv[1]); from releng.meson_make import main; main()" \
+		"$(shell pwd)" \
+		./build \
+		$(MAKECMDGOALS)
+
+git-submodules:
+	@if [ ! -f releng/meson/meson.py ]; then \
+		git submodule update --init --recursive --depth 1; \
+	fi
+-include git-submodules
+
+.PHONY: all $(MAKECMDGOALS)

config.h.in

@@ -1,19 +0,0 @@
-/* config.h.in.  Generated from configure.ac by autoheader.  */
-
-/* Define to 1 if OS is Android based. */
-#mesondefine HAVE_ANDROID
-
-/* Define to 1 if OS is Darwin based. */
-#mesondefine HAVE_DARWIN
-
-/* Define to 1 if OS is iOS. */
-#mesondefine HAVE_IOS
-
-/* Define to 1 if OS is Linux based. */
-#mesondefine HAVE_LINUX
-
-/* Define to 1 if OS is macOS. */
-#mesondefine HAVE_MACOS
-
-/* Define to 1 if OS is QNX based. */
-#mesondefine HAVE_QNX

configure

@@ -0,0 +1,18 @@
+#!/bin/sh
+
+[ -z "$PYTHON" ] && PYTHON=$(which python3 >/dev/null && echo python3 || echo python)
+
+cd $(dirname $0)
+
+srcroot=$(pwd)
+
+if [ ! -f releng/meson/meson.py ]; then
+  git submodule update --init --recursive --depth 1 || exit $?
+fi
+
+cd - >/dev/null
+
+exec "$PYTHON" \
+    -c "import sys; sys.path.insert(0, sys.argv[1]); from releng.meson_configure import main; main()" \
+    "$srcroot" \
+    "$@"

configure.bat

@@ -0,0 +1,22 @@
+@setlocal
+@echo off
+rem:: Based on: https://github.com/microsoft/terminal/issues/217#issuecomment-737594785
+goto :_start_
+
+:set_real_dp0
+set dp0=%~dp0
+set "dp0=%dp0:~0,-1%"
+goto :eof
+
+:_start_
+call :set_real_dp0
+
+if not exist "%dp0%\releng\meson\meson.py" (
+  pushd "%dp0%" & git submodule update --init --recursive --depth 1 & popd
+  if %errorlevel% neq 0 exit /b %errorlevel%
+)
+
+endlocal & goto #_undefined_# 2>nul || title %COMSPEC% & python ^
+    -c "import sys; sys.path.insert(0, sys.argv[1]); from releng.meson_configure import main; main()" ^
+    "%dp0%" ^
+    %*

examples/child_gating.py

@@ -42,18 +42,16 @@ class Application:
         print("✔ enable_child_gating()")
         session.enable_child_gating()
         print("✔ create_script()")
-        script = session.create_script(
-            """\
-Interceptor.attach(Module.getExportByName(null, 'open'), {
-  onEnter: function (args) {
+        script = session.create_script("""\
+Interceptor.attach(Module.getGlobalExportByName('open'), {
+  onEnter(args) {
     send({
       type: 'open',
-      path: Memory.readUtf8String(args[0])
+      path: args[0].readUtf8String()
     });
   }
 });
-"""
-        )
+""")
         script.on("message", lambda message, data: self._reactor.schedule(lambda: self._on_message(pid, message)))
         print("✔ load()")
         script.load()

examples/inject_library/inject_blob.py

@@ -15,7 +15,7 @@ def on_uninjected(id):
     print("on_uninjected id=%u" % id)
 
 
-(target, library_path) = sys.argv[1:]
+target, library_path = sys.argv[1:]
 
 device = frida.get_local_device()
 device.on("uninjected", on_uninjected)

examples/inject_library/inject_file.py

@@ -15,7 +15,7 @@ def on_uninjected(id):
     print("on_uninjected id=%u" % id)
 
 
-(target, library_path) = sys.argv[1:]
+target, library_path = sys.argv[1:]
 
 device = frida.get_local_device()
 device.on("uninjected", on_uninjected)

examples/open_service/dtx/deviceinfo.py

@@ -0,0 +1,9 @@
+import pprint
+
+import frida
+
+device = frida.get_usb_device()
+
+deviceinfo = device.open_service("dtx:com.apple.instruments.server.services.deviceinfo")
+response = deviceinfo.request({"method": "runningProcesses"})
+pprint.pp(response)

examples/open_service/dtx/opengl.py

@@ -0,0 +1,27 @@
+import sys
+
+import frida
+
+
+def on_message(message):
+    print("on_message:", message)
+
+
+device = frida.get_usb_device()
+
+opengl = device.open_service("dtx:com.apple.instruments.server.services.graphics.opengl")
+opengl.on("message", on_message)
+opengl.request(
+    {
+        "method": "setSamplingRate:",
+        "args": [5.0],
+    }
+)
+opengl.request(
+    {
+        "method": "startSamplingAtTimeInterval:",
+        "args": [0.0],
+    }
+)
+
+sys.stdin.read()

examples/open_service/dtx/processcontrol.py

@@ -0,0 +1,31 @@
+import sys
+
+import frida
+
+
+def on_message(message):
+    print("on_message:", message)
+
+
+device = frida.get_usb_device()
+
+control = device.open_service("dtx:com.apple.instruments.server.services.processcontrol")
+control.on("message", on_message)
+pid = control.request(
+    {
+        "method": "launchSuspendedProcessWithDevicePath:bundleIdentifier:environment:arguments:options:",
+        "args": [
+            "",
+            "no.oleavr.HelloIOS",
+            {},
+            [],
+            {
+                "StartSuspendedKey": False,
+            },
+        ],
+    }
+)
+control.request({"method": "startObservingPid:", "args": [pid]})
+
+print(f"App spawned, PID: {pid}.  Kill it to see an example message being emitted.")
+sys.stdin.read()

examples/open_service/dtx/screenshot.py

@@ -0,0 +1,15 @@
+import sys
+
+import frida
+
+if len(sys.argv) != 2:
+    print(f"Usage: {sys.argv[0]} outfile.png", file=sys.stderr)
+    sys.exit(1)
+outfile = sys.argv[1]
+
+device = frida.get_usb_device()
+
+screenshot = device.open_service("dtx:com.apple.instruments.server.services.screenshot")
+png = screenshot.request({"method": "takeScreenshot"})
+with open(outfile, "wb") as f:
+    f.write(png)

examples/open_service/dtx/sysmontap.py

@@ -0,0 +1,29 @@
+import time
+
+import frida
+
+
+def on_message(message):
+    print("on_message:", message)
+
+
+device = frida.get_usb_device()
+
+sysmon = device.open_service("dtx:com.apple.instruments.server.services.sysmontap")
+sysmon.on("message", on_message)
+sysmon.request(
+    {
+        "method": "setConfig:",
+        "args": [
+            {
+                "ur": 1000,
+                "cpuUsage": True,
+                "sampleInterval": 1000000000,
+            },
+        ],
+    }
+)
+sysmon.request({"method": "start"})
+time.sleep(5)
+sysmon.request({"method": "stop"})
+time.sleep(1)

examples/open_service/plist.py

@@ -0,0 +1,7 @@
+import frida
+
+device = frida.get_usb_device()
+
+diag = device.open_service("plist:com.apple.mobile.diagnostics_relay")
+diag.request({"type": "query", "payload": {"Request": "Sleep", "WaitForDisconnect": True}})
+diag.request({"type": "query", "payload": {"Request": "Goodbye"}})

examples/open_service/xpc/launchapplication.py

@@ -0,0 +1,64 @@
+import pprint
+import sys
+from threading import Thread
+
+import frida
+
+
+def main():
+    device = frida.get_usb_device()
+
+    stdout_uuid, stdout_stream = create_stdio_socket(device)
+    stderr_uuid, stderr_stream = create_stdio_socket(device)
+
+    appservice = device.open_service("xpc:com.apple.coredevice.appservice")
+    response = appservice.request(
+        {
+            "CoreDevice.featureIdentifier": "com.apple.coredevice.feature.launchapplication",
+            "CoreDevice.action": {},
+            "CoreDevice.input": {
+                "applicationSpecifier": {
+                    "bundleIdentifier": {"_0": "no.oleavr.HelloIOS"},
+                },
+                "options": {
+                    "arguments": [],
+                    "environmentVariables": {},
+                    "standardIOUsesPseudoterminals": True,
+                    "startStopped": False,
+                    "terminateExisting": True,
+                    "user": {"active": True},
+                    "platformSpecificOptions": b'<?xml version="1.0" encoding="UTF-8"?><plist version="1.0"><dict/></plist>',
+                },
+                "standardIOIdentifiers": {
+                    "standardOutput": ("uuid", stdout_uuid),
+                    "standardError": ("uuid", stderr_uuid),
+                },
+            },
+        }
+    )
+    pprint.pp(response)
+
+    workers = set()
+    for stream, sink in {(stdout_stream, sys.stdout), (stderr_stream, sys.stderr)}:
+        t = Thread(target=process_console_output, args=(stream, sink))
+        t.start()
+        workers.add(t)
+    for worker in workers:
+        worker.join()
+
+
+def create_stdio_socket(device):
+    stream = device.open_channel("tcp:com.apple.coredevice.openstdiosocket")
+    return (stream.read_all(16), stream)
+
+
+def process_console_output(stream, sink):
+    while True:
+        chunk = stream.read(4096)
+        if not chunk:
+            break
+        sink.write(chunk.decode("utf-8"))
+
+
+if __name__ == "__main__":
+    main()

examples/open_service/xpc/listprocesses.py

@@ -0,0 +1,15 @@
+import pprint
+
+import frida
+
+device = frida.get_usb_device()
+
+appservice = device.open_service("xpc:com.apple.coredevice.appservice")
+response = appservice.request(
+    {
+        "CoreDevice.featureIdentifier": "com.apple.coredevice.feature.listprocesses",
+        "CoreDevice.action": {},
+        "CoreDevice.input": {},
+    }
+)
+pprint.pp(response)

examples/rpc.py

@@ -1,8 +1,7 @@
 import frida
 
 session = frida.attach("Twitter")
-script = session.create_script(
-    """\
+script = session.create_script("""\
 rpc.exports = {
   hello: function () {
     return 'Hello';
@@ -11,8 +10,7 @@ rpc.exports = {
     oops;
   }
 };
-"""
-)
+""")
 script.load()
 api = script.exports_sync
 print("api.hello() =>", api.hello())

examples/session_persist_timeout.py

@@ -22,8 +22,7 @@ class Application:
         self._session = session
         session.on("detached", lambda *args: self._reactor.schedule(lambda: self._on_detached(*args)))
 
-        script = session.create_script(
-            """
+        script = session.create_script("""
 let _puts = null;
 
 Interceptor.attach(DebugSymbol.getFunctionByName('f'), {
@@ -48,8 +47,7 @@ function puts(s) {
   }
   _puts(Memory.allocUtf8String(s));
 }
-"""
-        )
+""")
         self._script = script
         script.on("message", lambda *args: self._reactor.schedule(lambda: self._on_message(*args)))
         script.load()

examples/spawn_gating.py

@@ -0,0 +1,78 @@
+import threading
+
+from frida_tools.application import Reactor
+
+import frida
+
+
+class Application:
+    def __init__(self):
+        self._stop_requested = threading.Event()
+        self._reactor = Reactor(run_until_return=lambda reactor: self._stop_requested.wait())
+
+        self._device = frida.get_usb_device()
+        self._sessions = set()
+        self._sessions_lock = threading.Lock()
+
+        self._device.on("spawn-added", lambda spawn: self._reactor.schedule(lambda: self._on_spawn_added(spawn)))
+        self._device.on("spawn-removed", lambda spawn: self._reactor.schedule(lambda: self._on_spawn_removed(spawn)))
+
+    def run(self):
+        self._reactor.schedule(lambda: self._start())
+        self._reactor.run()
+
+    def _start(self):
+        self._device.enable_spawn_gating()
+
+    def _instrument(self, pid):
+        print(f"✔ attach(pid={pid})")
+        session = self._device.attach(pid)
+        session.on("detached", lambda reason: self._reactor.schedule(lambda: self._on_detached(pid, session, reason)))
+        print("✔ create_script()")
+        script = session.create_script("""\
+const puts = new NativeFunction(Module.getGlobalExportByName('puts'), 'int', ['pointer']);
+puts(Memory.allocUtf8String('Hello from Frida agent'));
+Interceptor.attach(Module.getGlobalExportByName('open'), {
+  onEnter(args) {
+    send({
+      type: 'open',
+      path: args[0].readUtf8String()
+    });
+  }
+});
+""")
+        script.on("message", lambda message, data: self._reactor.schedule(lambda: self._on_message(pid, message)))
+        print("✔ load()")
+        script.load()
+        print(f"✔ resume(pid={pid})")
+        self._device.resume(pid)
+        with self._sessions_lock:
+            self._sessions.add(session)
+
+    def _on_spawn_added(self, spawn):
+        print(f"⚡ spawn_added: {spawn}")
+        t = threading.Thread(target=self._handle_spawn, args=(spawn,))
+        t.start()
+
+    def _handle_spawn(self, spawn):
+        if "/bin/ls" in spawn.identifier:
+            self._instrument(spawn.pid)
+        else:
+            pid = spawn.pid
+            print(f"✔ resume(pid={pid})")
+            self._device.resume(pid)
+
+    def _on_spawn_removed(self, spawn):
+        print(f"⚡ spawn_removed: {spawn}")
+
+    def _on_detached(self, pid, session, reason):
+        print(f"⚡ detached: pid={pid}, reason='{reason}'")
+        with self._sessions_lock:
+            self._sessions.remove(session)
+
+    def _on_message(self, pid, message):
+        print(f"⚡ message: pid={pid}, payload={message['payload']}")
+
+
+app = Application()
+app.run()

frida-python.vcxproj

@@ -1,176 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<Project DefaultTargets="Build" ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <ItemGroup Label="ProjectConfigurations">
-    <ProjectConfiguration Include="Debug|Win32">
-      <Configuration>Debug</Configuration>
-      <Platform>Win32</Platform>
-    </ProjectConfiguration>
-    <ProjectConfiguration Include="Debug|x64">
-      <Configuration>Debug</Configuration>
-      <Platform>x64</Platform>
-    </ProjectConfiguration>
-    <ProjectConfiguration Include="Release|Win32">
-      <Configuration>Release</Configuration>
-      <Platform>Win32</Platform>
-    </ProjectConfiguration>
-    <ProjectConfiguration Include="Release|x64">
-      <Configuration>Release</Configuration>
-      <Platform>x64</Platform>
-    </ProjectConfiguration>
-  </ItemGroup>
-  <PropertyGroup Label="Globals">
-    <ProjectGuid>{7505F884-DD69-4F23-ADE6-1E0E049AB018}</ProjectGuid>
-    <RootNamespace>frida</RootNamespace>
-    <Keyword>Win32Proj</Keyword>
-    <ProjectName>frida-python</ProjectName>
-  </PropertyGroup>
-  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" Label="Configuration">
-    <ConfigurationType>DynamicLibrary</ConfigurationType>
-    <UseDebugLibraries>true</UseDebugLibraries>
-    <CharacterSet>Unicode</CharacterSet>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration">
-    <ConfigurationType>DynamicLibrary</ConfigurationType>
-    <UseDebugLibraries>true</UseDebugLibraries>
-    <CharacterSet>Unicode</CharacterSet>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" Label="Configuration">
-    <ConfigurationType>DynamicLibrary</ConfigurationType>
-    <UseDebugLibraries>false</UseDebugLibraries>
-    <WholeProgramOptimization>false</WholeProgramOptimization>
-    <CharacterSet>Unicode</CharacterSet>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'" Label="Configuration">
-    <ConfigurationType>DynamicLibrary</ConfigurationType>
-    <UseDebugLibraries>false</UseDebugLibraries>
-    <WholeProgramOptimization>false</WholeProgramOptimization>
-    <CharacterSet>Unicode</CharacterSet>
-  </PropertyGroup>
-  <Import Project="$(SolutionDir)releng\frida-toolchain.props" />
-  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
-  <ImportGroup Label="ExtensionSettings">
-  </ImportGroup>
-  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
-    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
-    <Import Project="$(SolutionDir)releng\frida-$(Configuration).props" />
-  </ImportGroup>
-  <ImportGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="PropertySheets">
-    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
-    <Import Project="$(SolutionDir)releng\frida-$(Configuration).props" />
-  </ImportGroup>
-  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
-    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
-    <Import Project="$(SolutionDir)releng\frida-$(Configuration).props" />
-  </ImportGroup>
-  <ImportGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'" Label="PropertySheets">
-    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
-    <Import Project="$(SolutionDir)releng\frida-$(Configuration).props" />
-  </ImportGroup>
-  <PropertyGroup Label="UserMacros" />
-  <PropertyGroup>
-    <_ProjectFileVersion>10.0.30319.1</_ProjectFileVersion>
-    <OutDir Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(SolutionDir)build\frida-windows\$(PlatformName)-$(Configuration)\lib\python3.10\site-packages\</OutDir>
-    <OutDir Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(SolutionDir)build\frida-windows\$(PlatformName)-$(Configuration)\lib\python3.10\site-packages\</OutDir>
-    <OutDir Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(SolutionDir)build\frida-windows\$(PlatformName)-$(Configuration)\lib\python3.10\site-packages\</OutDir>
-    <OutDir Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(SolutionDir)build\frida-windows\$(PlatformName)-$(Configuration)\lib\python3.10\site-packages\</OutDir>
-    <TargetName Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">_frida</TargetName>
-    <TargetName Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">_frida</TargetName>
-    <TargetName Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">_frida</TargetName>
-    <TargetName Condition="'$(Configuration)|$(Platform)'=='Release|x64'">_frida</TargetName>
-    <TargetExt Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">.pyd</TargetExt>
-    <TargetExt Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">.pyd</TargetExt>
-    <TargetExt Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">.pyd</TargetExt>
-    <TargetExt Condition="'$(Configuration)|$(Platform)'=='Release|x64'">.pyd</TargetExt>
-  </PropertyGroup>
-  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
-    <Link>
-      <SubSystem>Windows</SubSystem>
-      <AdditionalLibraryDirectories>$(PythonLocation)\libs;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
-    </Link>
-    <ClCompile>
-      <AdditionalIncludeDirectories>$(IntDir)..\frida-core\api;$(PythonLocation)\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
-      <PreprocessorDefinitions>$(FridaComponentDefines);%(PreprocessorDefinitions)</PreprocessorDefinitions>
-    </ClCompile>
-  </ItemDefinitionGroup>
-  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
-    <Link>
-      <SubSystem>Windows</SubSystem>
-      <AdditionalLibraryDirectories>$(PythonLocation)\libs;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
-    </Link>
-    <ClCompile>
-      <AdditionalIncludeDirectories>$(IntDir)..\frida-core\api;$(PythonLocation)\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
-      <PreprocessorDefinitions>$(FridaComponentDefines);%(PreprocessorDefinitions)</PreprocessorDefinitions>
-    </ClCompile>
-  </ItemDefinitionGroup>
-  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
-    <Link>
-      <SubSystem>Windows</SubSystem>
-      <AdditionalLibraryDirectories>$(PythonLocation)\libs;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
-    </Link>
-    <ClCompile>
-      <AdditionalIncludeDirectories>$(IntDir)..\frida-core\api;$(PythonLocation)\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
-      <PreprocessorDefinitions>$(FridaComponentDefines);%(PreprocessorDefinitions)</PreprocessorDefinitions>
-    </ClCompile>
-  </ItemDefinitionGroup>
-  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'">
-    <Link>
-      <SubSystem>Windows</SubSystem>
-      <AdditionalLibraryDirectories>$(PythonLocation)\libs;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
-    </Link>
-    <ClCompile>
-      <AdditionalIncludeDirectories>$(IntDir)..\frida-core\api;$(PythonLocation)\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
-      <PreprocessorDefinitions>$(FridaComponentDefines);%(PreprocessorDefinitions)</PreprocessorDefinitions>
-    </ClCompile>
-  </ItemDefinitionGroup>
-  <ItemGroup>
-    <ProjectReference Include="..\frida-core\frida-core.vcxproj">
-      <Project>{b7dc9b02-a5ff-4aa1-b2a2-dc1653168d44}</Project>
-      <Private>false</Private>
-      <ReferenceOutputAssembly>true</ReferenceOutputAssembly>
-      <CopyLocalSatelliteAssemblies>false</CopyLocalSatelliteAssemblies>
-      <LinkLibraryDependencies>true</LinkLibraryDependencies>
-      <UseLibraryDependencyInputs>false</UseLibraryDependencyInputs>
-    </ProjectReference>
-  </ItemGroup>
-  <ItemGroup>
-    <ClCompile Include="src\_frida.c" />
-  </ItemGroup>
-  <ItemGroup>
-    <CustomBuild Include="frida\__init__.py">
-      <FileType>Document</FileType>
-      <Message Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">Installing frida package</Message>
-      <Message Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">Installing frida package</Message>
-      <Message Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">Installing frida package</Message>
-      <Message Condition="'$(Configuration)|$(Platform)'=='Release|x64'">Installing frida package</Message>
-      <Command Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">rmdir /S /Q $(OutDir)frida 2&gt;NUL
-mkdir $(OutDir)frida || exit 1
-copy /B /Y "$(ProjectDir)frida\*.py" $(OutDir)frida || exit 1
-echo. &gt; $(IntDir)frida-package.stamp</Command>
-      <Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(IntDir)frida-package.stamp</Outputs>
-      <AdditionalInputs Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(ProjectDir)frida\core.py</AdditionalInputs>
-      <Command Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">rmdir /S /Q $(OutDir)frida 2&gt;NUL
-mkdir $(OutDir)frida || exit 1
-copy /B /Y "$(ProjectDir)frida\*.py" $(OutDir)frida || exit 1
-echo. &gt; $(IntDir)frida-package.stamp</Command>
-      <Outputs Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(IntDir)frida-package.stamp</Outputs>
-      <AdditionalInputs Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(ProjectDir)frida\core.py</AdditionalInputs>
-      <Command Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">rmdir /S /Q $(OutDir)frida 2&gt;NUL
-mkdir $(OutDir)frida || exit 1
-copy /B /Y "$(ProjectDir)frida\*.py" $(OutDir)frida || exit 1
-echo. &gt; $(IntDir)frida-package.stamp</Command>
-      <Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(IntDir)frida-package.stamp</Outputs>
-      <AdditionalInputs Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(ProjectDir)frida\core.py</AdditionalInputs>
-      <Command Condition="'$(Configuration)|$(Platform)'=='Release|x64'">rmdir /S /Q $(OutDir)frida 2&gt;NUL
-mkdir $(OutDir)frida || exit 1
-copy /B /Y "$(ProjectDir)frida\*.py" $(OutDir)frida || exit 1
-echo. &gt; $(IntDir)frida-package.stamp</Command>
-      <Outputs Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(IntDir)frida-package.stamp</Outputs>
-      <AdditionalInputs Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(ProjectDir)frida\core.py</AdditionalInputs>
-    </CustomBuild>
-    <None Include="frida\core.py" />
-  </ItemGroup>
-  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
-  <ImportGroup Label="ExtensionTargets">
-  </ImportGroup>
-</Project>

frida-python.vcxproj.filters

@@ -1,35 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <ItemGroup>
-    <Filter Include="Source Files">
-      <UniqueIdentifier>{4FC737F1-C7A5-4376-A066-2A32D752A2FF}</UniqueIdentifier>
-      <Extensions>cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx</Extensions>
-    </Filter>
-    <Filter Include="Header Files">
-      <UniqueIdentifier>{93995380-89BD-4b04-88EB-625FBE52EBFB}</UniqueIdentifier>
-      <Extensions>h;hpp;hxx;hm;inl;inc;xsd</Extensions>
-    </Filter>
-    <Filter Include="Resource Files">
-      <UniqueIdentifier>{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}</UniqueIdentifier>
-      <Extensions>rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx;tiff;tif;png;wav;mfcribbon-ms</Extensions>
-    </Filter>
-    <Filter Include="Source Files\frida">
-      <UniqueIdentifier>{e8366f87-de40-4415-8724-a51c48fc532d}</UniqueIdentifier>
-    </Filter>
-  </ItemGroup>
-  <ItemGroup>
-    <ClCompile Include="src\_frida.c">
-      <Filter>Source Files</Filter>
-    </ClCompile>
-  </ItemGroup>
-  <ItemGroup>
-    <None Include="frida\core.py">
-      <Filter>Source Files\frida</Filter>
-    </None>
-  </ItemGroup>
-  <ItemGroup>
-    <CustomBuild Include="frida\__init__.py">
-      <Filter>Source Files\frida</Filter>
-    </CustomBuild>
-  </ItemGroup>
-</Project>

frida/__init__.py

@@ -1,7 +1,7 @@
 from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 
 try:
-    import _frida
+    from . import _frida
 except Exception as ex:
     print("")
     print("***")
@@ -23,6 +23,7 @@ Relay = _frida.Relay
 PortalService = core.PortalService
 EndpointParameters = core.EndpointParameters
 Compiler = core.Compiler
+PackageManager = core.PackageManager
 FileMonitor = _frida.FileMonitor
 Cancellable = core.Cancellable
 

frida/_frida/__init__.pyi

@@ -23,6 +23,7 @@ class Object:
         Add a signal handler.
         """
         ...
+
     def off(self, signal: str, callback: Callable[..., Any]) -> None:
         """
         Remove a signal handler.
@@ -36,18 +37,21 @@ class Application(Object):
         Application identifier.
         """
         ...
+
     @property
     def name(self) -> str:
         """
         Human-readable application name.
         """
         ...
+
     @property
     def parameters(self) -> Dict[str, Any]:
         """
         Parameters.
         """
         ...
+
     @property
     def pid(self) -> int:
         """
@@ -61,6 +65,7 @@ class Bus(Object):
         Attach to the bus.
         """
         ...
+
     def post(self, message: str, data: Optional[Union[bytes, str]]) -> None:
         """
         Post a JSON-encoded message to the bus.
@@ -73,47 +78,56 @@ class Cancellable(Object):
         Set cancellable to cancelled.
         """
         ...
+
     def connect(self, callback: Callable[..., Any]) -> int:
         """
         Register notification callback.
         """
         ...
+
     def disconnect(self, handler_id: int) -> None:
         """
         Unregister notification callback.
         """
         ...
+
     @classmethod
     def get_current(cls) -> "Cancellable":
         """
         Get the top cancellable from the stack.
         """
         ...
+
     def get_fd(self) -> int:
         """
         Get file descriptor for integrating with an event loop.
         """
         ...
+
     def is_cancelled(self) -> bool:
         """
         Query whether cancellable has been cancelled.
         """
         ...
+
     def pop_current(self) -> None:
         """
         Pop cancellable off the cancellable stack.
         """
         ...
+
     def push_current(self) -> None:
         """
         Push cancellable onto the cancellable stack.
         """
         ...
+
     def raise_if_cancelled(self) -> None:
         """
         Raise an exception if cancelled.
         """
         ...
+
     def release_fd(self) -> None:
         """
         Release a resource previously allocated by get_fd().
@@ -127,36 +141,42 @@ class Child(Object):
         Argument vector.
         """
         ...
+
     @property
     def envp(self) -> Dict[str, str]:
         """
         Environment vector.
         """
         ...
+
     @property
     def identifier(self) -> str:
         """
         Application identifier.
         """
         ...
+
     @property
     def origin(self) -> str:
         """
         Origin.
         """
         ...
+
     @property
     def parent_pid(self) -> int:
         """
         Parent Process ID.
         """
         ...
+
     @property
     def path(self) -> str:
         """
         Path of executable.
         """
         ...
+
     @property
     def pid(self) -> int:
         """
@@ -171,24 +191,28 @@ class Crash(Object):
         Parameters.
         """
         ...
+
     @property
     def pid(self) -> int:
         """
         Process ID.
         """
         ...
+
     @property
     def process_name(self) -> str:
         """
         Process name.
         """
         ...
+
     @property
     def report(self) -> str:
         """
         Human-readable crash report.
         """
         ...
+
     @property
     def summary(self) -> str:
         """
@@ -203,45 +227,53 @@ class Device(Object):
         Device ID.
         """
         ...
+
     @property
     def name(self) -> Optional[str]:
         """
         Human-readable device name.
         """
         ...
+
     @property
     def icon(self) -> Optional[Any]:
         """
         Icon.
         """
         ...
+
     @property
     def type(self) -> Optional[str]:
         """
         Device type. One of: local, remote, usb.
         """
         ...
+
     @property
     def bus(self) -> Optional[Bus]:
         """
         Message bus.
         """
         ...
+
     def attach(self, pid: int, realm: Optional[str] = None, persist_timeout: Optional[int] = None) -> "Session":
         """
         Attach to a PID.
         """
         ...
+
     def disable_spawn_gating(self) -> None:
         """
         Disable spawn gating.
         """
         ...
+
     def enable_spawn_gating(self) -> None:
         """
         Enable spawn gating.
         """
         ...
+
     def enumerate_applications(
         self, identifiers: Optional[Sequence[str]] = None, scope: Optional[str] = None
     ) -> List[Application]:
@@ -249,71 +281,91 @@ class Device(Object):
         Enumerate applications.
         """
         ...
+
     def enumerate_pending_children(self) -> List[Child]:
         """
         Enumerate pending children.
         """
         ...
+
     def enumerate_pending_spawn(self) -> List["Spawn"]:
         """
         Enumerate pending spawn.
         """
         ...
+
     def enumerate_processes(self, pids: Optional[Sequence[int]] = None, scope: Optional[str] = None) -> List[Process]:
         """
         Enumerate processes.
         """
         ...
+
     def get_frontmost_application(self, scope: Optional[str] = None) -> Optional[Application]:
         """
         Get details about the frontmost application.
         """
         ...
+
     def inject_library_blob(self, pid: int, blob_buffer: bytes, entrypoint: str, data: str) -> int:
         """
         Inject a library blob to a PID.
         """
         ...
+
     def inject_library_file(self, pid: int, path: str, entrypoint: str, data: str) -> int:
         """
         Inject a library file to a PID.
         """
         ...
+
     def input(self, pid: int, data: bytes) -> None:
         """
         Input data on stdin of a spawned process.
         """
         ...
+
     def is_lost(self) -> bool:
         """
         Query whether the device has been lost.
         """
         ...
+
     def kill(self, pid: int) -> None:
         """
         Kill a PID.
         """
         ...
+
     def open_channel(self, address: str) -> "IOStream":
         """
         Open a device-specific communication channel.
         """
         ...
+
+    def open_service(self, address: str) -> Service:
+        """
+        Open a device-specific service.
+        """
+        ...
+
     def unpair(self) -> None:
         """
         Unpair device.
         """
         ...
+
     def query_system_parameters(self) -> Dict[str, Any]:
         """
         Returns a dictionary of information about the host system.
         """
         ...
+
     def resume(self, pid: int) -> None:
         """
         Resume a process from the attachable state.
         """
         ...
+
     def spawn(
         self,
         program: str,
@@ -342,21 +394,25 @@ class DeviceManager(Object):
         Add a remote device.
         """
         ...
+
     def close(self) -> None:
         """
         Close the device manager.
         """
         ...
+
     def enumerate_devices(self) -> List[Device]:
         """
         Enumerate devices.
         """
         ...
+
     def get_device_matching(self, predicate: Callable[[Device], bool], timeout: int) -> Device:
         """
         Get device matching predicate.
         """
         ...
+
     def remove_remote_device(self, address: str) -> None:
         """
         Remove a remote device.
@@ -371,6 +427,7 @@ class FileMonitor(Object):
         Disable the file monitor.
         """
         ...
+
     def enable(self) -> None:
         """
         Enable the file monitor.
@@ -383,26 +440,31 @@ class IOStream(Object):
         Close the stream.
         """
         ...
+
     def is_closed(self) -> bool:
         """
         Query whether the stream is closed.
         """
         ...
+
     def read(self, size: int) -> bytes:
         """
         Read up to the specified number of bytes from the stream.
         """
         ...
+
     def read_all(self, size: int) -> bytes:
         """
         Read exactly the specified number of bytes from the stream.
         """
         ...
+
     def write(self, data: bytes) -> int:
         """
         Write as much as possible of the provided data to the stream.
         """
         ...
+
     def write_all(self, data: bytes) -> None:
         """
         Write all of the provided data to the stream.
@@ -423,46 +485,55 @@ class PortalService(Object):
         Device for in-process control.
         """
         ...
+
     def broadcast(self, message: str, data: Optional[Union[str, bytes]] = None) -> None:
         """
         Broadcast a message to all control channels.
         """
         ...
+
     def enumerate_tags(self, connection_id: int) -> List[str]:
         """
         Enumerate tags of a specific connection.
         """
         ...
+
     def kick(self, connection_id: int) -> None:
         """
         Kick out a specific connection.
         """
         ...
+
     def narrowcast(self, tag: str, message: str, data: Optional[Union[str, bytes]] = None) -> None:
         """
         Post a message to control channels with a specific tag.
         """
         ...
+
     def post(self, connection_id: int, message: str, data: Optional[Union[str, bytes]] = None) -> None:
         """
         Post a message to a specific control channel.
         """
         ...
+
     def start(self) -> None:
         """
         Start listening for incoming connections.
         """
         ...
+
     def stop(self) -> None:
         """
         Stop listening for incoming connections, and kick any connected clients.
         """
         ...
+
     def tag(self, connection_id: int, tag: str) -> None:
         """
         Tag a specific control channel.
         """
         ...
+
     def untag(self, connection_id: int, tag: str) -> None:
         """
         Untag a specific control channel.
@@ -476,12 +547,14 @@ class Process(Object):
         Process ID.
         """
         ...
+
     @property
     def name(self) -> str:
         """
         Human-readable process name.
         """
         ...
+
     @property
     def parameters(self) -> Dict[str, Any]:
         """
@@ -497,18 +570,21 @@ class Relay(Object):
         Network address or address:port of the TURN server.
         """
         ...
+
     @property
     def kind(self) -> str:
         """
         Relay kind. One of: turn-udp, turn-tcp, turn-tls.
         """
         ...
+
     @property
     def password(self) -> str:
         """
         The TURN password to use for the allocate request.
         """
         ...
+
     @property
     def username(self) -> str:
         """
@@ -522,37 +598,62 @@ class Script(Object):
         Eternalize the script.
         """
         ...
+
     def is_destroyed(self) -> bool:
         """
         Query whether the script has been destroyed.
         """
         ...
+
     def load(self) -> None:
         """
         Load the script.
         """
         ...
+
     def post(self, message: str, data: Optional[Union[str, bytes]] = None) -> None:
         """
         Post a JSON-encoded message to the script.
         """
         ...
+
     def unload(self) -> None:
         """
         Unload the script.
         """
         ...
+
     def enable_debugger(self, port: Optional[int]) -> None:
         """
         Enable the Node.js compatible script debugger
         """
         ...
+
     def disable_debugger(self) -> None:
         """
         Disable the Node.js compatible script debugger
         """
         ...
 
+class Service(Object):
+    def activate(self) -> None:
+        """
+        Activate the service.
+        """
+        ...
+
+    def cancel(self) -> None:
+        """
+        Cancel the service.
+        """
+        ...
+
+    def request(self, parameters: Any) -> Any:
+        """
+        Perform a request.
+        """
+        ...
+
 class Session(Object):
     @property
     def pid(self) -> int:
@@ -560,16 +661,19 @@ class Session(Object):
         Process ID.
         """
         ...
+
     def compile_script(self, source: str, name: Optional[str] = None, runtime: Optional[str] = None) -> bytes:
         """
         Compile script source code to bytecode.
         """
         ...
+
     def create_script(self, source: str, name: Optional[str] = None, runtime: Optional[str] = None) -> Script:
         """
         Create a new script.
         """
         ...
+
     def create_script_from_bytes(
         self, data: bytes, name: Optional[str] = None, runtime: Optional[str] = None
     ) -> Script:
@@ -577,31 +681,37 @@ class Session(Object):
         Create a new script from bytecode.
         """
         ...
+
     def snapshot_script(self, embed_script: str, warmup_script: Optional[str], runtime: Optional[str] = None) -> bytes:
         """
         Evaluate script and snapshot the resulting VM state
         """
         ...
+
     def detach(self) -> None:
         """
         Detach session from the process.
         """
         ...
+
     def disable_child_gating(self) -> None:
         """
         Disable child gating.
         """
         ...
+
     def enable_child_gating(self) -> None:
         """
         Enable child gating.
         """
         ...
+
     def is_detached(self) -> bool:
         """
         Query whether the session is detached.
         """
         ...
+
     def join_portal(
         self, address: str, certificate: Optional[str] = None, token: Optional[str] = None, acl: Optional[Any] = None
     ) -> PortalMembership:
@@ -609,11 +719,13 @@ class Session(Object):
         Join a portal.
         """
         ...
+
     def resume(self) -> None:
         """
         Resume session after network error.
         """
         ...
+
     def setup_peer_connection(
         self, stun_server: Optional[str] = None, relays: Optional[Sequence[Relay]] = None
     ) -> None:
@@ -629,6 +741,7 @@ class Spawn(Object):
         Application identifier.
         """
         ...
+
     @property
     def pid(self) -> int:
         """
@@ -641,23 +754,124 @@ class Compiler(Object):
         self,
         entrypoint: str,
         project_root: Optional[str] = None,
+        output_format: Optional[str] = None,
+        bundle_format: Optional[str] = None,
+        type_check: Optional[str] = None,
         source_maps: Optional[str] = None,
         compression: Optional[str] = None,
+        platform: Optional[str] = None,
+        externals: Optional[Sequence[str]] = None,
     ) -> str:
         """
         Build an agent.
         """
         ...
+
     def watch(
         self,
         entrypoint: str,
         project_root: Optional[str] = None,
+        output_format: Optional[str] = None,
+        bundle_format: Optional[str] = None,
+        type_check: Optional[str] = None,
         source_maps: Optional[str] = None,
         compression: Optional[str] = None,
+        platform: Optional[str] = None,
+        externals: Optional[Sequence[str]] = None,
     ) -> None:
         """
         Continuously build an agent.
         """
         ...
 
+class PackageManager(Object):
+    @property
+    def registry(self) -> str:
+        """
+        The registry being used.
+        """
+        ...
+
+    @registry.setter
+    def registry(self, value: str) -> None:
+        """
+        Change the registry to use.
+        """
+        ...
+
+    def search(
+        self,
+        query: str,
+        offset: Optional[int] = None,
+        limit: Optional[int] = None,
+    ) -> PackageSearchResult:
+        """
+        Search for packages to install.
+        """
+        ...
+
+    def install(
+        self,
+        project_root: Optional[str] = None,
+        role: Optional[str] = None,
+        specs: Optional[Sequence[str]] = None,
+        omits: Optional[Sequence[str]] = None,
+    ) -> PackageInstallResult:
+        """
+        Install one or more packages.
+        """
+        ...
+
+class Package(Object):
+    @property
+    def name(self) -> str:
+        """
+        Package name.
+        """
+        ...
+
+    @property
+    def version(self) -> str:
+        """
+        Package version.
+        """
+        ...
+
+    @property
+    def description(self) -> Optional[str]:
+        """
+        Package description.
+        """
+        ...
+
+    @property
+    def url(self) -> Optional[str]:
+        """
+        Package URL.
+        """
+        ...
+
+class PackageSearchResult(Object):
+    @property
+    def packages(self) -> List[Package]:
+        """
+        Batch of matching packages.
+        """
+        ...
+
+    @property
+    def total(self) -> int:
+        """
+        Total matching packages.
+        """
+        ...
+
+class PackageInstallResult(Object):
+    @property
+    def packages(self) -> List[Package]:
+        """
+        The toplevel packages that are installed.
+        """
+        ...
+
 __version__: str

frida/_frida/meson.build

@@ -0,0 +1,21 @@
+py_sources = [
+  '__init__.pyi',
+  'py.typed',
+]
+python.install_sources(py_sources, subdir: 'frida' / '_frida', pure: false)
+
+extra_link_args = []
+if host_os_family == 'darwin'
+  extra_link_args += '-Wl,-exported_symbol,_PyInit__frida'
+elif host_os_family != 'windows'
+  extra_link_args += '-Wl,--version-script,' + meson.current_source_dir() / 'extension.version'
+endif
+
+extension = python.extension_module('_frida', 'extension.c',
+  limited_api: '3.7',
+  c_args: frida_component_cflags,
+  link_args: extra_link_args,
+  dependencies: [python_dep, frida_core_dep, os_deps],
+  install: true,
+  subdir: 'frida',
+)

frida/core.py

@@ -33,12 +33,17 @@ if sys.version_info >= (3, 8):
 else:
     from typing_extensions import Literal, TypedDict
 
-if sys.version_info >= (3, 11):
-    from typing import NotRequired
+if sys.version_info >= (3, 10):
+    from typing import ParamSpec
 else:
-    from typing_extensions import NotRequired
+    from typing_extensions import ParamSpec
 
-import _frida
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, cast
+else:
+    from typing_extensions import NotRequired, cast
+
+from . import _frida
 
 _device_manager = None
 
@@ -72,15 +77,18 @@ def _filter_missing_kwargs(d: MutableMapping[Any, Any]) -> None:
             d.pop(key)
 
 
-R = TypeVar("R")
+P = ParamSpec("P")
+R = TypeVar("R", covariant=True)
 
 
-def cancellable(f: Callable[..., R]) -> Callable[..., R]:
+def cancellable(f: Callable[P, R]) -> Callable[P, R]:
+    # currently there is no way to type properly the extended callable with optional cancellable parameter
+    # ref: https://github.com/python/typing/discussions/1905#discussioncomment-11696995
     @functools.wraps(f)
-    def wrapper(*args: Any, **kwargs: Any) -> R:
+    def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:
         cancellable = kwargs.pop("cancellable", None)
         if cancellable is not None:
-            with cancellable:
+            with cast(Cancellable, cancellable):
                 return f(*args, **kwargs)
 
         return f(*args, **kwargs)
@@ -176,7 +184,8 @@ class ScriptExportsSync:
         js_name = _to_camel_case(name)
 
         def method(*args: Any, **kwargs: Any) -> Any:
-            return script._rpc_request("call", js_name, args, **kwargs)
+            request, data = make_rpc_call_request(js_name, args)
+            return script._rpc_request(request, data, **kwargs)
 
         return method
 
@@ -202,7 +211,8 @@ class ScriptExportsAsync:
         js_name = _to_camel_case(name)
 
         async def method(*args: Any, **kwargs: Any) -> Any:
-            return await script._rpc_request_async("call", js_name, args, **kwargs)
+            request, data = make_rpc_call_request(js_name, args)
+            return await script._rpc_request_async(request, data, **kwargs)
 
         return method
 
@@ -210,6 +220,16 @@ class ScriptExportsAsync:
         return self._script.list_exports_sync()
 
 
+def make_rpc_call_request(js_name: str, args: Sequence[Any]) -> Tuple[List[Any], Optional[bytes]]:
+    if args and isinstance(args[-1], bytes):
+        raw_args = args[:-1]
+        data = args[-1]
+    else:
+        raw_args = args
+        data = None
+    return (["call", js_name, raw_args], data)
+
+
 class ScriptErrorMessage(TypedDict):
     type: Literal["error"]
     description: str
@@ -334,16 +354,10 @@ class Script:
         self._impl.disable_debugger()
 
     @overload
-    def on(self, signal: Literal["destroyed"], callback: ScriptDestroyedCallback) -> None:
-        ...
+    def on(self, signal: Literal["destroyed"], callback: ScriptDestroyedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["message"], callback: ScriptMessageCallback) -> None:
-        ...
-
-    @overload
-    def on(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def on(self, signal: Literal["message"], callback: ScriptMessageCallback) -> None: ...
 
     def on(self, signal: str, callback: Callable[..., Any]) -> None:
         """
@@ -356,16 +370,10 @@ class Script:
             self._impl.on(signal, callback)
 
     @overload
-    def off(self, signal: Literal["destroyed"], callback: ScriptDestroyedCallback) -> None:
-        ...
+    def off(self, signal: Literal["destroyed"], callback: ScriptDestroyedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["message"], callback: ScriptMessageCallback) -> None:
-        ...
-
-    @overload
-    def off(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def off(self, signal: Literal["message"], callback: ScriptMessageCallback) -> None: ...
 
     def off(self, signal: str, callback: Callable[..., Any]) -> None:
         """
@@ -410,7 +418,7 @@ class Script:
         Asynchronously list all the exported attributes from the script's rpc
         """
 
-        result = await self._rpc_request_async("list")
+        result = await self._rpc_request_async(["list"])
         assert isinstance(result, list)
         return result
 
@@ -419,7 +427,7 @@ class Script:
         List all the exported attributes from the script's rpc
         """
 
-        result = self._rpc_request("list")
+        result = self._rpc_request(["list"])
         assert isinstance(result, list)
         return result
 
@@ -435,7 +443,7 @@ class Script:
         )
         return self.list_exports_sync()
 
-    def _rpc_request_async(self, *args: Any) -> asyncio.Future[Any]:
+    def _rpc_request_async(self, args: Any, data: Optional[bytes] = None) -> asyncio.Future[Any]:
         loop = asyncio.get_event_loop()
         future: asyncio.Future[Any] = asyncio.Future()
 
@@ -448,14 +456,14 @@ class Script:
         request_id = self._append_pending(on_complete)
 
         if not self.is_destroyed:
-            self._send_rpc_call(request_id, *args)
+            self._send_rpc_call(request_id, args, data)
         else:
             self._on_destroyed()
 
         return future
 
     @cancellable
-    def _rpc_request(self, *args: Any) -> Any:
+    def _rpc_request(self, args: Any, data: Optional[bytes] = None) -> Any:
         result = RPCResult()
 
         def on_complete(value: Any, error: Optional[Union[RPCException, _frida.InvalidOperationError]]) -> None:
@@ -472,7 +480,7 @@ class Script:
         request_id = self._append_pending(on_complete)
 
         if not self.is_destroyed:
-            self._send_rpc_call(request_id, *args)
+            self._send_rpc_call(request_id, args, data)
 
             cancellable = Cancellable.get_current()
             cancel_handler = cancellable.connect(on_cancelled)
@@ -501,10 +509,8 @@ class Script:
             self._pending[request_id] = callback
         return request_id
 
-    def _send_rpc_call(self, request_id: int, *args: Any) -> None:
-        message = ["frida:rpc", request_id]
-        message.extend(args)
-        self.post(message)
+    def _send_rpc_call(self, request_id: int, args: Any, data: Optional[bytes]) -> None:
+        self.post(["frida:rpc", request_id, *args], data)
 
     def _on_rpc_message(self, request_id: int, operation: str, params: List[Any], data: Optional[Any]) -> None:
         if operation in ("ok", "error"):
@@ -515,7 +521,10 @@ class Script:
             value = None
             error = None
             if operation == "ok":
-                value = params[0] if data is None else data
+                if data is not None:
+                    value = (params[1], data) if len(params) > 1 else data
+                else:
+                    value = params[0]
             else:
                 error = RPCException(*params[0:3])
 
@@ -686,38 +695,22 @@ class Session:
         _filter_missing_kwargs(kwargs)
         return PortalMembership(self._impl.join_portal(address, **kwargs))
 
-    @overload
     def on(
         self,
         signal: Literal["detached"],
         callback: SessionDetachedCallback,
     ) -> None:
-        ...
-
-    @overload
-    def on(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
-
-    def on(self, signal: str, callback: Callable[..., Any]) -> None:
         """
         Add a signal handler
         """
 
         self._impl.on(signal, callback)
 
-    @overload
     def off(
         self,
         signal: Literal["detached"],
         callback: SessionDetachedCallback,
     ) -> None:
-        ...
-
-    @overload
-    def off(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
-
-    def off(self, signal: str, callback: Callable[..., Any]) -> None:
         """
         Remove a signal handler
         """
@@ -755,16 +748,10 @@ class Bus:
         self._impl.post(raw_message, **kwargs)
 
     @overload
-    def on(self, signal: Literal["detached"], callback: BusDetachedCallback) -> None:
-        ...
+    def on(self, signal: Literal["detached"], callback: BusDetachedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["message"], callback: BusMessageCallback) -> None:
-        ...
-
-    @overload
-    def on(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def on(self, signal: Literal["message"], callback: BusMessageCallback) -> None: ...
 
     def on(self, signal: str, callback: Callable[..., Any]) -> None:
         """
@@ -777,16 +764,10 @@ class Bus:
             self._impl.on(signal, callback)
 
     @overload
-    def off(self, signal: Literal["detached"], callback: BusDetachedCallback) -> None:
-        ...
+    def off(self, signal: Literal["detached"], callback: BusDetachedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["message"], callback: BusMessageCallback) -> None:
-        ...
-
-    @overload
-    def off(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def off(self, signal: Literal["message"], callback: BusMessageCallback) -> None: ...
 
     def off(self, signal: str, callback: Callable[..., Any]) -> None:
         """
@@ -808,6 +789,64 @@ class Bus:
                 traceback.print_exc()
 
 
+ServiceCloseCallback = Callable[[], None]
+ServiceMessageCallback = Callable[[Any], None]
+
+
+class Service:
+    def __init__(self, impl: _frida.Service) -> None:
+        self._impl = impl
+
+    @cancellable
+    def activate(self) -> None:
+        """
+        Activate the service
+        """
+
+        self._impl.activate()
+
+    @cancellable
+    def cancel(self) -> None:
+        """
+        Cancel the service
+        """
+
+        self._impl.cancel()
+
+    def request(self, parameters: Any) -> Any:
+        """
+        Perform a request
+        """
+
+        return self._impl.request(parameters)
+
+    @overload
+    def on(self, signal: Literal["close"], callback: ServiceCloseCallback) -> None: ...
+
+    @overload
+    def on(self, signal: Literal["message"], callback: ServiceMessageCallback) -> None: ...
+
+    def on(self, signal: str, callback: Callable[..., Any]) -> None:
+        """
+        Add a signal handler
+        """
+
+        self._impl.on(signal, callback)
+
+    @overload
+    def off(self, signal: Literal["close"], callback: ServiceCloseCallback) -> None: ...
+
+    @overload
+    def off(self, signal: Literal["message"], callback: ServiceMessageCallback) -> None: ...
+
+    def off(self, signal: str, callback: Callable[..., Any]) -> None:
+        """
+        Remove a signal handler
+        """
+
+        self._impl.off(signal, callback)
+
+
 DeviceSpawnAddedCallback = Callable[[_frida.Spawn], None]
 DeviceSpawnRemovedCallback = Callable[[_frida.Spawn], None]
 DeviceChildAddedCallback = Callable[[_frida.Child], None]
@@ -844,6 +883,14 @@ class Device:
 
         return self._impl.is_lost()
 
+    @cancellable
+    def override_option(self, name: str, value: Any) -> None:
+        """
+        Override a backend-specific option
+        """
+
+        self._impl.override_option(name, value)
+
     @cancellable
     def query_system_parameters(self) -> Dict[str, Any]:
         """
@@ -1035,6 +1082,14 @@ class Device:
 
         return IOStream(self._impl.open_channel(address))
 
+    @cancellable
+    def open_service(self, address: str) -> Service:
+        """
+        Open a device-specific service
+        """
+
+        return Service(self._impl.open_service(address))
+
     @cancellable
     def unpair(self) -> None:
         """
@@ -1052,40 +1107,28 @@ class Device:
         return self.bus
 
     @overload
-    def on(self, signal: Literal["spawn-added"], callback: DeviceSpawnAddedCallback) -> None:
-        ...
+    def on(self, signal: Literal["spawn-added"], callback: DeviceSpawnAddedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["spawn-removed"], callback: DeviceSpawnRemovedCallback) -> None:
-        ...
+    def on(self, signal: Literal["spawn-removed"], callback: DeviceSpawnRemovedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["child-added"], callback: DeviceChildAddedCallback) -> None:
-        ...
+    def on(self, signal: Literal["child-added"], callback: DeviceChildAddedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["child-removed"], callback: DeviceChildRemovedCallback) -> None:
-        ...
+    def on(self, signal: Literal["child-removed"], callback: DeviceChildRemovedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["process-crashed"], callback: DeviceProcessCrashedCallback) -> None:
-        ...
+    def on(self, signal: Literal["process-crashed"], callback: DeviceProcessCrashedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["output"], callback: DeviceOutputCallback) -> None:
-        ...
+    def on(self, signal: Literal["output"], callback: DeviceOutputCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["uninjected"], callback: DeviceUninjectedCallback) -> None:
-        ...
+    def on(self, signal: Literal["uninjected"], callback: DeviceUninjectedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["lost"], callback: DeviceLostCallback) -> None:
-        ...
-
-    @overload
-    def on(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def on(self, signal: Literal["lost"], callback: DeviceLostCallback) -> None: ...
 
     def on(self, signal: str, callback: Callable[..., Any]) -> None:
         """
@@ -1095,40 +1138,28 @@ class Device:
         self._impl.on(signal, callback)
 
     @overload
-    def off(self, signal: Literal["spawn-added"], callback: DeviceSpawnAddedCallback) -> None:
-        ...
+    def off(self, signal: Literal["spawn-added"], callback: DeviceSpawnAddedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["spawn-removed"], callback: DeviceSpawnRemovedCallback) -> None:
-        ...
+    def off(self, signal: Literal["spawn-removed"], callback: DeviceSpawnRemovedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["child-added"], callback: DeviceChildAddedCallback) -> None:
-        ...
+    def off(self, signal: Literal["child-added"], callback: DeviceChildAddedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["child-removed"], callback: DeviceChildRemovedCallback) -> None:
-        ...
+    def off(self, signal: Literal["child-removed"], callback: DeviceChildRemovedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["process-crashed"], callback: DeviceProcessCrashedCallback) -> None:
-        ...
+    def off(self, signal: Literal["process-crashed"], callback: DeviceProcessCrashedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["output"], callback: DeviceOutputCallback) -> None:
-        ...
+    def off(self, signal: Literal["output"], callback: DeviceOutputCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["uninjected"], callback: DeviceUninjectedCallback) -> None:
-        ...
+    def off(self, signal: Literal["uninjected"], callback: DeviceUninjectedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["lost"], callback: DeviceLostCallback) -> None:
-        ...
-
-    @overload
-    def off(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def off(self, signal: Literal["lost"], callback: DeviceLostCallback) -> None: ...
 
     def off(self, signal: str, callback: Callable[..., Any]) -> None:
         """
@@ -1239,20 +1270,13 @@ class DeviceManager:
         self._impl.remove_remote_device(address=address)
 
     @overload
-    def on(self, signal: Literal["added"], callback: DeviceManagerAddedCallback) -> None:
-        ...
+    def on(self, signal: Literal["added"], callback: DeviceManagerAddedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["removed"], callback: DeviceManagerRemovedCallback) -> None:
-        ...
+    def on(self, signal: Literal["removed"], callback: DeviceManagerRemovedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["changed"], callback: DeviceManagerChangedCallback) -> None:
-        ...
-
-    @overload
-    def on(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def on(self, signal: Literal["changed"], callback: DeviceManagerChangedCallback) -> None: ...
 
     def on(self, signal: str, callback: Callable[..., Any]) -> None:
         """
@@ -1262,20 +1286,13 @@ class DeviceManager:
         self._impl.on(signal, callback)
 
     @overload
-    def off(self, signal: Literal["added"], callback: DeviceManagerAddedCallback) -> None:
-        ...
+    def off(self, signal: Literal["added"], callback: DeviceManagerAddedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["removed"], callback: DeviceManagerRemovedCallback) -> None:
-        ...
+    def off(self, signal: Literal["removed"], callback: DeviceManagerRemovedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["changed"], callback: DeviceManagerChangedCallback) -> None:
-        ...
-
-    @overload
-    def off(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def off(self, signal: Literal["changed"], callback: DeviceManagerChangedCallback) -> None: ...
 
     def off(self, signal: str, callback: Callable[..., Any]) -> None:
         """
@@ -1301,7 +1318,7 @@ class EndpointParameters:
         _filter_missing_kwargs(kwargs)
 
         if authentication is not None:
-            (auth_scheme, auth_data) = authentication
+            auth_scheme, auth_data = authentication
             if auth_scheme == "token":
                 kwargs["auth_token"] = auth_data
             elif auth_scheme == "callback":
@@ -1417,46 +1434,35 @@ class PortalService:
         self._impl.untag(connection_id, tag)
 
     @overload
-    def on(self, signal: Literal["node-joined"], callback: PortalServiceNodeJoinedCallback) -> None:
-        ...
+    def on(self, signal: Literal["node-joined"], callback: PortalServiceNodeJoinedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["node-left"], callback: PortalServiceNodeLeftCallback) -> None:
-        ...
+    def on(self, signal: Literal["node-left"], callback: PortalServiceNodeLeftCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["controller-connected"], callback: PortalServiceControllerConnectedCallback) -> None:
-        ...
+    def on(
+        self, signal: Literal["controller-connected"], callback: PortalServiceControllerConnectedCallback
+    ) -> None: ...
 
     @overload
     def on(
         self, signal: Literal["controller-disconnected"], callback: PortalServiceControllerDisconnectedCallback
-    ) -> None:
-        ...
+    ) -> None: ...
 
     @overload
-    def on(self, signal: Literal["node-connected"], callback: PortalServiceNodeConnectedCallback) -> None:
-        ...
+    def on(self, signal: Literal["node-connected"], callback: PortalServiceNodeConnectedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["node-disconnected"], callback: PortalServiceNodeDisconnectedCallback) -> None:
-        ...
+    def on(self, signal: Literal["node-disconnected"], callback: PortalServiceNodeDisconnectedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["authenticated"], callback: PortalServiceAuthenticatedCallback) -> None:
-        ...
+    def on(self, signal: Literal["authenticated"], callback: PortalServiceAuthenticatedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["subscribe"], callback: PortalServiceSubscribeCallback) -> None:
-        ...
+    def on(self, signal: Literal["subscribe"], callback: PortalServiceSubscribeCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["message"], callback: PortalServiceMessageCallback) -> None:
-        ...
-
-    @overload
-    def on(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def on(self, signal: Literal["message"], callback: PortalServiceMessageCallback) -> None: ...
 
     def on(self, signal: str, callback: Callable[..., Any]) -> None:
         """
@@ -1519,10 +1525,17 @@ CompilerFinishedCallback = Callable[[], None]
 CompilerOutputCallback = Callable[[str], None]
 CompilerDiagnosticsCallback = Callable[[List[CompilerDiagnostic]], None]
 
+CompilerOutputFormat = Literal["unescaped", "hex-bytes", "c-string"]
+CompilerBundleFormat = Literal["esm", "iife"]
+CompilerTypeCheck = Literal["full", "none"]
+CompilerSourceMaps = Literal["included", "omitted"]
+CompilerCompression = Literal["none", "terser"]
+CompilerPlatform = Literal["neutral", "gum", "browser"]
+
 
 class Compiler:
     def __init__(self) -> None:
-        self._impl = _frida.Compiler(get_device_manager()._impl)
+        self._impl = _frida.Compiler()
 
     def __repr__(self) -> str:
         return repr(self._impl)
@@ -1532,10 +1545,24 @@ class Compiler:
         self,
         entrypoint: str,
         project_root: Optional[str] = None,
-        source_maps: Optional[str] = None,
-        compression: Optional[str] = None,
+        output_format: Optional[CompilerOutputFormat] = None,
+        bundle_format: Optional[CompilerBundleFormat] = None,
+        type_check: Optional[CompilerTypeCheck] = None,
+        source_maps: Optional[CompilerSourceMaps] = None,
+        compression: Optional[CompilerCompression] = None,
+        platform: Optional[CompilerPlatform] = None,
+        externals: Optional[Sequence[str]] = None,
     ) -> str:
-        kwargs = {"project_root": project_root, "source_maps": source_maps, "compression": compression}
+        kwargs: dict[str, Any] = {
+            "project_root": project_root,
+            "output_format": output_format,
+            "bundle_format": bundle_format,
+            "type_check": type_check,
+            "source_maps": source_maps,
+            "compression": compression,
+            "platform": platform,
+            "externals": externals,
+        }
         _filter_missing_kwargs(kwargs)
         return self._impl.build(entrypoint, **kwargs)
 
@@ -1544,57 +1571,138 @@ class Compiler:
         self,
         entrypoint: str,
         project_root: Optional[str] = None,
-        source_maps: Optional[str] = None,
-        compression: Optional[str] = None,
+        output_format: Optional[CompilerOutputFormat] = None,
+        bundle_format: Optional[CompilerBundleFormat] = None,
+        type_check: Optional[CompilerTypeCheck] = None,
+        source_maps: Optional[CompilerSourceMaps] = None,
+        compression: Optional[CompilerCompression] = None,
+        platform: Optional[CompilerPlatform] = None,
+        externals: Optional[Sequence[str]] = None,
     ) -> None:
-        kwargs = {"project_root": project_root, "source_maps": source_maps, "compression": compression}
+        kwargs: dict[str, Any] = {
+            "project_root": project_root,
+            "output_format": output_format,
+            "bundle_format": bundle_format,
+            "type_check": type_check,
+            "source_maps": source_maps,
+            "compression": compression,
+            "platform": platform,
+            "externals": externals,
+        }
         _filter_missing_kwargs(kwargs)
         return self._impl.watch(entrypoint, **kwargs)
 
     @overload
-    def on(self, signal: Literal["starting"], callback: CompilerStartingCallback) -> None:
-        ...
+    def on(self, signal: Literal["starting"], callback: CompilerStartingCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["finished"], callback: CompilerFinishedCallback) -> None:
-        ...
+    def on(self, signal: Literal["finished"], callback: CompilerFinishedCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["output"], callback: CompilerOutputCallback) -> None:
-        ...
+    def on(self, signal: Literal["output"], callback: CompilerOutputCallback) -> None: ...
 
     @overload
-    def on(self, signal: Literal["diagnostics"], callback: CompilerDiagnosticsCallback) -> None:
-        ...
-
-    @overload
-    def on(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def on(self, signal: Literal["diagnostics"], callback: CompilerDiagnosticsCallback) -> None: ...
 
     def on(self, signal: str, callback: Callable[..., Any]) -> None:
+        """
+        Add a signal handler
+        """
+
         self._impl.on(signal, callback)
 
     @overload
-    def off(self, signal: Literal["starting"], callback: CompilerStartingCallback) -> None:
-        ...
+    def off(self, signal: Literal["starting"], callback: CompilerStartingCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["finished"], callback: CompilerFinishedCallback) -> None:
-        ...
+    def off(self, signal: Literal["finished"], callback: CompilerFinishedCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["output"], callback: CompilerOutputCallback) -> None:
-        ...
+    def off(self, signal: Literal["output"], callback: CompilerOutputCallback) -> None: ...
 
     @overload
-    def off(self, signal: Literal["diagnostics"], callback: CompilerDiagnosticsCallback) -> None:
-        ...
-
-    @overload
-    def off(self, signal: str, callback: Callable[..., Any]) -> None:
-        ...
+    def off(self, signal: Literal["diagnostics"], callback: CompilerDiagnosticsCallback) -> None: ...
 
     def off(self, signal: str, callback: Callable[..., Any]) -> None:
+        """
+        Remove a signal handler
+        """
+
+        self._impl.off(signal, callback)
+
+
+PackageManagerInstallProgressCallback = Callable[
+    [
+        Literal[
+            "initializing",
+            "preparing-dependencies",
+            "resolving-package",
+            "fetching-resource",
+            "package-already-installed",
+            "downloading-package",
+            "package-installed",
+            "resolving-and-installing-all",
+            "complete",
+        ],
+        float,
+        Optional[str],
+    ],
+    None,
+]
+
+PackageRole = Literal["runtime", "development", "optional", "peer"]
+
+
+class PackageManager:
+    def __init__(self) -> None:
+        self._impl = _frida.PackageManager()
+
+    def __repr__(self) -> str:
+        return repr(self._impl)
+
+    @property
+    def registry(self):
+        return self._impl.registry
+
+    @registry.setter
+    def registry(self, value):
+        self._impl.registry = value
+
+    @cancellable
+    def search(
+        self,
+        query: str,
+        offset: Optional[int] = None,
+        limit: Optional[int] = None,
+    ) -> _frida.PackageSearchResult:
+        kwargs = {
+            "offset": offset,
+            "limit": limit,
+        }
+        _filter_missing_kwargs(kwargs)
+        return self._impl.search(query, **kwargs)
+
+    @cancellable
+    def install(
+        self,
+        project_root: Optional[str] = None,
+        role: Optional[PackageRole] = None,
+        specs: Optional[Sequence[str]] = None,
+        omits: Optional[Sequence[PackageRole]] = None,
+    ) -> _frida.PackageInstallResult:
+        kwargs: Dict[str, Any] = {
+            "project_root": project_root,
+            "role": role,
+            "specs": specs,
+            "omits": omits,
+        }
+        _filter_missing_kwargs(kwargs)
+        return self._impl.install(**kwargs)
+
+    def on(self, signal: Literal["install-progress"], callback: PackageManagerInstallProgressCallback) -> None:
+        self._impl.on(signal, callback)
+
+    def off(self, signal: Literal["install-progress"], callback: PackageManagerInstallProgressCallback) -> None:
         self._impl.off(signal, callback)
 
 

frida/meson.build

@@ -1,6 +1,8 @@
-frida_sources = [
+subdir('_frida')
+
+py_sources = [
   '__init__.py',
   'core.py',
+  'py.typed',
 ]
-
-install_data(frida_sources, install_dir: join_paths(python_site_packages, 'frida'))
+python.install_sources(py_sources, subdir: 'frida', pure: false)

make.bat

@@ -0,0 +1,23 @@
+@setlocal
+@echo off
+rem:: Based on: https://github.com/microsoft/terminal/issues/217#issuecomment-737594785
+goto :_start_
+
+:set_real_dp0
+set dp0=%~dp0
+set "dp0=%dp0:~0,-1%"
+goto :eof
+
+:_start_
+call :set_real_dp0
+
+if not exist "%dp0%\releng\meson\meson.py" (
+  pushd "%dp0%" & git submodule update --init --recursive --depth 1 & popd
+  if %errorlevel% neq 0 exit /b %errorlevel%
+)
+
+endlocal & goto #_undefined_# 2>nul || title %COMSPEC% & python ^
+    -c "import sys; sys.path.insert(0, sys.argv[1]); from releng.meson_make import main; main()" ^
+    "%dp0%" ^
+    .\build ^
+    %*

meson.build

@@ -1,11 +1,11 @@
-project('frida-python', 'c', version: '1.0.0')
+project('frida-python', 'c',
+  version: run_command(find_program('python3'), files('setup.py'), '-V',
+    capture: true,
+    check: true).stdout().strip(),
+  meson_version: '>=1.3.0',
+)
 
-host_os = host_machine.system()
-if host_os == 'android'
-  host_os_family = 'linux'
-else
-  host_os_family = host_os
-endif
+python = import('python').find_installation()
 
 cc = meson.get_compiler('c')
 
@@ -19,81 +19,22 @@ if ndebug == 'true' or (ndebug == 'if-release' and not get_option('debug'))
   ]
 endif
 
-target_conditionals_prefix = '#include <TargetConditionals.h>'
+python_dep = python.dependency()
+frida_core_dep = dependency('frida-core-1.0', default_options: [
+  'frida_version=' + meson.project_version().replace('.dev', '-dev.'),
+])
 
-is_macos_src = target_conditionals_prefix + '''
-#if !TARGET_OS_OSX
-# error Not macOS
-#endif
-'''
-if cc.compiles(is_macos_src, name: 'compiling for macOS')
-  host_os = 'macos'
-endif
-
-is_ios_src = target_conditionals_prefix + '''
-#if !TARGET_OS_IOS
-# error Not iOS
-#endif
-'''
-if cc.compiles(is_ios_src, name: 'compiling for iOS')
-  host_os = 'ios'
-endif
-
-if cc.has_header('android/api-level.h')
-  host_os = 'android'
-endif
-
-python_incdir = get_option('python_incdir')
-if python_incdir == ''
-  python = get_option('python')
-  if python == ''
-    python = find_program('python3', required: false)
-    if not python.found()
-      python = find_program('python')
-    endif
-  endif
-
-  result = run_command(python, '-c',
-    'import sys; sys.stdout.write(f"{sys.version_info[0]}.{sys.version_info[1]}")',
-    check: true)
-  python_version = result.stdout()
-  python_name = 'python' + python_version
-
-  result = run_command(python, '-c',
-    'from distutils import sysconfig; import sys; sys.stdout.write(sysconfig.get_python_inc())',
-    check: true)
-  python_incdir = result.stdout()
-else
-  py_major_v = cc.get_define('PY_MAJOR_VERSION',
-    prefix: '#include <patchlevel.h>',
-    args: ['-I' + python_incdir])
-
-  py_minor_v = cc.get_define('PY_MINOR_VERSION',
-    prefix: '#include <patchlevel.h>',
-    args: ['-I' + python_incdir])
-
-  python_version = py_major_v + '.' + py_minor_v
-  python_name = 'python' + python_version
-endif
-
-python_site_packages = join_paths(get_option('libdir'), python_name, 'site-packages')
-
-cdata = configuration_data()
-
-cdata.set('HAVE_' + host_os_family.to_upper(), 1)
-if host_os != host_os_family
-  cdata.set('HAVE_' + host_os.to_upper(), 1)
-endif
-
-frida_core_dep = dependency('frida-core-1.0')
 os_deps = []
+host_os_family = host_machine.system()
 if host_os_family != 'windows'
   os_deps += dependency('gio-unix-2.0')
 endif
 
-configure_file(input: 'config.h.in',
-  output: 'config.h',
-  configuration: cdata)
-
-subdir('src')
 subdir('frida')
+
+test('frida-python', python,
+  args: ['-m', 'unittest', 'discover'],
+  workdir: meson.current_source_dir(),
+  env: {'PYTHONPATH': meson.current_build_dir() / 'src'},
+  timeout: 30,
+)

meson_options.txt

@@ -1,11 +0,0 @@
-option('python',
-  type: 'string',
-  value: '',
-  description: 'Python interpreter to build for'
-)
-
-option('python_incdir',
-  type: 'string',
-  value: '',
-  description: 'Python headers directory to build against'
-)

setup.py

@@ -1,109 +1,25 @@
 import os
 import platform
 import shutil
+import subprocess
+import sys
+from pathlib import Path
+from typing import Iterator
 
 from setuptools import setup
 from setuptools.command.build_ext import build_ext
 from setuptools.extension import Extension
 
-package_dir = os.path.dirname(os.path.realpath(__file__))
-pkg_info = os.path.join(package_dir, "PKG-INFO")
-in_source_package = os.path.isfile(pkg_info)
-if in_source_package:
-    with open(pkg_info, "r", encoding="utf-8") as f:
-        version_line = [line for line in f if line.startswith("Version: ")][0].strip()
-    frida_version = version_line[9:]
-else:
-    frida_version = os.environ.get("FRIDA_VERSION", "0.0.0")
-with open(os.path.join(package_dir, "README.md"), "r", encoding="utf-8") as f:
-    long_description = f.read()
-frida_extension = os.environ.get("FRIDA_EXTENSION", None)
+SOURCE_ROOT = Path(__file__).resolve().parent
+FRIDA_EXTENSION = os.environ.get("FRIDA_EXTENSION", None)
 
 
-class FridaPrebuiltExt(build_ext):
-    def build_extension(self, ext):
-        target = self.get_ext_fullpath(ext.name)
-        target_dir = os.path.dirname(target)
-        os.makedirs(target_dir, exist_ok=True)
-
-        shutil.copyfile(frida_extension, target)
-
-
-class FridaMissingDevkitBuildExt(build_ext):
-    def build_extension(self, ext):
-        raise RuntimeError(
-            "Need frida-core devkit to build from source.\n"
-            "Download one from https://github.com/frida/frida/releases, "
-            "extract it to a directory,\n"
-            "and then add an environment variable named FRIDA_CORE_DEVKIT "
-            "pointing at the directory."
-        )
-
-
-include_dirs = []
-library_dirs = []
-libraries = []
-extra_link_args = []
-
-cmdclass = {}
-if frida_extension is not None:
-    cmdclass["build_ext"] = FridaPrebuiltExt
-else:
-    devkit_dir = os.environ.get("FRIDA_CORE_DEVKIT", None)
-    if devkit_dir is not None:
-        include_dirs += [devkit_dir]
-        library_dirs += [devkit_dir]
-        libraries += ["frida-core"]
-
-        system = platform.system()
-        if system == "Windows":
-            pass
-        elif system == "Darwin":
-            extra_link_args += [
-                "-Wl,-exported_symbol,_PyInit__frida",
-                "-Wl,-dead_strip",
-            ]
-            if "_PYTHON_HOST_PLATFORM" not in os.environ:
-                if platform.machine() == "arm64":
-                    host_arch = "arm64"
-                    macos_req = "11.0"
-                else:
-                    host_arch = "x86_64"
-                    macos_req = "10.9"
-                os.environ["_PYTHON_HOST_PLATFORM"] = f"macosx-{macos_req}-{host_arch}"
-                os.environ["ARCHFLAGS"] = f"-arch {host_arch}"
-                os.environ["MACOSX_DEPLOYMENT_TARGET"] = macos_req
-        else:
-            version_script = os.path.join(package_dir, "src", "_frida.version")
-            if not os.path.exists(version_script):
-                with open(version_script, "w", encoding="utf-8") as f:
-                    f.write(
-                        "\n".join(
-                            [
-                                "{",
-                                "  global:",
-                                "    PyInit__frida;",
-                                "",
-                                "  local:",
-                                "    *;",
-                                "};",
-                            ]
-                        )
-                    )
-            extra_link_args += [
-                f"-Wl,--version-script,{version_script}",
-                "-Wl,--gc-sections",
-            ]
-    else:
-        cmdclass["build_ext"] = FridaMissingDevkitBuildExt
-
-
-if __name__ == "__main__":
+def main():
     setup(
         name="frida",
-        version=frida_version,
+        version=detect_version(),
         description="Dynamic instrumentation toolkit for developers, reverse-engineers, and security researchers",
-        long_description=long_description,
+        long_description=compute_long_description(),
         long_description_content_type="text/markdown",
         author="Frida Developers",
         author_email="oleavr@frida.re",
@@ -134,19 +50,81 @@ if __name__ == "__main__":
             "Topic :: Software Development :: Debuggers",
             "Topic :: Software Development :: Libraries :: Python Modules",
         ],
-        packages=["frida", "_frida"],
-        package_data={"frida": ["py.typed"], "_frida": ["py.typed", "__init__.pyi"]},
+        packages=["frida", "frida._frida"],
+        package_data={"frida": ["py.typed"], "frida._frida": ["py.typed", "__init__.pyi"]},
         ext_modules=[
             Extension(
-                name="_frida",
-                sources=["src/_frida.c"],
-                include_dirs=include_dirs,
-                library_dirs=library_dirs,
-                libraries=libraries,
-                extra_link_args=extra_link_args,
+                name="frida._frida",
+                sources=["frida/_frida/extension.c"],
                 py_limited_api=True,
             )
         ],
-        cmdclass=cmdclass,
+        cmdclass={"build_ext": FridaPrebuiltExt if FRIDA_EXTENSION is not None else FridaDemandBuiltExt},
         zip_safe=False,
     )
+
+
+def detect_version() -> str:
+    pkg_info = SOURCE_ROOT / "PKG-INFO"
+    in_source_package = pkg_info.exists()
+    if in_source_package:
+        version_line = [
+            line for line in pkg_info.read_text(encoding="utf-8").split("\n") if line.startswith("Version: ")
+        ][0].strip()
+        return version_line[9:]
+
+    version = os.environ.get("FRIDA_VERSION")
+    if version is not None:
+        return version
+
+    releng_location = next(enumerate_releng_locations(), None)
+    if releng_location is not None:
+        sys.path.insert(0, str(releng_location.parent))
+        from releng.frida_version import detect
+
+        return detect(SOURCE_ROOT).name.replace("-dev.", ".dev")
+
+    return "0.0.0"
+
+
+def compute_long_description() -> str:
+    return (SOURCE_ROOT / "README.md").read_text(encoding="utf-8")
+
+
+def enumerate_releng_locations() -> Iterator[Path]:
+    val = os.environ.get("MESON_SOURCE_ROOT")
+    if val is not None:
+        parent_releng = Path(val) / "releng"
+        if releng_location_exists(parent_releng):
+            yield parent_releng
+
+    local_releng = SOURCE_ROOT / "releng"
+    if releng_location_exists(local_releng):
+        yield local_releng
+
+
+def releng_location_exists(location: Path) -> bool:
+    return (location / "frida_version.py").exists()
+
+
+class FridaPrebuiltExt(build_ext):
+    def build_extension(self, ext):
+        target = self.get_ext_fullpath(ext.name)
+        Path(target).parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy(FRIDA_EXTENSION, target)
+
+
+class FridaDemandBuiltExt(build_ext):
+    def build_extension(self, ext):
+        make = SOURCE_ROOT / "make.bat" if platform.system() == "Windows" else "make"
+        subprocess.run([make], check=True)
+
+        outputs = [entry for entry in (SOURCE_ROOT / "build" / "frida" / "_frida").glob("_frida.*") if entry.is_file()]
+        assert len(outputs) == 1
+        target = self.get_ext_fullpath(ext.name)
+        Path(target).parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy(outputs[0], target)
+
+
+if __name__ == "__main__":
+    main()

src/meson.build

@@ -1,17 +0,0 @@
-extra_link_args = []
-if host_os_family == 'darwin'
-  extra_link_args += ['-Wl,-exported_symbol,_PyInit__frida']
-elif host_os_family != 'windows'
-  extra_link_args += ['-Wl,--version-script,' + join_paths(meson.current_source_dir(), '_frida.version')]
-endif
-
-extension = shared_module('_frida', '_frida.c',
-  name_prefix: '',
-  name_suffix: 'so',
-  c_args: frida_component_cflags,
-  include_directories: include_directories(python_incdir),
-  link_args: extra_link_args,
-  dependencies: [frida_core_dep] + os_deps,
-  install: true,
-  install_dir: python_site_packages,
-)

subprojects/frida-core.wrap

@@ -0,0 +1,8 @@
+[wrap-git]
+url = https://github.com/frida/frida-core.git
+revision = 17.9.11
+depth = 1
+
+[provide]
+dependency_names = frida-core-1.0
+

tests/test_rpc.py

@@ -31,27 +31,41 @@ class TestRpc(unittest.TestCase):
             name="test-rpc",
             source="""\
 rpc.exports = {
-    add: function (a, b) {
-        var result = a + b;
+    add(a, b) {
+        const result = a + b;
         if (result < 0)
-          throw new Error("No");
+            throw new Error("No");
         return result;
     },
-    sub: function (a, b) {
+    sub(a, b) {
         return a - b;
     },
-    speak: function () {
-        var buf = Memory.allocUtf8String("Yo");
+    speak() {
+        const buf = Memory.allocUtf8String("Yo");
         return Memory.readByteArray(buf, 2);
-    }
+    },
+    speakWithMetadata() {
+        const buf = Memory.allocUtf8String("Yo");
+        return ['soft', Memory.readByteArray(buf, 2)];
+    },
+    processData(val, data) {
+        return { val, dump: hexdump(data, { header: false }) };
+    },
 };
 """,
         )
         script.load()
-        self.assertEqual(script.exports.add(2, 3), 5)
-        self.assertEqual(script.exports.sub(5, 3), 2)
-        self.assertRaises(Exception, lambda: script.exports.add(1, -2))
-        self.assertListEqual([x for x in iter(script.exports.speak())], [0x59, 0x6F])
+        agent = script.exports_sync
+        self.assertEqual(agent.add(2, 3), 5)
+        self.assertEqual(agent.sub(5, 3), 2)
+        self.assertRaises(Exception, lambda: agent.add(1, -2))
+        self.assertEqual(agent.speak(), b"\x59\x6f")
+        meta, data = agent.speak_with_metadata()
+        self.assertEqual(meta, "soft")
+        self.assertEqual(data, b"\x59\x6f")
+        result = agent.process_data(1337, b"\x13\x37")
+        self.assertEqual(result["val"], 1337)
+        self.assertEqual(result["dump"], "00000000  13 37                                            .7")
 
     def test_post_failure(self):
         script = self.session.create_script(
@@ -64,7 +78,7 @@ rpc.exports = {
 """,
         )
         script.load()
-        agent = script.exports
+        agent = script.exports_sync
 
         self.session.detach()
         self.assertRaisesScriptDestroyed(lambda: agent.init())
@@ -82,7 +96,7 @@ rpc.exports = {
 """,
         )
         script.load()
-        agent = script.exports
+        agent = script.exports_sync
 
         def unload_script_after_100ms():
             time.sleep(0.1)
@@ -104,7 +118,7 @@ rpc.exports = {
 """,
         )
         script.load()
-        agent = script.exports
+        agent = script.exports_sync
 
         def terminate_target_after_100ms():
             time.sleep(0.1)
@@ -126,7 +140,7 @@ rpc.exports = {
 """,
         )
         script.load()
-        agent = script.exports
+        agent = script.exports_sync
 
         def cancel_after_100ms():
             time.sleep(0.1)