@testin-official/xagent 0.3.7

package/dist/assets/contracts/authoring-observation.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-observation.schema.json",
+  "title": "XAgent Authoring Observation v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "session_id", "device_id", "screenshot_url", "captured_at"],
+  "properties": {
+    "schema_version": {"const": "xagent-authoring-observation/v1"},
+    "session_id": {"type": "string", "pattern": "^auth_[a-f0-9]{32}$"},
+    "device_id": {"type": "string", "minLength": 1, "maxLength": 255},
+    "screenshot_url": {"type": "string", "format": "uri", "pattern": "^https://"},
+    "captured_at": {"type": "string", "format": "date-time"},
+    "billing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "billable_minutes", "cost", "discount_rate", "started_at", "ended_at"],
+      "properties": {
+        "status": {"enum": ["pending", "submitting", "succeeded", "failed", "unknown"]},
+        "billable_minutes": {"type": "integer", "minimum": 0},
+        "cost": {"type": "integer", "minimum": 0},
+        "discount_rate": {"type": "number", "minimum": 0},
+        "started_at": {"type": ["string", "null"], "format": "date-time"},
+        "ended_at": {"type": ["string", "null"], "format": "date-time"}
+      }
+    }
+  }
+}

package/dist/assets/contracts/authoring-revision-create.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-revision-create.schema.json",
+  "title": "XAgent Authoring Revision Create v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["script", "source", "base_revision_id"],
+  "properties": {
+    "script": {"$ref": "public-script.schema.json"},
+    "source": {"enum": ["user", "agent"]},
+    "base_revision_id": {"type": ["string", "null"], "pattern": "^rev_[a-f0-9]{32}$"}
+  }
+}

package/dist/assets/contracts/authoring-revision.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-revision.schema.json",
+  "title": "XAgent Authoring Revision v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["id", "schema_version", "session_id", "number", "source", "script", "source_hash", "canonical_hash", "created_at"],
+  "properties": {
+    "id": {"type": "string", "pattern": "^rev_[a-f0-9]{32}$"},
+    "schema_version": {"const": "xagent-authoring-revision/v1"},
+    "session_id": {"type": "string", "pattern": "^auth_[a-f0-9]{32}$"},
+    "number": {"type": "integer", "minimum": 1},
+    "source": {"enum": ["user", "agent"]},
+    "script": {"$ref": "public-script.schema.json"},
+    "source_hash": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "canonical_hash": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "created_at": {"type": "string", "format": "date-time"}
+  }
+}

package/dist/assets/contracts/authoring-session-create.schema.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-session-create.schema.json",
+  "title": "XAgent Authoring Session Create v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["device_id"],
+  "properties": {
+    "device_id": {"type": "string", "minLength": 1, "maxLength": 255}
+  }
+}

package/dist/assets/contracts/authoring-session.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-session.schema.json",
+  "title": "XAgent Authoring Session v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["id", "schema_version", "device_id", "status", "current_revision_id", "final_revision_id", "created_at", "updated_at", "expires_at"],
+  "properties": {
+    "id": {"type": "string", "pattern": "^auth_[a-f0-9]{32}$"},
+    "schema_version": {"const": "xagent-authoring-session/v1"},
+    "device_id": {"type": "string", "minLength": 1, "maxLength": 255},
+    "status": {"enum": ["CREATED", "WAITING_RESOURCE", "ACTIVE", "COMPLETING", "COMPLETED", "CANCELLING", "CANCELLED", "FAILED", "EXPIRED"]},
+    "current_revision_id": {"type": ["string", "null"], "pattern": "^rev_[a-f0-9]{32}$"},
+    "final_revision_id": {"type": ["string", "null"], "pattern": "^rev_[a-f0-9]{32}$"},
+    "failure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": {"type": "string", "minLength": 1, "maxLength": 64},
+        "message": {"type": "string", "minLength": 1, "maxLength": 1000}
+      }
+    },
+    "console_url": {"type": "string", "format": "uri", "maxLength": 1000},
+    "billing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "billable_minutes", "cost", "discount_rate", "started_at", "ended_at"],
+      "properties": {
+        "status": {"enum": ["pending", "submitting", "succeeded", "failed", "unknown"]},
+        "billable_minutes": {"type": "integer", "minimum": 0},
+        "cost": {"type": "integer", "minimum": 0},
+        "discount_rate": {"type": "number", "minimum": 0},
+        "started_at": {"type": ["string", "null"], "format": "date-time"},
+        "ended_at": {"type": ["string", "null"], "format": "date-time"}
+      }
+    },
+    "created_at": {"type": "string", "format": "date-time"},
+    "updated_at": {"type": "string", "format": "date-time"},
+    "expires_at": {"type": "string", "format": "date-time"}
+  },
+  "allOf": [
+    {
+      "if": {"properties": {"status": {"const": "FAILED"}}, "required": ["status"]},
+      "then": {"required": ["failure"]},
+      "else": {"not": {"required": ["failure"]}}
+    },
+    {
+      "if": {"properties": {"status": {"const": "ACTIVE"}}, "required": ["status"]},
+      "then": {"required": ["console_url"]},
+      "else": {"not": {"required": ["console_url"]}}
+    }
+  ]
+}

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

@@ -0,0 +1,219 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/canonical-script.schema.json",
+  "title": "XAgent Canonical Script v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "version", "steps", "variables"],
+  "properties": {
+    "schema_version": {"const": "xagent-canonical/v1"},
+    "version": {"const": 1},
+    "variables": {"type": "object", "additionalProperties": true},
+    "steps": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 1000,
+      "items": {"$ref": "#/$defs/step"}
+    }
+  },
+  "$defs": {
+    "prepareDevice": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action"],
+      "properties": {
+        "action": {"const": "prepareDevice"}
+      }
+    },
+    "install": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "appDownloadUrl"],
+      "properties": {
+        "action": {"const": "install"},
+        "appDownloadUrl": {"type": "string", "minLength": 1},
+        "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"],
+      "properties": {
+        "action": {"const": "input"},
+        "text": {"type": "string"},
+        "target": {"type": "string", "minLength": 1},
+        "clearFirst": {"type": "boolean"},
+        "inputMode": {"enum": ["smart", "secret"]},
+        "description": {"type": "string", "maxLength": 1000}
+      }
+    },
+    "scroll": {"$ref": "public-script.schema.json#/$defs/scroll"},
+    "scroll_between": {"$ref": "public-script.schema.json#/$defs/scroll_between"},
+    "drag": {"$ref": "public-script.schema.json#/$defs/drag"},
+    "screenshot": {"$ref": "public-script.schema.json#/$defs/screenshot"},
+    "extract": {"$ref": "public-script.schema.json#/$defs/extract"},
+    "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": {"$ref": "public-script.schema.json#/$defs/appStop"},
+    "appClean": {"$ref": "public-script.schema.json#/$defs/appClean"},
+    "set": {"$ref": "public-script.schema.json#/$defs/set"},
+    "randomVar": {"$ref": "public-script.schema.json#/$defs/randomVar"},
+    "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": {"$ref": "public-script.schema.json#/$defs/throw"},
+    "break": {"$ref": "public-script.schema.json#/$defs/break"},
+    "press_key": {"$ref": "public-script.schema.json#/$defs/press_key"},
+    "press_home": {"$ref": "public-script.schema.json#/$defs/press_home"},
+    "press_back": {"$ref": "public-script.schema.json#/$defs/press_back"},
+    "press_enter": {"$ref": "public-script.schema.json#/$defs/press_enter"},
+    "step": {
+      "oneOf": [
+        {"$ref": "#/$defs/prepareDevice"},
+        {"$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"}
+      ]
+    }
+  }
+}