@testin-official/xagent 0.3.9 → 0.3.11

package/dist/assets/contracts/authoring-device-acquire.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-device-acquire.schema.json",
+  "title": "XAgent Device Acquire v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "session", "observation"],
+  "properties": {
+    "schema_version": {"const": "xagent-device-acquire/v1"},
+    "session": {"$ref": "authoring-session.schema.json"},
+    "observation": {"$ref": "authoring-observation.schema.json"}
+  }
+}

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

@@ -166,7 +166,7 @@
       "allOf": [
         {"$ref": "#/$defs/normalStep"},
         {
-          "required": ["direction", "distance"],
+          "required": ["direction"],
           "properties": {
             "action": {"const": "scroll"},
             "direction": {"enum": ["UP", "DOWN", "LEFT", "RIGHT"]},
@@ -302,6 +302,142 @@
     "pressHomeStep": {
       "allOf": [{"$ref": "#/$defs/normalStep"}, {"properties": {"action": {"const": "press_home"}}}]
     },
+    "scrollBetweenStep": {
+      "allOf": [
+        {"$ref": "#/$defs/normalStep"},
+        {
+          "required": ["action"],
+          "properties": {
+            "action": {"const": "scroll_between"},
+            "from": {"type": "string", "minLength": 1},
+            "to": {"type": "string", "minLength": 1},
+            "from_target": {"type": "string", "minLength": 1},
+            "to_target": {"type": "string", "minLength": 1},
+            "duration": {"type": ["integer", "number"], "minimum": 1, "maximum": 3600000}
+          },
+          "anyOf": [
+            {"required": ["from", "to"]},
+            {"required": ["from_target", "to_target"]}
+          ]
+        }
+      ]
+    },
+    "dragStep": {
+      "allOf": [
+        {"$ref": "#/$defs/normalStep"},
+        {
+          "required": ["action"],
+          "properties": {
+            "action": {"const": "drag"},
+            "from": {"type": "string", "minLength": 1},
+            "to": {"type": "string", "minLength": 1},
+            "from_target": {"type": "string", "minLength": 1},
+            "to_target": {"type": "string", "minLength": 1},
+            "speed": {"type": "string", "minLength": 1}
+          },
+          "anyOf": [
+            {"required": ["from", "to"]},
+            {"required": ["from_target", "to_target"]}
+          ]
+        }
+      ]
+    },
+    "extractStep": {
+      "allOf": [
+        {"$ref": "#/$defs/normalStep"},
+        {
+          "required": ["target", "varName"],
+          "properties": {
+            "action": {"const": "extract"},
+            "target": {"type": "string", "minLength": 1},
+            "varName": {"type": "string", "minLength": 1},
+            "type": {"type": "string", "minLength": 1}
+          }
+        }
+      ]
+    },
+    "randomVarStep": {
+      "allOf": [
+        {"$ref": "#/$defs/normalStep"},
+        {
+          "required": ["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"}
+          }
+        }
+      ]
+    },
+    "forStep": {
+      "allOf": [
+        {"$ref": "#/$defs/normalStep"},
+        {
+          "required": ["steps"],
+          "properties": {
+            "action": {"const": "for"},
+            "count": {
+              "oneOf": [
+                {"type": "integer", "minimum": 0},
+                {"type": "string", "minLength": 1}
+              ]
+            },
+            "condition": {"type": "string", "minLength": 1},
+            "judge": {"$ref": "#/$defs/judge"},
+            "dead_loop": {"type": "integer", "minimum": 1, "maximum": 10000},
+            "steps": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/editorStep"}}
+          },
+          "anyOf": [
+            {"required": ["count"]},
+            {"required": ["condition"]},
+            {"required": ["judge"]}
+          ]
+        }
+      ]
+    },
+    "throwStep": {
+      "allOf": [
+        {"$ref": "#/$defs/normalStep"},
+        {
+          "properties": {
+            "action": {"const": "throw"},
+            "message": {"type": "string", "minLength": 1},
+            "content": {"type": "string", "minLength": 1},
+            "text": {"type": "string", "minLength": 1}
+          },
+          "anyOf": [
+            {"required": ["message"]},
+            {"required": ["content"]},
+            {"required": ["text"]}
+          ]
+        }
+      ]
+    },
+    "breakStep": {
+      "allOf": [{"$ref": "#/$defs/normalStep"}, {"properties": {"action": {"const": "break"}}}]
+    },
+    "pressKeyStep": {
+      "allOf": [
+        {"$ref": "#/$defs/normalStep"},
+        {
+          "properties": {
+            "action": {"const": "press_key"},
+            "key": {"type": "string", "minLength": 1},
+            "keys": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}
+          },
+          "anyOf": [
+            {"required": ["key"]},
+            {"required": ["keys"]}
+          ]
+        }
+      ]
+    },
+    "pressEnterStep": {
+      "allOf": [{"$ref": "#/$defs/normalStep"}, {"properties": {"action": {"const": "press_enter"}}}]
+    },
     "paragraphStep": {
       "allOf": [
         {"$ref": "#/$defs/editorFields"},
@@ -310,7 +446,7 @@
           "required": ["frontStepType", "userText", "desc", "children"],
           "properties": {
             "frontStepType": {"const": "paragraph"},
-            "children": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/editorStep"}}
+            "children": {"type": "array", "items": {"$ref": "#/$defs/editorStep"}}
           }
         }
       ]
@@ -326,7 +462,7 @@
             "action": {"const": "if"},
             "condition": {"type": "string", "minLength": 1},
             "judge": {"$ref": "#/$defs/judge"},
-            "children": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/editorStep"}},
+            "children": {"type": "array", "items": {"$ref": "#/$defs/editorStep"}},
             "elseIfChildren": {"type": "array", "items": {"$ref": "#/$defs/elseIfStep"}},
             "elseChildren": {"type": "array", "items": {"$ref": "#/$defs/elseStep"}}
           }
@@ -344,7 +480,7 @@
             "action": {"const": "else-if"},
             "condition": {"type": "string", "minLength": 1},
             "judge": {"$ref": "#/$defs/judge"},
-            "children": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/editorStep"}}
+            "children": {"type": "array", "items": {"$ref": "#/$defs/editorStep"}}
           }
         }
       ]
@@ -358,7 +494,7 @@
           "properties": {
             "frontStepType": {"const": "else"},
             "action": {"const": "else"},
-            "children": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/editorStep"}}
+            "children": {"type": "array", "items": {"$ref": "#/$defs/editorStep"}}
           }
         }
       ]
@@ -372,6 +508,11 @@
         {"$ref": "#/$defs/waitForStep"}, {"$ref": "#/$defs/assertStep"},
         {"$ref": "#/$defs/screenshotStep"}, {"$ref": "#/$defs/setStep"},
         {"$ref": "#/$defs/pressBackStep"}, {"$ref": "#/$defs/pressHomeStep"},
+        {"$ref": "#/$defs/scrollBetweenStep"}, {"$ref": "#/$defs/dragStep"},
+        {"$ref": "#/$defs/extractStep"}, {"$ref": "#/$defs/randomVarStep"},
+        {"$ref": "#/$defs/forStep"}, {"$ref": "#/$defs/throwStep"},
+        {"$ref": "#/$defs/breakStep"}, {"$ref": "#/$defs/pressKeyStep"},
+        {"$ref": "#/$defs/pressEnterStep"},
         {"$ref": "#/$defs/paragraphStep"}, {"$ref": "#/$defs/ifStep"},
         {"$ref": "#/$defs/elseIfStep"}, {"$ref": "#/$defs/elseStep"}
       ]

package/dist/assets/contracts/fixtures/compat-script.all-platform-actions.yaml

@@ -188,6 +188,67 @@ steps:
     desc: 桌面动作备注
     frontStepType: step
     stepIdFront: step-home
+  - action: scroll_between
+    from: 列表顶部
+    to: 目标条目
+    duration: 800
+    userText: 从列表顶部滑到目标条目
+    desc: 点到点滑动备注
+    frontStepType: step
+    stepIdFront: step-scroll-between
+  - action: drag
+    from: 滑块起点
+    to: 滑块终点
+    speed: medium
+    userText: 拖动滑块
+    desc: 拖拽动作备注
+    frontStepType: step
+    stepIdFront: step-drag
+  - action: extract
+    target: 订单号
+    varName: order_no
+    type: string
+    userText: 提取订单号
+    desc: 提取动作备注
+    frontStepType: step
+    stepIdFront: step-extract
+  - action: randomVar
+    varName: generated_code
+    type: string
+    length: 6
+    userText: 生成随机验证码
+    desc: 随机变量备注
+    frontStepType: step
+    stepIdFront: step-random
+  - action: for
+    count: 2
+    steps:
+      - action: break
+        userText: 跳出当前循环
+        desc: 跳出循环备注
+        frontStepType: step
+        stepIdFront: step-break
+    userText: 重复执行两次
+    desc: 循环动作备注
+    frontStepType: step
+    stepIdFront: step-for
+  - action: throw
+    message: 主动终止测试
+    userText: 主动终止测试
+    desc: 抛错动作备注
+    frontStepType: step
+    stepIdFront: step-throw
+  - action: press_key
+    key: ENTER
+    userText: 按下指定按键
+    desc: 指定按键备注
+    frontStepType: step
+    stepIdFront: step-press-key
+  - action: press_enter
+    userText: 按下回车键
+    desc: 回车动作备注
+    frontStepType: step
+    stepIdFront: step-press-enter
   - action: if
     frontStepType: if
     userText: 页面显示登录入口

package/dist/assets/integrations/xagent-skill/references/host-adapters.md

@@ -1,5 +1,21 @@
 # Agent Host 适配
 
+## Guided UI Coordinator
+
+Guided UI 的推荐 Host 接入是 `xagent guided-ui coordinate`。Coordinator 独占消费本地 Broker 的 durable events，把事件 JSON 放进一次 Host turn 的 prompt；Host Agent 只负责调用 Action MCP 完成回复、用户确认和页面观察提交，不要再次调用 `xagent_guided_ui_wait` 消费同一事件。
+
+Codex 通过 `codex queue --thread <当前任务>` 把事件排入用户正在查看的任务，并在该调用中注入本地 Action MCP 配置。禁止为交互另建不可见的 ephemeral thread。WorkBuddy 使用等价的本地 stdio JSON-RPC Host Driver，把消息排入现有可见会话：
+
+```text
+initialize       {}
+message/queue    {"session_id":"当前可见会话","prompt":"..."}
+                 -> {"message_id":"..."}
+```
+
+WorkBuddy 桌面程序的私有 IPC 不作为 XAgent 合约。需要由 WorkBuddy 侧提供一个适配进程，并通过 `XAGENT_HOST_DRIVER_COMMAND`、JSON 数组形式的 `XAGENT_HOST_DRIVER_ARGS` 和 `XAGENT_WORKBUDDY_SESSION_ID` 启动。这样两种 Host 共享 Broker、事件、停止和截图协议，并且消息都出现在用户实际查看的会话中。
+
+`tour.stop_requested` 会停止后续消息注入；Coordinator 退出时会关闭适配进程，但不会终止可见会话中无关的活动 turn。Ctrl+C 只释放 Host 资源，不会静默伪造 WebUI 的 stopped 状态。
+
 Codex Host 使用 XAgent Skill 包。Host 负责加载入口 Skill、启动对应 MCP 进程，并把 MCP 图片原生展示给用户。
 
 ## 用户体验要求

package/dist/assets/integrations/xagent-skill/references/setup-and-doctor.md

@@ -14,7 +14,7 @@
 |---|---|
 | `OK` | 直接执行请求 |
 | `NEED_INIT` | 引导用户完成一次 XAgent 初始化 |
-| `NEED_AUTH` | 引导用户登录或配置指定 Profile |
+| `NEED_AUTH` | 提示“请联系云小宝并依据用户id获取相关token” |
 | `NEED_SYNC` | 同步 XAgent 自己的 Skill 文件 |
 | `NEED_UPGRADE` | 升级 CLI/Skill 后重新检查 |
 | `NEED_RESTART` | 提示重启 Agent Host/MCP，然后继续 |

package/dist/assets/skills/xagent-cli/SKILL.md

@@ -18,7 +18,7 @@ description: Configure and diagnose the local XAgent CLI, Profile, Skill install
 
 - 已配置：说明环境已就绪。
 - 未初始化：引导执行一次 `xagent init`。
-- 缺少登录：说明需要 Developer Token，但不回显 Token。
+- 缺少登录：提示“请联系云小宝并依据用户id获取相关token”，但不回显 Token。
 - Skill 过期：同步 XAgent Skill 后提示重启 Host。
 - MCP 过期：提示重启 MCP，不自动切换执行链路。
 

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA8XA,wBAAsB,MAAM,CAAC,IAAI,WAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/D"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA2dA,wBAAsB,MAAM,CAAC,IAAI,WAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/D"}