@testin-official/xagent 0.3.7

package/dist/assets/contracts/public-script.schema.json

@@ -0,0 +1,397 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/public-script.schema.json",
+  "title": "XAgent Public Script v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "steps"],
+  "properties": {
+    "schema_version": {"const": "xagent-script/v1"},
+    "name": {"type": "string", "minLength": 1, "maxLength": 255},
+    "package_id": {"type": "integer", "minimum": 1},
+    "variables": {
+      "type": "object",
+      "propertyNames": {"type": "string", "minLength": 1},
+      "additionalProperties": true
+    },
+    "steps": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 1000,
+      "items": {"$ref": "#/$defs/step"}
+    }
+  },
+  "$defs": {
+    "common": {
+      "type": "object",
+      "properties": {
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "install": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "appPackage"],
+      "properties": {
+        "action": {"const": "install"},
+        "appPackage": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "appLaunch": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action"],
+      "properties": {
+        "action": {"const": "appLaunch"},
+        "appPackage": {"type": "string", "minLength": 1},
+        "appName": {"type": "string", "minLength": 1},
+        "launchPath": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      },
+      "anyOf": [
+        {"required": ["appPackage"]},
+        {"required": ["appName"]}
+      ]
+    },
+    "uninstall": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action"],
+      "properties": {
+        "action": {"const": "uninstall"},
+        "appPackage": {"type": "string", "minLength": 1},
+        "appName": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      },
+      "anyOf": [
+        {"required": ["appPackage"]},
+        {"required": ["appName"]}
+      ]
+    },
+    "click": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "target"],
+      "properties": {
+        "action": {"const": "click"},
+        "target": {"type": "string", "minLength": 1},
+        "type": {"enum": ["click", "tap", "longPress", "doubleClick", "rightClick"]},
+        "duration": {"type": "integer", "minimum": 1, "maximum": 3600000},
+        "description": {"type": "string", "maxLength": 1000}
+      },
+      "allOf": [
+        {
+          "if": {"required": ["duration"]},
+          "then": {
+            "required": ["type"],
+            "properties": {"type": {"const": "longPress"}}
+          }
+        }
+      ]
+    },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "text"],
+      "not": {"required": ["target", "keyboardLayout"]},
+      "properties": {
+        "action": {"const": "input"},
+        "text": {"type": "string"},
+        "target": {"type": "string", "minLength": 1},
+        "clearFirst": {"type": "boolean"},
+        "inputMode": {"enum": ["normal", "smart", "secret"]},
+        "keyboardLayout": {"enum": ["numeric", "alphabetic"]},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "scroll": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "direction"],
+      "properties": {
+        "action": {"const": "scroll"},
+        "direction": {"enum": ["UP", "DOWN", "LEFT", "RIGHT", "up", "down", "left", "right"]},
+        "distance": {"type": "number", "exclusiveMinimum": 0, "maximum": 1},
+        "target": {"type": "string", "minLength": 1},
+        "condition": {"type": "string", "minLength": 1},
+        "maxSwipes": {"type": "integer", "minimum": 1, "maximum": 1000},
+        "scope": {"enum": ["page", "container"]},
+        "containerRole": {"type": "string", "minLength": 1},
+        "containerAnchor": {"type": "string", "minLength": 1},
+        "containerHint": {"type": "string", "minLength": 1},
+        "scrollAreaTarget": {"type": "string", "minLength": 1},
+        "untilScope": {"type": "string", "minLength": 1},
+        "stopMode": {"type": "string", "minLength": 1},
+        "untilMatchMode": {"type": "string", "minLength": 1},
+        "spatialConstraints": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["relation"],
+            "properties": {
+              "anchor": {"type": "string", "minLength": 1},
+              "relation": {"type": "string", "minLength": 1}
+            }
+          }
+        },
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "scroll_between": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "from", "to"],
+      "properties": {
+        "action": {"const": "scroll_between"},
+        "from": {"type": "string", "minLength": 1},
+        "to": {"type": "string", "minLength": 1},
+        "duration": {"type": "integer", "minimum": 1, "maximum": 3600000},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "drag": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "from", "to"],
+      "properties": {
+        "action": {"const": "drag"},
+        "from": {"type": "string", "minLength": 1},
+        "to": {"type": "string", "minLength": 1},
+        "speed": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "screenshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action"],
+      "properties": {
+        "action": {"const": "screenshot"},
+        "var": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "extract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "target", "varName"],
+      "properties": {
+        "action": {"const": "extract"},
+        "target": {"type": "string", "minLength": 1},
+        "varName": {"type": "string", "minLength": 1},
+        "type": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "waitFor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action"],
+      "properties": {
+        "action": {"const": "waitFor"},
+        "time": {"type": "integer", "minimum": 0, "maximum": 3600000},
+        "condition": {"type": "string", "minLength": 1},
+        "timeout": {"type": "integer", "minimum": 1, "maximum": 3600000},
+        "description": {"type": "string", "maxLength": 1000}
+      },
+      "anyOf": [
+        {"required": ["time"]},
+        {"required": ["condition"]}
+      ]
+    },
+    "assert": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action"],
+      "properties": {
+        "action": {"const": "assert"},
+        "condition": {"type": "string", "minLength": 1},
+        "conditionType": {"enum": ["textVisible", "expr"]},
+        "target": {"type": "string", "minLength": 1},
+        "text": {"type": "string"},
+        "message": {"type": "string", "maxLength": 1000},
+        "description": {"type": "string", "maxLength": 1000}
+      },
+      "anyOf": [
+        {"required": ["condition"]},
+        {"required": ["target"]}
+      ]
+    },
+    "if": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "condition", "then"],
+      "properties": {
+        "action": {"const": "if"},
+        "condition": {"type": "string", "minLength": 1},
+        "then": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1000,
+          "items": {"$ref": "#/$defs/step"}
+        },
+        "else": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1000,
+          "items": {"$ref": "#/$defs/step"}
+        },
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "appStop": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action"],
+      "properties": {
+        "action": {"const": "appStop"},
+        "appPackage": {"type": "string", "minLength": 1},
+        "appName": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      },
+      "anyOf": [
+        {"required": ["appPackage"]},
+        {"required": ["appName"]}
+      ]
+    },
+    "appClean": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action"],
+      "properties": {
+        "action": {"const": "appClean"},
+        "appPackage": {"type": "string", "minLength": 1},
+        "appName": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      },
+      "anyOf": [
+        {"required": ["appPackage"]},
+        {"required": ["appName"]}
+      ]
+    },
+    "set": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "varName"],
+      "properties": {
+        "action": {"const": "set"},
+        "varName": {"type": "string", "minLength": 1},
+        "value": true,
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "randomVar": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "varName", "type"],
+      "properties": {
+        "action": {"const": "randomVar"},
+        "varName": {"type": "string", "minLength": 1},
+        "type": {"enum": ["string", "number", "phone", "email"]},
+        "length": {"type": "integer", "minimum": 1, "maximum": 10000},
+        "min": {"type": "integer"},
+        "max": {"type": "integer"},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "for": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "steps"],
+      "properties": {
+        "action": {"const": "for"},
+        "count": {
+          "oneOf": [
+            {"type": "integer", "minimum": 0},
+            {"type": "string", "minLength": 1}
+          ]
+        },
+        "condition": {"type": "string", "minLength": 1},
+        "dead_loop": {"type": "integer", "minimum": 1, "maximum": 10000},
+        "steps": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1000,
+          "items": {"$ref": "#/$defs/step"}
+        },
+        "description": {"type": "string", "maxLength": 1000}
+      },
+      "oneOf": [
+        {"required": ["count"]},
+        {"required": ["condition"]}
+      ]
+    },
+    "throw": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "message"],
+      "properties": {
+        "action": {"const": "throw"},
+        "message": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "break": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action"],
+      "properties": {
+        "action": {"const": "break"},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "press_key": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "key"],
+      "properties": {
+        "action": {"const": "press_key"},
+        "key": {"type": "string", "minLength": 1},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "press_home": {
+      "type": "object", "additionalProperties": false, "required": ["action"],
+      "properties": {"action": {"const": "press_home"}, "description": {"type": "string", "maxLength": 1000}}
+    },
+    "press_back": {
+      "type": "object", "additionalProperties": false, "required": ["action"],
+      "properties": {"action": {"const": "press_back"}, "description": {"type": "string", "maxLength": 1000}}
+    },
+    "press_enter": {
+      "type": "object", "additionalProperties": false, "required": ["action"],
+      "properties": {"action": {"const": "press_enter"}, "description": {"type": "string", "maxLength": 1000}}
+    },
+    "step": {
+      "oneOf": [
+        {"$ref": "#/$defs/install"},
+        {"$ref": "#/$defs/appLaunch"},
+        {"$ref": "#/$defs/uninstall"},
+        {"$ref": "#/$defs/click"},
+        {"$ref": "#/$defs/input"},
+        {"$ref": "#/$defs/scroll"},
+        {"$ref": "#/$defs/scroll_between"},
+        {"$ref": "#/$defs/drag"},
+        {"$ref": "#/$defs/screenshot"},
+        {"$ref": "#/$defs/extract"},
+        {"$ref": "#/$defs/waitFor"},
+        {"$ref": "#/$defs/assert"},
+        {"$ref": "#/$defs/if"},
+        {"$ref": "#/$defs/appStop"},
+        {"$ref": "#/$defs/appClean"},
+        {"$ref": "#/$defs/set"},
+        {"$ref": "#/$defs/randomVar"},
+        {"$ref": "#/$defs/for"},
+        {"$ref": "#/$defs/throw"},
+        {"$ref": "#/$defs/break"},
+        {"$ref": "#/$defs/press_key"},
+        {"$ref": "#/$defs/press_home"},
+        {"$ref": "#/$defs/press_back"},
+        {"$ref": "#/$defs/press_enter"}
+      ]
+    }
+  }
+}

package/dist/assets/contracts/run-create-v2.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/run-create-v2.schema.json",
+  "title": "XAgent Run Create v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "script",
+    "target_name",
+    "target_hash",
+    "target"
+  ],
+  "properties": {
+    "schema_version": {"const": "xagent-run-create/v2"},
+    "script": {"$ref": "public-script.schema.json"},
+    "package_id": {"type": "integer", "minimum": 1},
+    "app_upload_id": {
+      "type": "string",
+      "pattern": "^appup_[a-f0-9]{32}$"
+    },
+    "variables": {"type": "object", "additionalProperties": true},
+    "timeout_ms": {"type": "integer", "minimum": 1000, "maximum": 28800000},
+    "source_hash": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "target_name": {
+      "type": "string",
+      "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
+    },
+    "target_hash": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "target": {"$ref": "execution-target.schema.json"}
+  },
+  "allOf": [
+    {
+      "not": {
+        "anyOf": [
+          {"required": ["package_id", "app_upload_id"]},
+          {
+            "required": ["app_upload_id"],
+            "properties": {
+              "script": {"required": ["package_id"]}
+            }
+          }
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "script": {
+            "properties": {
+              "steps": {
+                "contains": {
+                  "type": "object",
+                  "properties": {"action": {"const": "install"}},
+                  "required": ["action"]
+                }
+              }
+            },
+            "required": ["steps"]
+          }
+        },
+        "required": ["script"]
+      },
+      "then": {
+        "anyOf": [
+          {"required": ["package_id"]},
+          {"required": ["app_upload_id"]},
+          {
+            "properties": {
+              "script": {"required": ["package_id"]}
+            },
+            "required": ["script"]
+          }
+        ]
+      }
+    }
+  ]
+}

package/dist/assets/contracts/run-create.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/run-create.schema.json",
+  "title": "XAgent Run Create v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "script", "device_id"],
+  "properties": {
+    "schema_version": {"const": "xagent-run-create/v1"},
+    "script": {"$ref": "public-script.schema.json"},
+    "package_id": {"type": "integer", "minimum": 1},
+    "app_upload_id": {
+      "type": "string",
+      "pattern": "^appup_[a-f0-9]{32}$"
+    },
+    "device_id": {"type": "string", "minLength": 1, "maxLength": 128},
+    "variables": {"type": "object", "additionalProperties": true},
+    "timeout_ms": {"type": "integer", "minimum": 1000, "maximum": 28800000},
+    "source_hash": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
+  },
+  "allOf": [
+    {
+      "not": {
+        "anyOf": [
+          {"required": ["package_id", "app_upload_id"]},
+          {
+            "required": ["app_upload_id"],
+            "properties": {
+              "script": {"required": ["package_id"]}
+            }
+          }
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "script": {
+            "properties": {
+              "steps": {
+                "contains": {
+                  "type": "object",
+                  "properties": {"action": {"const": "install"}},
+                  "required": ["action"]
+                }
+              }
+            },
+            "required": ["steps"]
+          }
+        },
+        "required": ["script"]
+      },
+      "then": {
+        "if": {
+          "not": {
+            "anyOf": [
+              {"required": ["package_id"]},
+              {"required": ["app_upload_id"]}
+            ]
+          }
+        },
+        "then": {
+            "properties": {
+              "script": {"required": ["package_id"]}
+            }
+        }
+      }
+    }
+  ]
+}