@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 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 | Description |
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>` | 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 restore <agent-id> <version-id>` | Restore an 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: 'patch',
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', 'restore'],
1065
+ commandPath: ['agent', 'version', 'rollback'],
1102
1066
  clientProperty: 'agentVersion',
1103
- methodName: 'restore',
1067
+ methodName: 'rollback',
1104
1068
  httpMethod: 'post',
1105
- httpPath: '/v1/agent/{agentId}/versions/{versionId}/restore',
1106
- summary: 'Restore an agent version',
1107
- description: "Roll back: 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.",
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 restore. When sent, the restore is refused with 409 if another version went live since.',
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 custom 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). A property the project has never seen is missing on every call. Names match the way properties are stored, so planTier and plan_tier are one property. At most 20 properties; a name taken by a built-in call filter, such as status, is rejected with 400.',
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
  },