autotouch-cli 0.2.11__tar.gz → 0.2.13__tar.gz

{autotouch_cli-0.2.11 → autotouch_cli-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.11
+Version: 0.2.13
 Summary: Autotouch Smart Table CLI
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -55,6 +55,17 @@ autotouch auth set-key --api-key stk_... --base-url https://app.autotouch.ai
 autotouch auth check
 ```
 
+Developer keys support the same scope model as raw HTTP API calls.
+Workflow-related scopes now include:
+- `sequences:read`
+- `sequences:write`
+- `sequences:run`
+- `tasks:read`
+- `tasks:write`
+
+Reference:
+- `docs/platform/authentication.md`
+
 ## Preflight (recommended before writes)
 
 ```bash
@@ -158,6 +169,24 @@ This keeps quickstart short while documenting the full strategy:
 - one-person-per-row output contract,
 - JSON split + downstream enrichment chaining.
 
+## Sequences/Tasks workflow APIs (current CLI coverage)
+
+The installable `autotouch` CLI currently provides first-class commands for research-table APIs.
+
+Sequence/task workflow endpoints are available today via HTTP with the same developer key:
+- `docs/platform/external-workflows-api.md`
+
+Examples include:
+- `POST /api/sequences`
+- `PATCH /api/sequences/{sequence_id}/status`
+- `POST /api/sequences/{sequence_id}/enroll`
+- `POST /api/task-queue/create`
+- `POST /api/task-queue/{task_id}/draft`
+
+Important:
+- These workflow routes support `actorUserId` query parameter.
+- External sequence validation rules (manual vs automated vs AI draft constraints) are documented in the workflow reference above.
+
 ## Create basic/manual fields (text, number, date, etc.)
 
 Use `kind=manual` for non-enrichment columns.
@@ -294,10 +323,16 @@ autotouch columns run-next \
 
 - Treat a run as started only when you receive `job_id`.
 - Treat a run as done only when `jobs get/watch` returns terminal status.
+- `columns run --wait` now emits structured progress events and includes:
+  - `job_id`
+  - `job_status_url`
+  - `watch_command`
 
 ```bash
 autotouch jobs get --job-id <JOB_ID> --output json
 autotouch jobs watch --job-id <JOB_ID> --interval 2 --output json
+# Recover latest job id if local output lost it:
+autotouch jobs list --table-id <TABLE_ID> --column-id <COLUMN_ID> --limit 1 --output json
 ```
 
 Terminal statuses:
@@ -306,6 +341,25 @@ Terminal statuses:
 - `error`
 - `cancelled`
 
+Non-terminal statuses:
+- `queued`
+- `distributing`
+- `processing`
+
+Recommended status fields to inspect while waiting:
+- `processed_rows`
+- `error_rows`
+- `skipped_rows`
+- `total_rows`
+- `pending_batches`
+- `terminal_reason`
+
+CLI-protected failure statuses:
+- `not_found`
+- `unknown_not_found`
+
+If either failure status appears, treat the run as unconfirmed/inconsistent, verify row state, and rerun.
+
 ## Troubleshooting
 
 1. Import appears to run but rows are missing:
@@ -320,7 +374,12 @@ Terminal statuses:
 - Re-run with same `--checkpoint-file` and `--wait`.
 - CLI can resume/poll an in-flight task from checkpoint state.
 
-4. Need to stop a running column job:
+4. Run queued but job id missing from local output:
+- Recover from backend history:
+  - `autotouch jobs list --table-id <TABLE_ID> --column-id <COLUMN_ID> --limit 5 --output json`
+- Then poll the returned `job_id` with `autotouch jobs get` / `autotouch jobs watch`.
+
+5. Need to stop a running column job:
 
 ```bash
 autotouch columns stop --table-id <TABLE_ID> --column-id <COLUMN_ID>

{autotouch_cli-0.2.11 → autotouch_cli-0.2.13}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.11
+Version: 0.2.13
 Summary: Autotouch Smart Table CLI
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -55,6 +55,17 @@ autotouch auth set-key --api-key stk_... --base-url https://app.autotouch.ai
 autotouch auth check
 ```
 
+Developer keys support the same scope model as raw HTTP API calls.
+Workflow-related scopes now include:
+- `sequences:read`
+- `sequences:write`
+- `sequences:run`
+- `tasks:read`
+- `tasks:write`
+
+Reference:
+- `docs/platform/authentication.md`
+
 ## Preflight (recommended before writes)
 
 ```bash
@@ -158,6 +169,24 @@ This keeps quickstart short while documenting the full strategy:
 - one-person-per-row output contract,
 - JSON split + downstream enrichment chaining.
 
+## Sequences/Tasks workflow APIs (current CLI coverage)
+
+The installable `autotouch` CLI currently provides first-class commands for research-table APIs.
+
+Sequence/task workflow endpoints are available today via HTTP with the same developer key:
+- `docs/platform/external-workflows-api.md`
+
+Examples include:
+- `POST /api/sequences`
+- `PATCH /api/sequences/{sequence_id}/status`
+- `POST /api/sequences/{sequence_id}/enroll`
+- `POST /api/task-queue/create`
+- `POST /api/task-queue/{task_id}/draft`
+
+Important:
+- These workflow routes support `actorUserId` query parameter.
+- External sequence validation rules (manual vs automated vs AI draft constraints) are documented in the workflow reference above.
+
 ## Create basic/manual fields (text, number, date, etc.)
 
 Use `kind=manual` for non-enrichment columns.
@@ -294,10 +323,16 @@ autotouch columns run-next \
 
 - Treat a run as started only when you receive `job_id`.
 - Treat a run as done only when `jobs get/watch` returns terminal status.
+- `columns run --wait` now emits structured progress events and includes:
+  - `job_id`
+  - `job_status_url`
+  - `watch_command`
 
 ```bash
 autotouch jobs get --job-id <JOB_ID> --output json
 autotouch jobs watch --job-id <JOB_ID> --interval 2 --output json
+# Recover latest job id if local output lost it:
+autotouch jobs list --table-id <TABLE_ID> --column-id <COLUMN_ID> --limit 1 --output json
 ```
 
 Terminal statuses:
@@ -306,6 +341,25 @@ Terminal statuses:
 - `error`
 - `cancelled`
 
+Non-terminal statuses:
+- `queued`
+- `distributing`
+- `processing`
+
+Recommended status fields to inspect while waiting:
+- `processed_rows`
+- `error_rows`
+- `skipped_rows`
+- `total_rows`
+- `pending_batches`
+- `terminal_reason`
+
+CLI-protected failure statuses:
+- `not_found`
+- `unknown_not_found`
+
+If either failure status appears, treat the run as unconfirmed/inconsistent, verify row state, and rerun.
+
 ## Troubleshooting
 
 1. Import appears to run but rows are missing:
@@ -320,7 +374,12 @@ Terminal statuses:
 - Re-run with same `--checkpoint-file` and `--wait`.
 - CLI can resume/poll an in-flight task from checkpoint state.
 
-4. Need to stop a running column job:
+4. Run queued but job id missing from local output:
+- Recover from backend history:
+  - `autotouch jobs list --table-id <TABLE_ID> --column-id <COLUMN_ID> --limit 5 --output json`
+- Then poll the returned `job_id` with `autotouch jobs get` / `autotouch jobs watch`.
+
+5. Need to stop a running column job:
 
 ```bash
 autotouch columns stop --table-id <TABLE_ID> --column-id <COLUMN_ID>

{autotouch_cli-0.2.11 → autotouch_cli-0.2.13}/docs/research-table/reference/autotouch-cli-pypi.md

@@ -46,6 +46,17 @@ autotouch auth set-key --api-key stk_... --base-url https://app.autotouch.ai
 autotouch auth check
 ```
 
+Developer keys support the same scope model as raw HTTP API calls.
+Workflow-related scopes now include:
+- `sequences:read`
+- `sequences:write`
+- `sequences:run`
+- `tasks:read`
+- `tasks:write`
+
+Reference:
+- `docs/platform/authentication.md`
+
 ## Preflight (recommended before writes)
 
 ```bash
@@ -149,6 +160,24 @@ This keeps quickstart short while documenting the full strategy:
 - one-person-per-row output contract,
 - JSON split + downstream enrichment chaining.
 
+## Sequences/Tasks workflow APIs (current CLI coverage)
+
+The installable `autotouch` CLI currently provides first-class commands for research-table APIs.
+
+Sequence/task workflow endpoints are available today via HTTP with the same developer key:
+- `docs/platform/external-workflows-api.md`
+
+Examples include:
+- `POST /api/sequences`
+- `PATCH /api/sequences/{sequence_id}/status`
+- `POST /api/sequences/{sequence_id}/enroll`
+- `POST /api/task-queue/create`
+- `POST /api/task-queue/{task_id}/draft`
+
+Important:
+- These workflow routes support `actorUserId` query parameter.
+- External sequence validation rules (manual vs automated vs AI draft constraints) are documented in the workflow reference above.
+
 ## Create basic/manual fields (text, number, date, etc.)
 
 Use `kind=manual` for non-enrichment columns.
@@ -285,10 +314,16 @@ autotouch columns run-next \
 
 - Treat a run as started only when you receive `job_id`.
 - Treat a run as done only when `jobs get/watch` returns terminal status.
+- `columns run --wait` now emits structured progress events and includes:
+  - `job_id`
+  - `job_status_url`
+  - `watch_command`
 
 ```bash
 autotouch jobs get --job-id <JOB_ID> --output json
 autotouch jobs watch --job-id <JOB_ID> --interval 2 --output json
+# Recover latest job id if local output lost it:
+autotouch jobs list --table-id <TABLE_ID> --column-id <COLUMN_ID> --limit 1 --output json
 ```
 
 Terminal statuses:
@@ -297,6 +332,25 @@ Terminal statuses:
 - `error`
 - `cancelled`
 
+Non-terminal statuses:
+- `queued`
+- `distributing`
+- `processing`
+
+Recommended status fields to inspect while waiting:
+- `processed_rows`
+- `error_rows`
+- `skipped_rows`
+- `total_rows`
+- `pending_batches`
+- `terminal_reason`
+
+CLI-protected failure statuses:
+- `not_found`
+- `unknown_not_found`
+
+If either failure status appears, treat the run as unconfirmed/inconsistent, verify row state, and rerun.
+
 ## Troubleshooting
 
 1. Import appears to run but rows are missing:
@@ -311,7 +365,12 @@ Terminal statuses:
 - Re-run with same `--checkpoint-file` and `--wait`.
 - CLI can resume/poll an in-flight task from checkpoint state.
 
-4. Need to stop a running column job:
+4. Run queued but job id missing from local output:
+- Recover from backend history:
+  - `autotouch jobs list --table-id <TABLE_ID> --column-id <COLUMN_ID> --limit 5 --output json`
+- Then poll the returned `job_id` with `autotouch jobs get` / `autotouch jobs watch`.
+
+5. Need to stop a running column job:
 
 ```bash
 autotouch columns stop --table-id <TABLE_ID> --column-id <COLUMN_ID>

{autotouch_cli-0.2.11 → autotouch_cli-0.2.13}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "autotouch-cli"
-version = "0.2.11"
+version = "0.2.13"
 description = "Autotouch Smart Table CLI"
 readme = "docs/research-table/reference/autotouch-cli-pypi.md"
 requires-python = ">=3.9"

{autotouch_cli-0.2.11 → autotouch_cli-0.2.13}/scripts/smart_table_cli.py

@@ -2589,6 +2589,31 @@ def cmd_jobs_get(args: argparse.Namespace) -> None:
     _print_json(data, compact=args.compact)
 
 
+def cmd_jobs_list(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    params: Dict[str, Any] = {"limit": int(args.limit or 20)}
+    if args.table_id:
+        params["table_id"] = args.table_id
+    if args.column_id:
+        params["column_id"] = args.column_id
+    if args.status:
+        params["status"] = args.status
+    if args.provider:
+        params["provider"] = args.provider
+
+    data = _request_api(
+        "GET",
+        "/api/bulk-jobs",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        params=params,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
 def cmd_jobs_watch(args: argparse.Namespace) -> None:
     token = _resolve_token(args.token, required=True)
     poll_result = _poll_job(
@@ -3039,6 +3064,15 @@ def build_parser() -> argparse.ArgumentParser:
     _add_api_common_arguments(pjg)
     pjg.set_defaults(func=cmd_jobs_get)
 
+    pjl = jobs_sub.add_parser("list", help="List recent bulk jobs (recover latest job_id)")
+    pjl.add_argument("--table-id", help="Filter by table id")
+    pjl.add_argument("--column-id", help="Filter by column id")
+    pjl.add_argument("--status", help="Filter by status (or comma-separated statuses)")
+    pjl.add_argument("--provider", help="Filter by provider")
+    pjl.add_argument("--limit", type=int, default=20, help="Max jobs to return (1-100)")
+    _add_api_common_arguments(pjl)
+    pjl.set_defaults(func=cmd_jobs_list)
+
     pjw = jobs_sub.add_parser("watch", help="Poll bulk job status until terminal (or once)")
     pjw.add_argument("--job-id", required=True)
     pjw.add_argument("--once", action="store_true", help="Fetch once and exit")