xparse-cli 2.4.4 → 2.4.5-beta.1

package/README.md

@@ -590,5 +590,74 @@ xparse-cli task retry <task-id> --resource-id <resource-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`
+`command_id` and `checkpoint_version` for exact replay. Without a saved candidate, `task retry --resource-id RESOURCE_ID`
 re-extracts the one resource; do not blindly replay an ambiguous response.
+
+## Extraction workspace commands
+
+The workspace commands below require a matching CLI build and backend. They do
+not create a replacement Task. Request JSON is read from `--input FILE` or stdin
+with `--input -`; values and version tokens are transmitted without reinterpretation.
+
+```bash
+xparse-cli task retry TASK_ID
+xparse-cli task retry TASK_ID --scope selected --resource-id RESOURCE_ID --field-id FIELD_ID
+xparse-cli task retry TASK_ID --only-outdated
+xparse-cli task spec get TASK_ID
+xparse-cli task spec set TASK_ID --input fields.json
+xparse-cli task spec clarify TASK_ID --input clarification.json
+xparse-cli task field set TASK_ID RESOURCE_ID FIELD_ID --input correction.json
+xparse-cli task field confirm TASK_ID RESOURCE_ID FIELD_ID --input confirmation.json
+xparse-cli task history TASK_ID RESOURCE_ID
+xparse-cli task preview TASK_ID RESOURCE_ID
+xparse-cli task copilot show TASK_ID
+xparse-cli task copilot steps TASK_ID --after 0
+xparse-cli task copilot send TASK_ID --text 'Recheck the contract amount'
+xparse-cli task copilot send TASK_ID --input reply.json
+xparse-cli task memory list TASK_ID
+xparse-cli task memory revoke TASK_ID MEMORY_ID
+xparse-cli task list --search contract --limit 20
+xparse-cli task page TASK_ID
+xparse-cli task add TASK_ID new.pdf
+xparse-cli task add TASK_ID --history-id 123
+xparse-cli task add TASK_ID --uploaded-file-id FILE_ID
+xparse-cli task add TASK_ID --reconcile
+```
+
+`retry TASK_ID` re-extracts every file using the current definition. File and field
+selectors intersect; with a field definition, only active fields are used. A Task
+without a field definition reruns its original instruction and cannot use field
+selectors or `--only-outdated`. Old results remain until replaced by new results.
+Legacy `retry TASK_ID --resource-id RESOURCE_ID` still recovers one failed file or
+settles its saved result; use `--scope selected` to force re-extraction of that file.
+`resume` continues suspended work and remains separate from re-extraction.
+
+`fields.json` is the complete active field list, not a partial patch. Omitting an
+existing field deletes it; use `restore_field_ids` to restore deleted fields:
+
+```json
+{"expected_version":7,"task_rules":"Extract contract data","fields":[{"field_id":"amount","name":"Amount","description":"Total including tax"}],"restore_field_ids":[],"apply_to_existing":false}
+```
+
+For clarification, send `expected_version`, `name`, and `description`.
+For field correction/confirmation, preserve the reviewed result and spec versions:
+
+```json
+{"base_result_version":3,"expected_spec_version":7,"request_id":"review-unique-id","value":{"value":"100.00"},"review":{"apply_to_future":false}}
+```
+
+Copilot supports all page interaction kinds, including edited definitions,
+confirm-only, confirm-and-rerun, answers and dismissals. Preserve the original
+identities and reviewed draft values. Example (replace all identifiers/versions):
+
+```json
+{"client_message_id":"reply-unique-id","kind":"confirm_and_rerun","text":"","expected_version":7,"draft_id":"draft-id","draft_revision":2}
+```
+
+A conflict is not retried with a silently refreshed version. After an ambiguous
+mutation response, query the same Task before any repeat. Managed local additions
+return upload identities for recovery and use the page's managed import pipeline.
+`task page` requires the backend's `page-session?result_page_url=true` support and
+returns the exact server-issued URL; never build grants in the client.
+
+Regional availability follows the page: task list, spec set/clarify, whole-task or scoped retry, preview and version history are domestic-only. Other operations retain their existing regional rules. These additions require a matching CLI/Connector build; check the installed CLI's command help before using them.

package/package.json

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