@roarkanalytics/cli 0.59.0 → 0.60.0
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/CHANGELOG.md +18 -0
- package/README.md +22 -22
- package/commands.js +82 -109
- package/completions.js +4 -4
- package/man/roark-agent-build.1 +22 -1
- package/man/roark-agent-draft-update.1 +2 -38
- package/man/{roark-agent-version-restore.1 → roark-agent-version-rollback.1} +7 -7
- package/man/roark-call-list.1 +5 -2
- package/man/roark.1 +2 -2
- package/npm-shrinkwrap.json +6 -6
- package/package.json +3 -3
- package/version.d.ts +1 -1
- package/version.js +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,23 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.60.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.59.1...v0.60.0) (2026-11-01)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### ⚠ BREAKING CHANGES
|
|
7
|
+
|
|
8
|
+
* **cli:** removes or renames commands. Scripts using the old names will fail.
|
|
9
|
+
|
|
10
|
+
### Features
|
|
11
|
+
|
|
12
|
+
* **cli:** cli update ([#156](https://github.com/roarkhq/cli-roark-analytics/issues/156)) ([37fcaa8](https://github.com/roarkhq/cli-roark-analytics/commit/37fcaa877503f12639c7125d55881b47ccab5927))
|
|
13
|
+
|
|
14
|
+
## [0.59.1](https://github.com/roarkhq/cli-roark-analytics/compare/v0.59.0...v0.59.1) (2026-10-28)
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
### Bug Fixes
|
|
18
|
+
|
|
19
|
+
* **deps:** raise the @roarkanalytics/sdk floor to 5.22.0 ([#154](https://github.com/roarkhq/cli-roark-analytics/issues/154)) ([d5698ef](https://github.com/roarkhq/cli-roark-analytics/commit/d5698ef174ff81447bfc8e3bec026dcd4bb66449))
|
|
20
|
+
|
|
3
21
|
## [0.59.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.58.0...v0.59.0) (2026-10-28)
|
|
4
22
|
|
|
5
23
|
|
package/README.md
CHANGED
|
@@ -108,28 +108,28 @@ roark completion fish | source
|
|
|
108
108
|
|
|
109
109
|
### agent
|
|
110
110
|
|
|
111
|
-
| Command
|
|
112
|
-
|
|
|
113
|
-
| `roark agent build --name <value> --job-description <value> --tts.provider <value> --tts.voice-id <value>` | Build a Roark-hosted agent
|
|
114
|
-
| `roark agent create --name <value>`
|
|
115
|
-
| `roark agent draft create <agent-id>`
|
|
116
|
-
| `roark agent draft delete <agent-id>`
|
|
117
|
-
| `roark agent draft get <agent-id>`
|
|
118
|
-
| `roark agent draft publish <agent-id> --expected-revision <value>`
|
|
119
|
-
| `roark agent draft update <agent-id> --settings <value>`
|
|
120
|
-
| `roark agent endpoint create --agent-id <value> --value <value> --direction <value>`
|
|
121
|
-
| `roark agent endpoint get <endpoint-id>`
|
|
122
|
-
| `roark agent endpoint list`
|
|
123
|
-
| `roark agent endpoint update <endpoint-id>`
|
|
124
|
-
| `roark agent get <agent-id>`
|
|
125
|
-
| `roark agent list`
|
|
126
|
-
| `roark agent prompt list <agent-id>`
|
|
127
|
-
| `roark agent prompt update <agent-id> --prompt <value>`
|
|
128
|
-
| `roark agent prompt version list <agent-id> <prompt-id>`
|
|
129
|
-
| `roark agent update <agent-id>`
|
|
130
|
-
| `roark agent version get <agent-id> <version-id>`
|
|
131
|
-
| `roark agent version list <agent-id>`
|
|
132
|
-
| `roark agent version
|
|
111
|
+
| Command | Description |
|
|
112
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |
|
|
113
|
+
| `roark agent build --name <value> --job-description <value> --tts.provider <value> --tts.voice-id <value> --stt.provider <value> --stt.model <value> --llm.provider <value> --llm.model <value>` | Build a Roark-hosted agent |
|
|
114
|
+
| `roark agent create --name <value>` | Create a new agent |
|
|
115
|
+
| `roark agent draft create <agent-id>` | Start a draft |
|
|
116
|
+
| `roark agent draft delete <agent-id>` | Discard the draft |
|
|
117
|
+
| `roark agent draft get <agent-id>` | Get an agent's draft |
|
|
118
|
+
| `roark agent draft publish <agent-id> --expected-revision <value>` | Publish the draft |
|
|
119
|
+
| `roark agent draft update <agent-id> --settings <value>` | Edit the draft |
|
|
120
|
+
| `roark agent endpoint create --agent-id <value> --value <value> --direction <value>` | Create a new agent endpoint |
|
|
121
|
+
| `roark agent endpoint get <endpoint-id>` | Get agent endpoint by ID |
|
|
122
|
+
| `roark agent endpoint list` | List agent endpoints |
|
|
123
|
+
| `roark agent endpoint update <endpoint-id>` | Update an agent endpoint |
|
|
124
|
+
| `roark agent get <agent-id>` | Get agent by ID |
|
|
125
|
+
| `roark agent list` | List agents |
|
|
126
|
+
| `roark agent prompt list <agent-id>` | List an agent's prompts |
|
|
127
|
+
| `roark agent prompt update <agent-id> --prompt <value>` | Set an agent's prompt |
|
|
128
|
+
| `roark agent prompt version list <agent-id> <prompt-id>` | List a prompt's versions |
|
|
129
|
+
| `roark agent update <agent-id>` | Update an agent |
|
|
130
|
+
| `roark agent version get <agent-id> <version-id>` | Get an agent version |
|
|
131
|
+
| `roark agent version list <agent-id>` | List an agent's versions |
|
|
132
|
+
| `roark agent version rollback <agent-id> <version-id>` | Roll an agent back to a version |
|
|
133
133
|
|
|
134
134
|
### agent-config
|
|
135
135
|
|
package/commands.js
CHANGED
|
@@ -140,6 +140,69 @@ exports.COMMANDS = [
|
|
|
140
140
|
valueKind: 'string',
|
|
141
141
|
repeatable: false,
|
|
142
142
|
},
|
|
143
|
+
{
|
|
144
|
+
name: 'tts.model',
|
|
145
|
+
path: ['tts', 'model'],
|
|
146
|
+
location: 'body',
|
|
147
|
+
required: false,
|
|
148
|
+
description: "The provider's voice model, for example eleven_flash_v2_5. Its current one when omitted",
|
|
149
|
+
valueKind: 'string',
|
|
150
|
+
repeatable: false,
|
|
151
|
+
},
|
|
152
|
+
{
|
|
153
|
+
name: 'stt',
|
|
154
|
+
path: ['stt'],
|
|
155
|
+
location: 'body',
|
|
156
|
+
required: false,
|
|
157
|
+
description: "Optional transcriber the hosted agent hears with. Roark's default when omitted",
|
|
158
|
+
valueKind: 'object',
|
|
159
|
+
},
|
|
160
|
+
{
|
|
161
|
+
name: 'stt.provider',
|
|
162
|
+
path: ['stt', 'provider'],
|
|
163
|
+
location: 'body',
|
|
164
|
+
required: true,
|
|
165
|
+
description: 'Speech-to-text provider, for example DEEPGRAM',
|
|
166
|
+
valueKind: 'string',
|
|
167
|
+
enumValues: ['DEEPGRAM', 'OPENAI_WHISPER', 'SPEECHMATICS', 'ASSEMBLYAI', 'ELEVENLABS'],
|
|
168
|
+
repeatable: false,
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
name: 'stt.model',
|
|
172
|
+
path: ['stt', 'model'],
|
|
173
|
+
location: 'body',
|
|
174
|
+
required: true,
|
|
175
|
+
description: "The provider's model id, for example nova-3",
|
|
176
|
+
valueKind: 'string',
|
|
177
|
+
repeatable: false,
|
|
178
|
+
},
|
|
179
|
+
{
|
|
180
|
+
name: 'llm',
|
|
181
|
+
path: ['llm'],
|
|
182
|
+
location: 'body',
|
|
183
|
+
required: false,
|
|
184
|
+
description: "Optional text model the hosted agent thinks with. Roark's default when omitted",
|
|
185
|
+
valueKind: 'object',
|
|
186
|
+
},
|
|
187
|
+
{
|
|
188
|
+
name: 'llm.provider',
|
|
189
|
+
path: ['llm', 'provider'],
|
|
190
|
+
location: 'body',
|
|
191
|
+
required: true,
|
|
192
|
+
description: 'Text model provider, for example OPENAI',
|
|
193
|
+
valueKind: 'string',
|
|
194
|
+
enumValues: ['OPENAI', 'ANTHROPIC', 'GOOGLE', 'XAI', 'ULTRAVOX', 'AWS', 'ELEVENLABS'],
|
|
195
|
+
repeatable: false,
|
|
196
|
+
},
|
|
197
|
+
{
|
|
198
|
+
name: 'llm.model',
|
|
199
|
+
path: ['llm', 'model'],
|
|
200
|
+
location: 'body',
|
|
201
|
+
required: true,
|
|
202
|
+
description: "The provider's model id, for example gpt-4.1",
|
|
203
|
+
valueKind: 'string',
|
|
204
|
+
repeatable: false,
|
|
205
|
+
},
|
|
143
206
|
],
|
|
144
207
|
hasParams: true,
|
|
145
208
|
paramsAllOptional: false,
|
|
@@ -314,7 +377,7 @@ exports.COMMANDS = [
|
|
|
314
377
|
commandPath: ['agent', 'draft', 'update'],
|
|
315
378
|
clientProperty: 'agentDraft',
|
|
316
379
|
methodName: 'update',
|
|
317
|
-
httpMethod: '
|
|
380
|
+
httpMethod: 'put',
|
|
318
381
|
httpPath: '/v1/agent/{agentId}/draft',
|
|
319
382
|
summary: 'Edit the draft',
|
|
320
383
|
description: 'Changes settings on the draft. Omitted settings stay as they are. Pass the revision you read as expectedRevision to fail with 409 if anyone edited the draft since, instead of applying on top of their edit.',
|
|
@@ -339,7 +402,7 @@ exports.COMMANDS = [
|
|
|
339
402
|
path: ['settings'],
|
|
340
403
|
location: 'body',
|
|
341
404
|
required: true,
|
|
342
|
-
description: 'The settings to change. Omitted settings stay as they are; null clears one to the runtime default. subAgents replaces every speaker and must include `main
|
|
405
|
+
description: 'The settings to change. Omitted settings stay as they are; null clears one to the runtime default. subAgents replaces every speaker, model configs included, and must include `main`; in a model config, omitted fields use the runtime default.',
|
|
343
406
|
valueKind: 'object',
|
|
344
407
|
},
|
|
345
408
|
{
|
|
@@ -384,105 +447,6 @@ exports.COMMANDS = [
|
|
|
384
447
|
valueKind: 'string',
|
|
385
448
|
repeatable: false,
|
|
386
449
|
},
|
|
387
|
-
{
|
|
388
|
-
name: 'settings.llm-provider',
|
|
389
|
-
path: ['settings', 'llmProvider'],
|
|
390
|
-
location: 'body',
|
|
391
|
-
required: false,
|
|
392
|
-
valueKind: 'string',
|
|
393
|
-
enumValues: ['OPENAI', 'ANTHROPIC', 'GOOGLE', 'XAI', 'ULTRAVOX', 'AWS', 'ELEVENLABS'],
|
|
394
|
-
repeatable: false,
|
|
395
|
-
},
|
|
396
|
-
{
|
|
397
|
-
name: 'settings.llm-model',
|
|
398
|
-
path: ['settings', 'llmModel'],
|
|
399
|
-
location: 'body',
|
|
400
|
-
required: false,
|
|
401
|
-
valueKind: 'string',
|
|
402
|
-
repeatable: false,
|
|
403
|
-
},
|
|
404
|
-
{
|
|
405
|
-
name: 'settings.llm-temperature',
|
|
406
|
-
path: ['settings', 'llmTemperature'],
|
|
407
|
-
location: 'body',
|
|
408
|
-
required: false,
|
|
409
|
-
valueKind: 'number',
|
|
410
|
-
repeatable: false,
|
|
411
|
-
},
|
|
412
|
-
{
|
|
413
|
-
name: 'settings.llm-max-tokens',
|
|
414
|
-
path: ['settings', 'llmMaxTokens'],
|
|
415
|
-
location: 'body',
|
|
416
|
-
required: false,
|
|
417
|
-
valueKind: 'integer',
|
|
418
|
-
repeatable: false,
|
|
419
|
-
},
|
|
420
|
-
{
|
|
421
|
-
name: 'settings.llm-backend-model',
|
|
422
|
-
path: ['settings', 'llmBackendModel'],
|
|
423
|
-
location: 'body',
|
|
424
|
-
required: false,
|
|
425
|
-
valueKind: 'string',
|
|
426
|
-
repeatable: false,
|
|
427
|
-
},
|
|
428
|
-
{
|
|
429
|
-
name: 'settings.llm-voice',
|
|
430
|
-
path: ['settings', 'llmVoice'],
|
|
431
|
-
location: 'body',
|
|
432
|
-
required: false,
|
|
433
|
-
valueKind: 'string',
|
|
434
|
-
repeatable: false,
|
|
435
|
-
},
|
|
436
|
-
{
|
|
437
|
-
name: 'settings.stt-provider',
|
|
438
|
-
path: ['settings', 'sttProvider'],
|
|
439
|
-
location: 'body',
|
|
440
|
-
required: false,
|
|
441
|
-
valueKind: 'string',
|
|
442
|
-
enumValues: ['DEEPGRAM', 'OPENAI_WHISPER', 'SPEECHMATICS', 'ASSEMBLYAI', 'ELEVENLABS'],
|
|
443
|
-
repeatable: false,
|
|
444
|
-
},
|
|
445
|
-
{
|
|
446
|
-
name: 'settings.stt-model',
|
|
447
|
-
path: ['settings', 'sttModel'],
|
|
448
|
-
location: 'body',
|
|
449
|
-
required: false,
|
|
450
|
-
valueKind: 'string',
|
|
451
|
-
repeatable: false,
|
|
452
|
-
},
|
|
453
|
-
{
|
|
454
|
-
name: 'settings.stt-keyterms',
|
|
455
|
-
path: ['settings', 'sttKeyterms'],
|
|
456
|
-
location: 'body',
|
|
457
|
-
required: false,
|
|
458
|
-
valueKind: 'array',
|
|
459
|
-
repeatable: true,
|
|
460
|
-
},
|
|
461
|
-
{
|
|
462
|
-
name: 'settings.stt-smart-format',
|
|
463
|
-
path: ['settings', 'sttSmartFormat'],
|
|
464
|
-
location: 'body',
|
|
465
|
-
required: false,
|
|
466
|
-
valueKind: 'boolean',
|
|
467
|
-
repeatable: false,
|
|
468
|
-
},
|
|
469
|
-
{
|
|
470
|
-
name: 'settings.stt-endpointing-ms',
|
|
471
|
-
path: ['settings', 'sttEndpointingMs'],
|
|
472
|
-
location: 'body',
|
|
473
|
-
required: false,
|
|
474
|
-
valueKind: 'integer',
|
|
475
|
-
repeatable: false,
|
|
476
|
-
},
|
|
477
|
-
{
|
|
478
|
-
name: 'settings.stt-turn-detection',
|
|
479
|
-
path: ['settings', 'sttTurnDetection'],
|
|
480
|
-
location: 'body',
|
|
481
|
-
required: false,
|
|
482
|
-
valueKind: 'string',
|
|
483
|
-
enumValues: ['pipeline', 'provider'],
|
|
484
|
-
repeatable: false,
|
|
485
|
-
},
|
|
486
450
|
{
|
|
487
451
|
name: 'settings.interruption-mode',
|
|
488
452
|
path: ['settings', 'interruptionMode'],
|
|
@@ -1098,13 +1062,13 @@ exports.COMMANDS = [
|
|
|
1098
1062
|
requiresAuth: true,
|
|
1099
1063
|
},
|
|
1100
1064
|
{
|
|
1101
|
-
commandPath: ['agent', 'version', '
|
|
1065
|
+
commandPath: ['agent', 'version', 'rollback'],
|
|
1102
1066
|
clientProperty: 'agentVersion',
|
|
1103
|
-
methodName: '
|
|
1067
|
+
methodName: 'rollback',
|
|
1104
1068
|
httpMethod: 'post',
|
|
1105
|
-
httpPath: '/v1/agent/{agentId}/versions/{versionId}/
|
|
1106
|
-
summary: '
|
|
1107
|
-
description: "
|
|
1069
|
+
httpPath: '/v1/agent/{agentId}/versions/{versionId}/rollback',
|
|
1070
|
+
summary: 'Roll an agent back to a version',
|
|
1071
|
+
description: "Publishes a new version, numbered after the latest, with this version's settings and makes it live. History stays append-only. An open draft started before this is kept but can no longer be published (409 `agent_draft_base_changed`); discard it or start a new one. Pass `expectedLiveVersionId` to be refused (409 `agent_live_version_changed`) if another version went live since you read it.",
|
|
1108
1072
|
positionals: [
|
|
1109
1073
|
{
|
|
1110
1074
|
name: 'agent-id',
|
|
@@ -1129,7 +1093,7 @@ exports.COMMANDS = [
|
|
|
1129
1093
|
path: ['expectedLiveVersionId'],
|
|
1130
1094
|
location: 'body',
|
|
1131
1095
|
required: false,
|
|
1132
|
-
description: 'The live version when you decided to
|
|
1096
|
+
description: 'The live version when you decided to roll back. When sent, the rollback is refused with 409 if another version went live since.',
|
|
1133
1097
|
valueKind: 'string',
|
|
1134
1098
|
repeatable: false,
|
|
1135
1099
|
},
|
|
@@ -2362,7 +2326,7 @@ exports.COMMANDS = [
|
|
|
2362
2326
|
httpMethod: 'get',
|
|
2363
2327
|
httpPath: '/v1/call',
|
|
2364
2328
|
summary: 'List calls',
|
|
2365
|
-
description: 'Returns a paginated list of calls for the authenticated project.',
|
|
2329
|
+
description: 'Returns a paginated list of calls for the authenticated project. Pass agentId to keep calls for specific agents, or properties[agent_name][eq] when you only have the agent name. sortBy and sortDirection apply together with those filters.',
|
|
2366
2330
|
positionals: [],
|
|
2367
2331
|
flags: [
|
|
2368
2332
|
{
|
|
@@ -2422,6 +2386,15 @@ exports.COMMANDS = [
|
|
|
2422
2386
|
valueKind: 'string',
|
|
2423
2387
|
repeatable: false,
|
|
2424
2388
|
},
|
|
2389
|
+
{
|
|
2390
|
+
name: 'agent-id',
|
|
2391
|
+
path: ['agentId'],
|
|
2392
|
+
location: 'query',
|
|
2393
|
+
required: false,
|
|
2394
|
+
description: 'Calls that include any of these agents. One id, or several separated by commas, at most 100. A call with more than one agent matches when any of them is listed. An id that is not an agent on a call in this project matches nothing. Combines with the other filters, including sortBy and sortDirection.',
|
|
2395
|
+
valueKind: 'string',
|
|
2396
|
+
repeatable: false,
|
|
2397
|
+
},
|
|
2425
2398
|
{
|
|
2426
2399
|
name: 'simulation-run-plan-job-id',
|
|
2427
2400
|
path: ['simulationRunPlanJobId'],
|
|
@@ -2474,7 +2447,7 @@ exports.COMMANDS = [
|
|
|
2474
2447
|
path: ['properties'],
|
|
2475
2448
|
location: 'query',
|
|
2476
2449
|
required: false,
|
|
2477
|
-
description: 'Filter on
|
|
2450
|
+
description: 'Filter on properties, one entry per property name. properties[<name>][exists]=true keeps calls that have the property set (whatever the value), properties[<name>][exists]=false keeps calls missing it (never sent, sent as null, or removed). properties[<name>][eq]=<value> keeps calls whose value equals it, ignoring case. agent_name and agent_id are built in and read the agents linked to the call, not a stored snapshot: agent_name matches an agent name, agent_id matches an agent id (a UUID). A call with several agents matches when any of them does. A custom property the project has never stored matches no calls under eq. Names match the way properties are stored, so planTier and plan_tier are one property, and agentName is agent_name. At most 20 properties. A name taken by a built-in call filter, such as status, is rejected with 400. One operator per property.',
|
|
2478
2451
|
valueKind: 'object',
|
|
2479
2452
|
repeatable: false,
|
|
2480
2453
|
},
|