xevol 0.14.0 → 0.14.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +42 -2
- package/dist/index.js +276 -295
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Terminal client for Xevol content execution.
|
|
4
4
|
|
|
5
|
-
Use it to
|
|
5
|
+
Use it to manage Xevol Work Ads; operate Offers, Leads, Contacts, Companies, Deals, Activities, tasks, and search; ingest content; run analysis; manage prompts; inspect usage; and work across Workspaces.
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
@@ -52,7 +52,8 @@ xevol workspace switch <workspace-id>
|
|
|
52
52
|
- `xevol logout` — revoke token + clear local config
|
|
53
53
|
- `xevol whoami` — current authenticated account
|
|
54
54
|
|
|
55
|
-
### Xevol Work
|
|
55
|
+
### Xevol Work
|
|
56
|
+
- `xevol ads ...` — manage Ads projects, collections, creatives, formats, copy, links, status, archives, and history
|
|
56
57
|
- `xevol companies ...` — all Companies reads and commands: list, get, options, create, update, remove, enrich, research, and primary Contact
|
|
57
58
|
- `xevol contacts ...` — all Contacts reads and commands: list, get, create, update, and proposed-fact decisions
|
|
58
59
|
- `xevol offers ...` — every Offers procedure used by Xevol Work Web, including profiles, status, snapshots, audiences, angles, artifacts, revisions, and reviewed generation
|
|
@@ -87,6 +88,45 @@ List commands also accept `--query`, `--page`, `--page-size`, `--sort`, and `--d
|
|
|
87
88
|
|
|
88
89
|
Campaign execution commands keep the Work API's reviewed-policy and acknowledgement requirements. In particular, `campaign-execution-activate` can start sending and requires both `expectedEnrollmentCount` and `"acknowledgeSend": true`; the CLI supplies no bypass and the API rechecks current Workspace authority.
|
|
89
90
|
|
|
91
|
+
### Ads manager
|
|
92
|
+
|
|
93
|
+
Ads commands mirror the `ads.*` Work manager. They create and edit native records, upload
|
|
94
|
+
formats, change status, archive and restore, and expose append-only change history. They
|
|
95
|
+
do not run the operator importer, generate creative, publish, or manage ad-platform
|
|
96
|
+
campaigns, targeting, budgets, spend, or attribution.
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
xevol ads projects --json
|
|
100
|
+
xevol ads compare <left-creative-id> --right-id <right-creative-id> --json
|
|
101
|
+
xevol ads project-create --name OwnScreen --json
|
|
102
|
+
xevol ads create --project-id <project-id> --title "Shop-window film" --kind motion --language en --json
|
|
103
|
+
xevol ads update <creative-id> --destination https://example.test --json
|
|
104
|
+
xevol ads upload <creative-id> film.mp4 --name "4:5 film" --width 1080 --height 1350 --duration 15 --json
|
|
105
|
+
xevol ads copy-add <creative-id> --content "Turn any TV into a sign" --json
|
|
106
|
+
xevol ads status <creative-id> --status Live --note "AU+NZ" --json
|
|
107
|
+
xevol ads archive <creative-id> --entity creative --json
|
|
108
|
+
xevol ads restore <creative-id> --entity creative --json
|
|
109
|
+
xevol ads history <creative-id> --json
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
`ads update` and `ads status` fetch the creative's current `updatedAt` when
|
|
113
|
+
`--updated-at` is omitted. Other edits require the `updatedAt` read from the API, passed
|
|
114
|
+
through `--updated-at` or JSON, so concurrent changes return `CONFLICT` instead of being
|
|
115
|
+
overwritten. `ads upload` accepts PNG, JPEG, WebP, GIF and MP4 files up to 64 MiB; it
|
|
116
|
+
handles the grant, byte upload, and direct-upload finalization as one command.
|
|
117
|
+
|
|
118
|
+
Read commands remain available: `projects`, `list`, `get`, `documents`, `compare`, and
|
|
119
|
+
`history`. `ads list` supports `--category`, `--kind image|motion|mixed`, `--label`,
|
|
120
|
+
`--language`, `--creative-type`, `--medium`, and common paging/search flags. Its sort
|
|
121
|
+
fields are `title`, `category`, `label`, `language`, and `creativeType`. The project
|
|
122
|
+
filter uses the stable `sourceId` returned by `ads projects`; `ads documents` uses that
|
|
123
|
+
project's record `id`.
|
|
124
|
+
|
|
125
|
+
Editorial status and archive presence do not prove publication, performance, platform
|
|
126
|
+
approval, or reuse rights. The selected Workspace and Ads module gate still apply.
|
|
127
|
+
Workspace-bound agent access may create, edit, link and upload. It cannot run `status`,
|
|
128
|
+
`archive`, or `restore`; those decisions require a full OWNER or MEMBER session.
|
|
129
|
+
|
|
90
130
|
### Imported source data
|
|
91
131
|
|
|
92
132
|
Directory and Career source commands use the same Work API token, selected Workspace,
|