@roarkanalytics/cli 0.59.1 → 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 +11 -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/man/roark-agent-build.1
CHANGED
|
@@ -28,6 +28,27 @@ Text\-to\-speech provider, for example ELEVENLABS One of: CARTESIA, ELEVENLABS,
|
|
|
28
28
|
.TP
|
|
29
29
|
\fB\-\-tts.voice\-id\fR \fI<value>\fR
|
|
30
30
|
The provider's id for the voice Required.
|
|
31
|
+
.TP
|
|
32
|
+
\fB\-\-tts.model\fR \fI<value>\fR
|
|
33
|
+
The provider's voice model, for example eleven_flash_v2_5. Its current one when omitted Optional.
|
|
34
|
+
.TP
|
|
35
|
+
\fB\-\-stt\fR \fI<value>\fR
|
|
36
|
+
Optional transcriber the hosted agent hears with. Roark's default when omitted Optional.
|
|
37
|
+
.TP
|
|
38
|
+
\fB\-\-stt.provider\fR \fI<value>\fR
|
|
39
|
+
Speech\-to\-text provider, for example DEEPGRAM One of: DEEPGRAM, OPENAI_WHISPER, SPEECHMATICS, ASSEMBLYAI, ELEVENLABS. Required.
|
|
40
|
+
.TP
|
|
41
|
+
\fB\-\-stt.model\fR \fI<value>\fR
|
|
42
|
+
The provider's model id, for example nova\-3 Required.
|
|
43
|
+
.TP
|
|
44
|
+
\fB\-\-llm\fR \fI<value>\fR
|
|
45
|
+
Optional text model the hosted agent thinks with. Roark's default when omitted Optional.
|
|
46
|
+
.TP
|
|
47
|
+
\fB\-\-llm.provider\fR \fI<value>\fR
|
|
48
|
+
Text model provider, for example OPENAI One of: OPENAI, ANTHROPIC, GOOGLE, XAI, ULTRAVOX, AWS, ELEVENLABS. Required.
|
|
49
|
+
.TP
|
|
50
|
+
\fB\-\-llm.model\fR \fI<value>\fR
|
|
51
|
+
The provider's model id, for example gpt\-4.1 Required.
|
|
31
52
|
.SH "GLOBAL OPTIONS"
|
|
32
53
|
.TP
|
|
33
54
|
\fB\-\-data\fR \fI<json>\fR
|
|
@@ -69,7 +90,7 @@ Send the stored credential to a base URL set by a project .roark.json. Refused b
|
|
|
69
90
|
.PP
|
|
70
91
|
.RS 4
|
|
71
92
|
.nf
|
|
72
|
-
roark agent build \-\-name <value> \-\-job\-description <value> \-\-tts.provider <value> \-\-tts.voice\-id <value>
|
|
93
|
+
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>
|
|
73
94
|
.fi
|
|
74
95
|
.RE
|
|
75
96
|
.SH "ENVIRONMENT"
|
|
@@ -8,7 +8,7 @@ roark\-agent\-draft\-update \- Edit the draft
|
|
|
8
8
|
.SH "DESCRIPTION"
|
|
9
9
|
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.
|
|
10
10
|
.SH "API"
|
|
11
|
-
|
|
11
|
+
PUT /v1/agent/{agentId}/draft
|
|
12
12
|
.SH "ARGUMENTS"
|
|
13
13
|
.TP
|
|
14
14
|
\fIagent\-id\fR
|
|
@@ -19,7 +19,7 @@ The agent\-id.
|
|
|
19
19
|
The draft's revision when you read it. When sent, the edit is refused if the draft changed since; when omitted, it applies on top of the latest edit. Optional.
|
|
20
20
|
.TP
|
|
21
21
|
\fB\-\-settings\fR \fI<value>\fR
|
|
22
|
-
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
|
|
22
|
+
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. Required.
|
|
23
23
|
.TP
|
|
24
24
|
\fB\-\-settings.modalities\fR \fI<value>\fR
|
|
25
25
|
One of: call, chat. Repeatable. Optional.
|
|
@@ -36,42 +36,6 @@ Optional.
|
|
|
36
36
|
\fB\-\-settings.first\-message\-audio\-url\fR \fI<value>\fR
|
|
37
37
|
Optional.
|
|
38
38
|
.TP
|
|
39
|
-
\fB\-\-settings.llm\-provider\fR \fI<value>\fR
|
|
40
|
-
One of: OPENAI, ANTHROPIC, GOOGLE, XAI, ULTRAVOX, AWS, ELEVENLABS. Optional.
|
|
41
|
-
.TP
|
|
42
|
-
\fB\-\-settings.llm\-model\fR \fI<value>\fR
|
|
43
|
-
Optional.
|
|
44
|
-
.TP
|
|
45
|
-
\fB\-\-settings.llm\-temperature\fR \fI<value>\fR
|
|
46
|
-
Optional.
|
|
47
|
-
.TP
|
|
48
|
-
\fB\-\-settings.llm\-max\-tokens\fR \fI<value>\fR
|
|
49
|
-
Optional.
|
|
50
|
-
.TP
|
|
51
|
-
\fB\-\-settings.llm\-backend\-model\fR \fI<value>\fR
|
|
52
|
-
Optional.
|
|
53
|
-
.TP
|
|
54
|
-
\fB\-\-settings.llm\-voice\fR \fI<value>\fR
|
|
55
|
-
Optional.
|
|
56
|
-
.TP
|
|
57
|
-
\fB\-\-settings.stt\-provider\fR \fI<value>\fR
|
|
58
|
-
One of: DEEPGRAM, OPENAI_WHISPER, SPEECHMATICS, ASSEMBLYAI, ELEVENLABS. Optional.
|
|
59
|
-
.TP
|
|
60
|
-
\fB\-\-settings.stt\-model\fR \fI<value>\fR
|
|
61
|
-
Optional.
|
|
62
|
-
.TP
|
|
63
|
-
\fB\-\-settings.stt\-keyterms\fR \fI<value>\fR
|
|
64
|
-
Repeatable. Optional.
|
|
65
|
-
.TP
|
|
66
|
-
\fB\-\-settings.stt\-smart\-format\fR
|
|
67
|
-
Optional.
|
|
68
|
-
.TP
|
|
69
|
-
\fB\-\-settings.stt\-endpointing\-ms\fR \fI<value>\fR
|
|
70
|
-
Optional.
|
|
71
|
-
.TP
|
|
72
|
-
\fB\-\-settings.stt\-turn\-detection\fR \fI<value>\fR
|
|
73
|
-
One of: pipeline, provider. Optional.
|
|
74
|
-
.TP
|
|
75
39
|
\fB\-\-settings.interruption\-mode\fR \fI<value>\fR
|
|
76
40
|
One of: ALLOW, BLOCK. Optional.
|
|
77
41
|
.TP
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
.\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
|
|
2
|
-
.TH "ROARK\-AGENT\-VERSION\-
|
|
2
|
+
.TH "ROARK\-AGENT\-VERSION\-ROLLBACK" "1" "" "roark-agent-version-rollback" "Roark Analytics API Manual"
|
|
3
3
|
.SH "NAME"
|
|
4
|
-
roark\-agent\-version\-
|
|
4
|
+
roark\-agent\-version\-rollback \- Roll an agent back to a version
|
|
5
5
|
.SH "SYNOPSIS"
|
|
6
|
-
.B roark agent version
|
|
6
|
+
.B roark agent version rollback
|
|
7
7
|
\fIagent\-id\fR \fIversion\-id\fR [\fIoptions\fR]
|
|
8
8
|
.SH "DESCRIPTION"
|
|
9
|
-
|
|
9
|
+
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.
|
|
10
10
|
.SH "API"
|
|
11
|
-
POST /v1/agent/{agentId}/versions/{versionId}/
|
|
11
|
+
POST /v1/agent/{agentId}/versions/{versionId}/rollback
|
|
12
12
|
.SH "ARGUMENTS"
|
|
13
13
|
.TP
|
|
14
14
|
\fIagent\-id\fR
|
|
@@ -22,7 +22,7 @@ The version\-id.
|
|
|
22
22
|
Optional.
|
|
23
23
|
.TP
|
|
24
24
|
\fB\-\-expected\-live\-version\-id\fR \fI<value>\fR
|
|
25
|
-
The live version when you decided to
|
|
25
|
+
The live version when you decided to roll back. When sent, the rollback is refused with 409 if another version went live since. Optional.
|
|
26
26
|
.SH "GLOBAL OPTIONS"
|
|
27
27
|
.TP
|
|
28
28
|
\fB\-\-data\fR \fI<json>\fR
|
|
@@ -64,7 +64,7 @@ Send the stored credential to a base URL set by a project .roark.json. Refused b
|
|
|
64
64
|
.PP
|
|
65
65
|
.RS 4
|
|
66
66
|
.nf
|
|
67
|
-
roark agent version
|
|
67
|
+
roark agent version rollback <agent\-id> <version\-id>
|
|
68
68
|
.fi
|
|
69
69
|
.RE
|
|
70
70
|
.SH "ENVIRONMENT"
|
package/man/roark-call-list.1
CHANGED
|
@@ -6,7 +6,7 @@ roark\-call\-list \- List calls
|
|
|
6
6
|
.B roark call list
|
|
7
7
|
[\fIoptions\fR]
|
|
8
8
|
.SH "DESCRIPTION"
|
|
9
|
-
Returns a paginated list of calls for the authenticated project.
|
|
9
|
+
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.
|
|
10
10
|
.SH "API"
|
|
11
11
|
GET /v1/call
|
|
12
12
|
.SH "OPTIONS"
|
|
@@ -29,6 +29,9 @@ Filter by call status One of: RINGING, IN_PROGRESS, ENDED. Optional.
|
|
|
29
29
|
\fB\-\-search\-text\fR \fI<value>\fR
|
|
30
30
|
Search text to filter calls by title, summary, or transcript Optional.
|
|
31
31
|
.TP
|
|
32
|
+
\fB\-\-agent\-id\fR \fI<value>\fR
|
|
33
|
+
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. Optional.
|
|
34
|
+
.TP
|
|
32
35
|
\fB\-\-simulation\-run\-plan\-job\-id\fR \fI<value>\fR
|
|
33
36
|
Filter by simulation run plan job ID to get all calls from a specific simulation batch Optional.
|
|
34
37
|
.TP
|
|
@@ -45,7 +48,7 @@ true: only simulated calls their run's results count (not invalidated, for examp
|
|
|
45
48
|
true: leave out calls from runs hidden from the runs list. Live calls stay in. false is the same as leaving it out. One of: true, false. Optional.
|
|
46
49
|
.TP
|
|
47
50
|
\fB\-\-properties\fR \fI<value>\fR
|
|
48
|
-
Filter on
|
|
51
|
+
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. Optional.
|
|
49
52
|
.SH "GLOBAL OPTIONS"
|
|
50
53
|
.TP
|
|
51
54
|
\fB\-\-data\fR \fI<json>\fR
|
package/man/roark.1
CHANGED
|
@@ -117,8 +117,8 @@ Get an agent version See roark\-agent\-version\-get(1).
|
|
|
117
117
|
\fBroark agent version list\fR
|
|
118
118
|
List an agent's versions See roark\-agent\-version\-list(1).
|
|
119
119
|
.TP
|
|
120
|
-
\fBroark agent version
|
|
121
|
-
|
|
120
|
+
\fBroark agent version rollback\fR
|
|
121
|
+
Roll an agent back to a version See roark\-agent\-version\-rollback(1).
|
|
122
122
|
.TP
|
|
123
123
|
\fBroark agent\-config get\fR
|
|
124
124
|
Get a managed config See roark\-agent\-config\-get(1).
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@roarkanalytics/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.60.0",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "@roarkanalytics/cli",
|
|
9
|
-
"version": "0.
|
|
9
|
+
"version": "0.60.0",
|
|
10
10
|
"license": "Apache-2.0",
|
|
11
11
|
"dependencies": {
|
|
12
|
-
"@roarkanalytics/sdk": "^
|
|
12
|
+
"@roarkanalytics/sdk": "^6.0.0",
|
|
13
13
|
"commander": "^14.0.3",
|
|
14
14
|
"jiti": "^2.4.2",
|
|
15
15
|
"yaml": "^2.9.0"
|
|
@@ -22,9 +22,9 @@
|
|
|
22
22
|
}
|
|
23
23
|
},
|
|
24
24
|
"node_modules/@roarkanalytics/sdk": {
|
|
25
|
-
"version": "
|
|
26
|
-
"resolved": "https://registry.npmjs.org/@roarkanalytics/sdk/-/sdk-
|
|
27
|
-
"integrity": "sha512-
|
|
25
|
+
"version": "6.1.0",
|
|
26
|
+
"resolved": "https://registry.npmjs.org/@roarkanalytics/sdk/-/sdk-6.1.0.tgz",
|
|
27
|
+
"integrity": "sha512-CFoOfKUJWp/nLKLdCeIa1yGZ6KB40kVXJdYzVeEBQnw193YLO2MV7uJv4mlokLcGJcSJKY3Y63D3oHUIjD2B2A==",
|
|
28
28
|
"license": "Apache-2.0"
|
|
29
29
|
},
|
|
30
30
|
"node_modules/commander": {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@roarkanalytics/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.60.0",
|
|
4
4
|
"description": "The official command line interface for the Roark API",
|
|
5
5
|
"author": "Roark <james@roark.ai>",
|
|
6
6
|
"type": "commonjs",
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"fix": "eslint --fix . && prettier --write ."
|
|
30
30
|
},
|
|
31
31
|
"dependencies": {
|
|
32
|
-
"@roarkanalytics/sdk": "^
|
|
32
|
+
"@roarkanalytics/sdk": "^6.0.0",
|
|
33
33
|
"commander": "^14.0.3",
|
|
34
34
|
"jiti": "^2.4.2",
|
|
35
35
|
"yaml": "^2.9.0"
|
|
@@ -55,7 +55,7 @@
|
|
|
55
55
|
"./man/roark-agent-update.1",
|
|
56
56
|
"./man/roark-agent-version-get.1",
|
|
57
57
|
"./man/roark-agent-version-list.1",
|
|
58
|
-
"./man/roark-agent-version-
|
|
58
|
+
"./man/roark-agent-version-rollback.1",
|
|
59
59
|
"./man/roark-agent-config-get.1",
|
|
60
60
|
"./man/roark-agent-config-list.1",
|
|
61
61
|
"./man/roark-agent-config-promote.1",
|
package/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const version = "0.
|
|
1
|
+
export declare const version = "0.60.0";
|
package/version.js
CHANGED