@socialseal/cli 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.1.8 - 2026-04-13
+- Increase default CLI timeout from 30s to 5m to reduce false timeout failures on heavy tool/export workflows.
+- Harden async `search-journey-run` polling to accept additional active/terminal status labels (`queued`, `in_progress`, `running`, `succeeded`, `error`) instead of failing on unexpected variants.
+- Fix async `search-journey-run` polling workspace propagation to always reuse the resolved effective workspace scope.
+
+## 0.1.7 - 2026-03-20
+- Add `socialseal data export-search-results` for CLI-first enriched ranked-search exports, including direct CSV download handling.
+- Add `search_results_enriched` as an alias on `socialseal data export-report` to map to the ranked-search export template.
+- Add `socialseal data export-options` to make available export workflows discoverable from the CLI.
+- Improve export ergonomics with local report-type validation and instructive failure guidance for processing, failed, and expired-download states.
+
 ## 0.1.6 - 2026-03-19
 - Fix runtime version reporting so `socialseal --version` reads from package metadata instead of a hardcoded source string.
 - Fix `tracking` create request translation so `--workspace-id` is sent on the REST query path the backend uses for workspace binding.

package/README.md

@@ -42,12 +42,17 @@ Optional config file:
 - Tools list (built-in registry):
   - `socialseal tools list`
   - `socialseal tools list --json`
+  - `socialseal tools schema --function search-journey-run`
 
 - Tools (direct edge function call):
   - `socialseal tools call --function <tool> --body @payload.json --api-base https://api.socialseal.co --api-key <key>`
   - `socialseal tools call --function <tool> --body @payload.json --json`
   - `socialseal tools call --function search-journey-run --body @payload.json --async --workspace-id <uuid>`
   - `socialseal tools call --function search-journey-run --body @payload.json --async --no-poll --workspace-id <uuid>`
+  - `socialseal tools status 6809 --kind google_ai_run`
+  - `socialseal tools status <job-uuid> --kind agent_job`
+  - `socialseal tools status <run-uuid> --kind journey_run --workspace-id <uuid>`
+  - `socialseal tools status 6809 --kind google_ai_run --wait --include-results`
 
 - Tracked video extraction:
   - `socialseal video queue-analysis --video-id 734829384 --workspace-id <uuid>`
@@ -56,14 +61,23 @@ Optional config file:
   - `socialseal video extract --body @payload.json --out-dir ./video-assets`
 
 - Data exports (provisional):
+  - `socialseal data export-options`
   - `socialseal data export-tracking --group-id 123 --time-period 30d --workspace-id <uuid> --out out.csv`
+  - `socialseal data export-search-results --group-ids 123,124 --workspace-id <uuid> --out ranked.csv`
+  - `socialseal data export-report --report-type search_results_enriched --format csv --payload @payload.json --workspace-id <uuid> --out ranked.csv`
   - `socialseal data export-report --report-type keyword_universe --format csv --payload @payload.json --out out.csv`
 
 ## Notes
-- `export-report` and `export_tracking_data` are provisional until CLI export specs are finalized.
+- `export-report`, `export_tracking_data`, and `export-data`-backed exports are provisional until CLI export specs are finalized.
 - `tools list` ships a stable built-in registry of supported direct-call function targets. It is not live backend enumeration.
+- `tools schema --function <name>` prints static required/optional payload fields and example bodies for high-friction tools.
+- `data export-search-results` maps to `export-data` template `tracking_ranked_videos_raw` and returns enriched ranked-search rows (search fields + video metadata + latest metrics + analysis). It downloads the signed CSV artifact when available.
+- `data export-report --report-type search_results_enriched` is a compatibility alias to the same `export-data` template flow.
+- `data export-report` now validates report types locally and shows the allowed list immediately; run `socialseal data export-options` when choosing between export flows.
+- If an export returns metadata without a file URL (for example status `processing`), the CLI prints an explicit retry hint and returns the metadata JSON so automation can branch on status.
 - `--timeout <ms>` controls HTTP request timeouts. Agent runs default to a 5-minute WebSocket inactivity timeout unless you set `--idle-timeout <ms>` (or the matching env/config value).
 - `search-journey-run` supports CLI-managed async polling: `--async` starts backend async mode, polling is on by default, `--no-poll` returns the initial `runId`, and `--poll-interval <ms>` controls the status polling cadence.
+- `tools status <id>` is the unified read path for numeric Google AI run ids and UUID job/run ids. `--kind auto` detects numeric Google runs and UUID agent jobs, and falls back to journey status when `--workspace-id` is provided.
 - `video queue-analysis` wraps the tracked-video extraction backend in queue-only mode so you can queue one or many tracked videos without downloading assets first.
 - `video extract` wraps the same backend in extraction mode and returns a normalized JSON payload with resolved tracking context, structured analysis, thumbnail/frame assets, and optional local downloads under `--out-dir`.
 - `--video-id` is the primary ergonomic selector for video workflows. The backend tries it as `video_uid` first, then as platform video id. It does not accept tracking item ids. `--search-result-id` remains available when you are starting from a specific tracked rank row.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socialseal/cli",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "private": false,
   "type": "module",
   "description": "SocialSeal CLI (non-interactive)",