lamda 10.0__tar.gz → 10.2__tar.gz

{lamda-10.0 → lamda-10.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lamda
-Version: 10.0
+Version: 10.2
 Summary: Android reverse engineering & automation framework (Client API)
 Home-page: https://github.com/firerpa/lamda
 Author: rev1si0n
@@ -14,9 +14,9 @@ Classifier: Operating System :: Android
 Classifier: Topic :: Security
 Requires-Python: >=3.6,<=3.14
 License-File: LICENSE
-Requires-Dist: grpcio-tools<=1.74.0,>=1.35.0
+Requires-Dist: grpcio-tools<=1.82.0,>=1.35.0
 Requires-Dist: grpc-interceptor<=0.15.4,>=0.13.0
-Requires-Dist: grpcio<=1.74.0,>=1.35.0
+Requires-Dist: grpcio<=1.82.0,>=1.35.0
 Requires-Dist: cryptography>=35.0.0
 Requires-Dist: msgpack>=1.0.0
 Requires-Dist: asn1crypto<2,>=1.0.0

{lamda-10.0 → lamda-10.2}/README.md

@@ -11,7 +11,7 @@
 
 <h6>An all-in-one Android automation framework that combines on-device services, AI-ready agents, and extensible tool invocation.</h6>
 
-<p align="left"><a href="https://device-farm.com/docs/en/">Documentation</a> | <a href="https://device-farm.com/docs/zh/">使用文档</a> | <a href="https://device-farm.com/contact#telegram">TELEGRAM</a> | <a href="https://device-farm.com/contact#QQ">QQ Group</a> | <a href="https://device-farm.com/contact#WeChat">WeChat</a> | <a href="https://device-farm.com/llms-full.txt">llms-full.txt</a> | <a href="README.zh.md">中文版本</a></p>
+<p align="left"><a href="https://device-farm.com/docs/en/">Documentation</a> | <a href="https://device-farm.com/docs/zh/">使用文档</a> | <a href="https://device-farm.com/contact#telegram">TELEGRAM</a> | <a href="https://device-farm.com/contact#QQ">QQ Group</a> | <a href="https://github.com/firerpa/skills">SKILLS</a> | <a href="https://device-farm.com/llms-full.txt">llms-full.txt</a> | <a href="README.zh.md">中文版本</a></p>
 
 FIRERPA is an **all-in-one Android device control platform**. The server runs directly on the device with **no extra runtime dependencies**; it **supports multiple generations of Android** and works **with or without root**. On the PC side, the Python client library orchestrates UI automation, remote operations, traffic capture, Hook-based reverse engineering, network proxying, distributed networking, AI agents, and **MCP** through a single service and API. Compared with stitching together Appium, mitmproxy, frida-server, adb, uiautomator2, and ad-hoc scripts and ops tools, FIRERPA offers **one source of capabilities, unified configuration, connected workflows, and a stack built for multi-device, long-running, production use**.
 

{lamda-10.0 → lamda-10.2}/lamda/__init__.py

@@ -2,4 +2,4 @@
 #
 # Distributed under MIT license.
 # See file LICENSE for detail or copy at https://opensource.org/licenses/MIT
-__version__ = "10.0"
+__version__ = "10.2"

{lamda-10.0 → lamda-10.2}/lamda/client.py

@@ -11,6 +11,7 @@ import time
 import uuid
 import json
 import base64
+import posixpath
 import hashlib
 import platform
 import warnings
@@ -1183,10 +1184,6 @@ class VirtualDisplayStub(UiAutomatorStub):
     def disable_global_method_warning(self):
         self._warning_global = False
     # Application compat
-    def install_local_file(self, rpath, user=0):
-        self._warning_global_use("install_local_file")
-        return self.device.proxy("Application", display=self.display).install_local_file(
-                                                                        rpath, user=user)
     def enumerate_installed_apps(self, user=0):
         self._warning_global_use("enumerate_installed_apps")
         return self.device.proxy("Application", display=self.display).enumerate_installed_apps(user=user)
@@ -1481,10 +1478,41 @@ class ApplicationOpStub:
                                             name)
 
 
+class ApplicationInstallSession(object):
+    def __init__(self, device, session, tmpdir=None):
+        self.tmpdir  = tmpdir or "/data/local/tmp"
+        self.stub    = device.proxy("Application").stub
+        self.device  = device
+        self.session = session
+    def _write(self, path, name=None, delete=False):
+        req = protos.InstallSessionWriteRequest(session=self.session,
+                                                path=path, name=name,
+                                                delete=delete)
+        return self.stub.installSessionWrite(req)
+    def write(self, path, name=None):
+        suffix = uuid.uuid4().hex[::4]
+        dest = posixpath.join(self.tmpdir, "{}_{}.apk".format(
+                                         self.session, suffix))
+        info = self.device.upload_file(path, dest)
+        self.device.file_chmod(info.path, mode=0o777)
+        return self._write(info.path, name, True)
+    def commit(self, wait=True, timeout=0):
+        req = protos.InstallSessionCommitRequest(session=self.session,
+                                                 wait=wait, timeout=timeout)
+        return self.stub.installSessionCommit(req)
+    def abandon(self):
+        req = protos.InstallSessionAbandonRequest(session=self.session)
+        return self.stub.installSessionAbandon(req).value
+    def status(self):
+        req = protos.InstallSessionQueryRequest(session=self.session)
+        return self.stub.installSessionQuery(req)
+
+
 class ApplicationStub(BaseServiceStub):
-    def __init__(self, *args, display=0, **kwargs):
+    def __init__(self, *args, display=0, device=None, **kwargs):
         super(ApplicationStub, self).__init__(*args, **kwargs)
         self.display = display
+        self.device  = device
     def current_application(self):
         """
         Get the current foreground app info.
@@ -1523,14 +1551,23 @@ class ApplicationStub(BaseServiceStub):
         req.display = self.display
         r = self.stub.startActivity(req)
         return r.value
-    def install_local_file(self, fpath, user=0):
-        """
-        Install an APK from a device path.
-        """
-        req = protos.ApplicationRequest(path=fpath)
-        req.user = user
-        r = self.stub.installFromLocalFile(req)
-        return r
+    def _create_install_session(self, user=0, size_bytes=0, package=None,
+                               installer_package_name=None, dont_kill_app=False,
+        replace_existing=True, allow_test=False, request_downgrade=False,
+        grant_runtime_permissions=False, tmpdir=None):
+        req = protos.InstallSessionCreateRequest(user=user)
+        req.sizeBytes = size_bytes
+        req.dontKillApp = dont_kill_app
+        req.requestDowngrade = request_downgrade
+        req.grantRuntimePermissions = grant_runtime_permissions
+        req.replaceExisting = replace_existing
+        req.allowTest = allow_test
+        req.installerPackageName = installer_package_name or ""
+        req.package = package or ""
+        info = self.stub.installSessionCreate(req)
+        params = dict(device=self.device, session=info.session,
+                                               tmpdir=tmpdir)
+        return ApplicationInstallSession(**params)
     def __call__(self, applicationId, user=0):
         return ApplicationOpStub(self.stub, applicationId,
                                     user=user, display=self.display)
@@ -2444,8 +2481,22 @@ class Device(object):
     def file_stat(self, fpath):
         return self.stub("File").file_stat(fpath)
     # Shortcut: Application
-    def install_local_file(self, rpath, user=0):
-        return self.stub("Application").install_local_file(rpath, user=user)
+    def create_install_session(self, user=0, size_bytes=0, package=None,
+                               installer_package_name=None, dont_kill_app=False,
+        replace_existing=True, allow_test=False, request_downgrade=False,
+        grant_runtime_permissions=False, tmpdir=None):
+        kwargs = dict(user=user)
+        kwargs["size_bytes"] = size_bytes
+        kwargs["package"] = package
+        kwargs["request_downgrade"] = request_downgrade
+        kwargs["grant_runtime_permissions"] = grant_runtime_permissions
+        kwargs["installer_package_name"] = installer_package_name
+        kwargs["dont_kill_app"] = dont_kill_app
+        kwargs["replace_existing"] = replace_existing
+        kwargs["allow_test"] = allow_test
+        kwargs["tmpdir"] = tmpdir
+        proxy = self.proxy("Application", device=self)
+        return proxy._create_install_session(**kwargs)
     def current_application(self):
         return self.stub("Application").current_application()
     def enumerate_installed_apps(self, user=0):

{lamda-10.0 → lamda-10.2}/lamda/google/protobuf/any.proto

@@ -32,12 +32,12 @@ syntax = "proto3";
 
 package google.protobuf;
 
-option csharp_namespace = "Google.Protobuf.WellKnownTypes";
 option go_package = "google.golang.org/protobuf/types/known/anypb";
 option java_package = "com.google.protobuf";
 option java_outer_classname = "AnyProto";
 option java_multiple_files = true;
 option objc_class_prefix = "GPB";
+option csharp_namespace = "Google.Protobuf.WellKnownTypes";
 
 // `Any` contains an arbitrary serialized protocol buffer message along with a
 // URL that describes the type of the serialized message.
@@ -63,6 +63,10 @@ option objc_class_prefix = "GPB";
 //     if (any.is(Foo.class)) {
 //       foo = any.unpack(Foo.class);
 //     }
+//     // or ...
+//     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+//       foo = any.unpack(Foo.getDefaultInstance());
+//     }
 //
 //  Example 3: Pack and unpack a message in Python.
 //
@@ -93,7 +97,6 @@ option objc_class_prefix = "GPB";
 // in the type URL, for example "foo.bar.com/x/y.z" will yield type
 // name "y.z".
 //
-//
 // JSON
 // ====
 // The JSON representation of an `Any` value uses the regular
@@ -146,7 +149,8 @@ message Any {
   //
   // Note: this functionality is not currently available in the official
   // protobuf release, and it is not used for type URLs beginning with
-  // type.googleapis.com.
+  // type.googleapis.com. As of May 2023, there are no widely used type server
+  // implementations and no plans to implement one.
   //
   // Schemes other than `http`, `https` (or the empty scheme) might be
   // used with implementation specific semantics.

{lamda-10.0 → lamda-10.2}/lamda/google/protobuf/api.proto

@@ -35,11 +35,11 @@ package google.protobuf;
 import "google/protobuf/source_context.proto";
 import "google/protobuf/type.proto";
 
-option csharp_namespace = "Google.Protobuf.WellKnownTypes";
 option java_package = "com.google.protobuf";
 option java_outer_classname = "ApiProto";
 option java_multiple_files = true;
 option objc_class_prefix = "GPB";
+option csharp_namespace = "Google.Protobuf.WellKnownTypes";
 option go_package = "google.golang.org/protobuf/types/known/apipb";
 
 // Api is a light-weight descriptor for an API Interface.
@@ -82,7 +82,6 @@ message Api {
   // be omitted. Zero major versions must only be used for
   // experimental, non-GA interfaces.
   //
-  //
   string version = 4;
 
   // Source context for the protocol buffer service represented by this

{lamda-10.0 → lamda-10.2}/lamda/google/protobuf/compiler/plugin.proto

@@ -1,38 +1,12 @@
 // Protocol Buffers - Google's data interchange format
 // Copyright 2008 Google Inc.  All rights reserved.
-// https://developers.google.com/protocol-buffers/
 //
-// Redistribution and use in source and binary forms, with or without
-// modification, are permitted provided that the following conditions are
-// met:
-//
-//     * Redistributions of source code must retain the above copyright
-// notice, this list of conditions and the following disclaimer.
-//     * Redistributions in binary form must reproduce the above
-// copyright notice, this list of conditions and the following disclaimer
-// in the documentation and/or other materials provided with the
-// distribution.
-//     * Neither the name of Google Inc. nor the names of its
-// contributors may be used to endorse or promote products derived from
-// this software without specific prior written permission.
-//
-// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file or at
+// https://developers.google.com/open-source/licenses/bsd
 
 // Author: kenton@google.com (Kenton Varda)
 //
-// WARNING:  The plugin interface is currently EXPERIMENTAL and is subject to
-//   change.
-//
 // protoc (aka the Protocol Compiler) can be extended via plugins.  A plugin is
 // just a program that reads a CodeGeneratorRequest from stdin and writes a
 // CodeGeneratorResponse to stdout.
@@ -50,6 +24,7 @@ package google.protobuf.compiler;
 option java_package = "com.google.protobuf.compiler";
 option java_outer_classname = "PluginProtos";
 
+option csharp_namespace = "Google.Protobuf.Compiler";
 option go_package = "google.golang.org/protobuf/types/pluginpb";
 
 import "google/protobuf/descriptor.proto";
@@ -78,6 +53,11 @@ message CodeGeneratorRequest {
   // they import.  The files will appear in topological order, so each file
   // appears before any file that imports it.
   //
+  // Note: the files listed in files_to_generate will include runtime-retention
+  // options only, but all other files will include source-retention options.
+  // The source_file_descriptors field below is available in case you need
+  // source-retention options for files_to_generate.
+  //
   // protoc guarantees that all proto_files will be written after
   // the fields above, even though this is not technically guaranteed by the
   // protobuf wire format.  This theoretically could allow a plugin to stream
@@ -90,9 +70,13 @@ message CodeGeneratorRequest {
   // fully qualified.
   repeated FileDescriptorProto proto_file = 15;
 
+  // File descriptors with all options, including source-retention options.
+  // These descriptors are only provided for the files listed in
+  // files_to_generate.
+  repeated FileDescriptorProto source_file_descriptors = 17;
+
   // The version number of protocol compiler.
   optional Version compiler_version = 3;
-
 }
 
 // The plugin writes an encoded CodeGeneratorResponse to stdout.
@@ -115,8 +99,21 @@ message CodeGeneratorResponse {
   enum Feature {
     FEATURE_NONE = 0;
     FEATURE_PROTO3_OPTIONAL = 1;
+    FEATURE_SUPPORTS_EDITIONS = 2;
   }
 
+  // The minimum edition this plugin supports.  This will be treated as an
+  // Edition enum, but we want to allow unknown values.  It should be specified
+  // according the edition enum value, *not* the edition number.  Only takes
+  // effect for plugins that have FEATURE_SUPPORTS_EDITIONS set.
+  optional int32 minimum_edition = 3;
+
+  // The maximum edition this plugin supports.  This will be treated as an
+  // Edition enum, but we want to allow unknown values.  It should be specified
+  // according the edition enum value, *not* the edition number.  Only takes
+  // effect for plugins that have FEATURE_SUPPORTS_EDITIONS set.
+  optional int32 maximum_edition = 4;
+
   // Represents a single generated file.
   message File {
     // The file name, relative to the output directory.  The name must not