xparse-cli 2.4.4-beta.2 → 2.4.4-beta.4

package/README.md

@@ -166,6 +166,29 @@ xparse-cli parse report.pdf --api paid
 
 ### 3. 多文件 Task Runtime（Agent 推荐）
 
+解析与抽取统一使用 `task run`：省略 `--task-type` 时仍为解析，原有参数兼容。
+
+```bash
+xparse-cli task run --task-type parse a.pdf
+xparse-cli task run --task-type extract --instruction '抽取编号与金额' --file-id <FILE_ID>
+xparse-cli task add <PARSE_TASK_ID> b.pdf
+xparse-cli task add <EXTRACTION_TASK_ID> --file-id <FILE_ID>
+xparse-cli task status <TASK_ID>
+xparse-cli task result <TASK_ID> --limit 50
+xparse-cli task export <EXTRACTION_TASK_ID> --format json --output ./results
+```
+
+顶层 `extract` 已移除。创建抽取只接受已解析的 File Asset，解析专用参数不能用于抽取。
+追加根据服务端类型分发；解析会追加输入并请求新一轮处理，抽取沿用既有任务要求。
+解析追加若绑定后启动失败，应保留 `operation_id`、`task_id` 并按错误提示恢复。
+
+抽取分页返回 `snapshot`，后续页使用 `--offset` 和同一个 `--snapshot`；快照变化应重取。
+抽取 JSON/CSV 导出分别写入目录内 `results.json` / `results.csv`，只含就绪文档的业务结果；
+命令响应单独返回完整性、未完成/失败文件和需复核字段，不能将部分导出视为全量成功。
+标量保留字符串（不把编号转换为数字），对象/数组保持结构，未找到的值为 null。
+旧解析 `--view markdown|json`、`--output` 目录及 `task read/rerun` 保持兼容。
+新服务端提供抽取类型及结果投影后才能使用新查询与导出命令。
+
 Task Runtime 把上传、执行状态和结果交给服务端持久化。`task run` 默认在提交 Run
 成功后立即返回 `operation_id`、`task_id` 和 `run_id`；Agent 后续锁定该 Run 查看进度，完成后再按需读取或导出结果，不需要把全部结果放进上下文。WorkBuddy 下 stderr 输出 `xparse_event.v1` JSONL：服务端接受 Run 后立即输出 `run_accepted`，后续状态变化输出 `run_status`；stdout 始终只输出一份最终提交 JSON。
 
@@ -554,3 +577,18 @@ OAuth 参数优先级：
 | XLS/XLSX/CSV | — | 每 sheet ≤ 2000 行 × 100 列 |
 | TXT | — | ≤ 100KB |
 | 图片尺寸 | 20～20000 像素 | 20～20000 像素 |
+
+### Extraction recovery
+
+`task status <task-id> --details` shows failed resources and private-result settlement status.
+For `pending_settlement`, retain the candidate identity and run:
+
+```bash
+xparse-cli task retry <task-id> --resource-id <resource-id> --pending-result-id <pending-result-id>
+```
+
+This settles the saved result without another model call. Replaying the same candidate is safe.
+The Task stays suspended; use `task result` or `task export` for delivered files. Explicit
+`task resume <task-id>` continues remaining Agent work and adds execution budget. Preserve its
+`command_id` and `checkpoint_version` for exact replay. Without a saved candidate, `task retry`
+re-extracts the one resource; do not blindly replay an ambiguous response.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xparse-cli",
-  "version": "2.4.4-beta.2",
+  "version": "2.4.4-beta.4",
   "description": "TextIn xParse command-line client for document parsing",
   "license": "MIT",
   "repository": {
@@ -19,12 +19,12 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "xparse-cli-darwin-amd64": "2.4.4-beta.2",
-    "xparse-cli-darwin-arm64": "2.4.4-beta.2",
-    "xparse-cli-linux-amd64": "2.4.4-beta.2",
-    "xparse-cli-linux-arm64": "2.4.4-beta.2",
-    "xparse-cli-windows-amd64": "2.4.4-beta.2",
-    "xparse-cli-windows-arm64": "2.4.4-beta.2"
+    "xparse-cli-darwin-amd64": "2.4.4-beta.4",
+    "xparse-cli-darwin-arm64": "2.4.4-beta.4",
+    "xparse-cli-linux-amd64": "2.4.4-beta.4",
+    "xparse-cli-linux-arm64": "2.4.4-beta.4",
+    "xparse-cli-windows-amd64": "2.4.4-beta.4",
+    "xparse-cli-windows-arm64": "2.4.4-beta.4"
   },
   "publishConfig": {
     "access": "public",