@roarkanalytics/cli 0.61.1 → 0.67.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.
@@ -0,0 +1,103 @@
1
+ .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
+ .TH "ROARK\-CALENDAR\-CONNECTION\-UPDATE" "1" "" "roark-calendar-connection-update" "Roark Analytics API Manual"
3
+ .SH "NAME"
4
+ roark\-calendar\-connection\-update \- Update a calendar connection
5
+ .SH "SYNOPSIS"
6
+ .B roark calendar\-connection update
7
+ \fIconnection\-id\fR [\fIoptions\fR]
8
+ .SH "DESCRIPTION"
9
+ Renames a connection, changes the timezone slots are offered in, or rotates the credential. A rotated credential is verified first, and a verified credential returns the connection to ACTIVE.
10
+ .SH "API"
11
+ PATCH /v1/calendar\-connection/{connectionId}
12
+ .SH "ARGUMENTS"
13
+ .TP
14
+ \fIconnection\-id\fR
15
+ Calendar connection ID
16
+ .SH "OPTIONS"
17
+ .TP
18
+ \fB\-\-label\fR \fI<value>\fR
19
+ Rename the connection. Optional.
20
+ .TP
21
+ \fB\-\-timezone\fR \fI<value>\fR
22
+ Change the named IANA timezone slots are offered in. Optional.
23
+ .TP
24
+ \fB\-\-api\-key\fR \fI<value>\fR
25
+ Rotate the credential. The new key is verified before it is stored, and a verified key returns the connection to ACTIVE, which is how a connection recovers from INVALID_CREDENTIALS. Optional.
26
+ .SH "GLOBAL OPTIONS"
27
+ .TP
28
+ \fB\-\-data\fR \fI<json>\fR
29
+ Request body as JSON, or @file to read one (@\- for stdin).
30
+ .TP
31
+ \fB\-y\fR, \fB\-\-yes\fR
32
+ Skip confirmation prompts.
33
+ .TP
34
+ \fB\-\-no\-input\fR
35
+ Never prompt; fail instead.
36
+ .TP
37
+ \fB\-\-base\-url\fR \fI<url>\fR
38
+ API base URL.
39
+ .TP
40
+ \fB\-\-token\fR \fI<token>\fR
41
+ Bearer token. Prefer ROARK_API_BEARER_TOKEN or the stored credential.
42
+ .TP
43
+ \fB\-\-timeout\fR \fI<ms>\fR
44
+ Request timeout in milliseconds.
45
+ .TP
46
+ \fB\-\-max\-retries\fR \fI<count>\fR
47
+ Retries for retryable failures.
48
+ .TP
49
+ \fB\-\-format\fR \fI<format>\fR
50
+ Output format: auto, json, jsonl, plain.
51
+ .TP
52
+ \fB\-\-json\fR
53
+ Shorthand for \-\-format json.
54
+ .TP
55
+ \fB\-\-no\-color\fR
56
+ Disable colour.
57
+ .TP
58
+ \fB\-q\fR, \fB\-\-quiet\fR
59
+ Suppress non\-essential output.
60
+ .TP
61
+ \fB\-\-allow\-project\-base\-url\fR
62
+ Send the stored credential to a base URL set by a project .roark.json. Refused by default.
63
+ .SH "EXAMPLES"
64
+ .PP
65
+ .RS 4
66
+ .nf
67
+ roark calendar\-connection update <connection\-id>
68
+ .fi
69
+ .RE
70
+ .SH "ENVIRONMENT"
71
+ .TP
72
+ \fBROARK_API_BEARER_TOKEN\fR
73
+ Bearer token used when \-\-token is not given.
74
+ .TP
75
+ \fBROARK_BASE_URL\fR
76
+ API base URL.
77
+ .TP
78
+ \fBROARK_ALLOW_PROJECT_BASE_URL\fR
79
+ Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
80
+ .TP
81
+ \fBNO_COLOR\fR
82
+ Disables colour when set to any value.
83
+ .SH "EXIT STATUS"
84
+ .TP
85
+ \fB0\fR
86
+ The command succeeded.
87
+ .TP
88
+ \fB1\fR
89
+ The API rejected the request.
90
+ .TP
91
+ \fB2\fR
92
+ The command line was wrong.
93
+ .TP
94
+ \fB3\fR
95
+ No credential, or the credential was refused.
96
+ .TP
97
+ \fB4\fR
98
+ The addressed resource does not exist.
99
+ .TP
100
+ \fB5\fR
101
+ The request never completed: connection, timeout, or abort.
102
+ .SH "SEE ALSO"
103
+ .BR roark (1)
@@ -36,6 +36,9 @@ New label for the true case (BOOLEAN output only) Optional.
36
36
  \fB\-\-boolean\-false\-label\fR \fI<value>\fR
37
37
  New label for the false case (BOOLEAN output only) Optional.
38
38
  .TP
39
+ \fB\-\-grades\-short\-calls\fR
40
+ Score this metric on a simulated call with fewer than 4 transcript lines. Such calls skip every other metric. Default false. Optional.
41
+ .TP
39
42
  \fB\-\-classification\-options\fR \fI<value>\fR
40
43
  Replacement set of classification options (CLASSIFICATION output only) Optional.
41
44
  .TP
@@ -36,6 +36,9 @@ What a `true` value means. Given to the judge as its polarity rule, so keep it a
36
36
  \fB\-\-boolean\-false\-label\fR \fI<value>\fR
37
37
  What a `false` value means. Given to the judge as its polarity rule, so keep it accurate. Optional.
38
38
  .TP
39
+ \fB\-\-grades\-short\-calls\fR
40
+ Score this metric on a simulated call with fewer than 4 transcript lines. Such calls skip every other metric. Default false. Optional.
41
+ .TP
39
42
  \fB\-\-max\-classifications\fR \fI<value>\fR
40
43
  Maximum classifications returned. CLASSIFICATION output only. Optional.
41
44
  .TP
@@ -0,0 +1,123 @@
1
+ .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
+ .TH "ROARK\-TOOL\-CREATE" "1" "" "roark-tool-create" "Roark Analytics API Manual"
3
+ .SH "NAME"
4
+ roark\-tool\-create \- Create a tool
5
+ .SH "SYNOPSIS"
6
+ .B roark tool create
7
+ [\fIoptions\fR]
8
+ .SH "DESCRIPTION"
9
+ Creates a tool and declares its first version. A tool only recorded from calls under the same name is adopted; one already declared returns 409. Give it a `runtime` for a hosted agent to call your endpoint. Header values are returned on read, so keep secrets out of them.
10
+ .SH "API"
11
+ POST /v1/tool
12
+ .SH "OPTIONS"
13
+ .TP
14
+ \fB\-\-name\fR \fI<value>\fR
15
+ Required.
16
+ .TP
17
+ \fB\-\-description\fR \fI<value>\fR
18
+ When the agent should use the tool Required.
19
+ .TP
20
+ \fB\-\-agent\-id\fR \fI<value>\fR
21
+ Optional.
22
+ .TP
23
+ \fB\-\-inputs\fR \fI<value>\fR
24
+ Optional.
25
+ .TP
26
+ \fB\-\-invocation\-criteria\fR \fI<value>\fR
27
+ Optional.
28
+ .TP
29
+ \fB\-\-expected\-result\fR \fI<value>\fR
30
+ Optional.
31
+ .TP
32
+ \fB\-\-runtime\fR \fI<value>\fR
33
+ Omit or null for a tool that is only graded Optional.
34
+ .TP
35
+ \fB\-\-runtime.request\fR \fI<value>\fR
36
+ Required.
37
+ .TP
38
+ \fB\-\-runtime.changes\-data\fR
39
+ Optional.
40
+ .TP
41
+ \fB\-\-runtime.response\-fields\fR \fI<value>\fR
42
+ Repeatable. Optional.
43
+ .TP
44
+ \fB\-\-runtime.messages\fR \fI<value>\fR
45
+ Optional.
46
+ .SH "GLOBAL OPTIONS"
47
+ .TP
48
+ \fB\-\-data\fR \fI<json>\fR
49
+ Request body as JSON, or @file to read one (@\- for stdin).
50
+ .TP
51
+ \fB\-y\fR, \fB\-\-yes\fR
52
+ Skip confirmation prompts.
53
+ .TP
54
+ \fB\-\-no\-input\fR
55
+ Never prompt; fail instead.
56
+ .TP
57
+ \fB\-\-base\-url\fR \fI<url>\fR
58
+ API base URL.
59
+ .TP
60
+ \fB\-\-token\fR \fI<token>\fR
61
+ Bearer token. Prefer ROARK_API_BEARER_TOKEN or the stored credential.
62
+ .TP
63
+ \fB\-\-timeout\fR \fI<ms>\fR
64
+ Request timeout in milliseconds.
65
+ .TP
66
+ \fB\-\-max\-retries\fR \fI<count>\fR
67
+ Retries for retryable failures.
68
+ .TP
69
+ \fB\-\-format\fR \fI<format>\fR
70
+ Output format: auto, json, jsonl, plain.
71
+ .TP
72
+ \fB\-\-json\fR
73
+ Shorthand for \-\-format json.
74
+ .TP
75
+ \fB\-\-no\-color\fR
76
+ Disable colour.
77
+ .TP
78
+ \fB\-q\fR, \fB\-\-quiet\fR
79
+ Suppress non\-essential output.
80
+ .TP
81
+ \fB\-\-allow\-project\-base\-url\fR
82
+ Send the stored credential to a base URL set by a project .roark.json. Refused by default.
83
+ .SH "EXAMPLES"
84
+ .PP
85
+ .RS 4
86
+ .nf
87
+ roark tool create \-\-name <value> \-\-description <value> \-\-runtime.request <value>
88
+ .fi
89
+ .RE
90
+ .SH "ENVIRONMENT"
91
+ .TP
92
+ \fBROARK_API_BEARER_TOKEN\fR
93
+ Bearer token used when \-\-token is not given.
94
+ .TP
95
+ \fBROARK_BASE_URL\fR
96
+ API base URL.
97
+ .TP
98
+ \fBROARK_ALLOW_PROJECT_BASE_URL\fR
99
+ Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
100
+ .TP
101
+ \fBNO_COLOR\fR
102
+ Disables colour when set to any value.
103
+ .SH "EXIT STATUS"
104
+ .TP
105
+ \fB0\fR
106
+ The command succeeded.
107
+ .TP
108
+ \fB1\fR
109
+ The API rejected the request.
110
+ .TP
111
+ \fB2\fR
112
+ The command line was wrong.
113
+ .TP
114
+ \fB3\fR
115
+ No credential, or the credential was refused.
116
+ .TP
117
+ \fB4\fR
118
+ The addressed resource does not exist.
119
+ .TP
120
+ \fB5\fR
121
+ The request never completed: connection, timeout, or abort.
122
+ .SH "SEE ALSO"
123
+ .BR roark (1)
@@ -0,0 +1,93 @@
1
+ .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
+ .TH "ROARK\-TOOL\-DELETE" "1" "" "roark-tool-delete" "Roark Analytics API Manual"
3
+ .SH "NAME"
4
+ roark\-tool\-delete \- Delete a tool
5
+ .SH "SYNOPSIS"
6
+ .B roark tool delete
7
+ \fItool\-id\fR [\fIoptions\fR]
8
+ .SH "DESCRIPTION"
9
+ Deletes a tool no agent version uses. A tool an agent version uses returns 409.
10
+ .SH "API"
11
+ DELETE /v1/tool/{toolId}
12
+ .SH "ARGUMENTS"
13
+ .TP
14
+ \fItool\-id\fR
15
+ The tool\-id.
16
+ .SH "GLOBAL OPTIONS"
17
+ .TP
18
+ \fB\-\-data\fR \fI<json>\fR
19
+ Request body as JSON, or @file to read one (@\- for stdin).
20
+ .TP
21
+ \fB\-y\fR, \fB\-\-yes\fR
22
+ Skip confirmation prompts.
23
+ .TP
24
+ \fB\-\-no\-input\fR
25
+ Never prompt; fail instead.
26
+ .TP
27
+ \fB\-\-base\-url\fR \fI<url>\fR
28
+ API base URL.
29
+ .TP
30
+ \fB\-\-token\fR \fI<token>\fR
31
+ Bearer token. Prefer ROARK_API_BEARER_TOKEN or the stored credential.
32
+ .TP
33
+ \fB\-\-timeout\fR \fI<ms>\fR
34
+ Request timeout in milliseconds.
35
+ .TP
36
+ \fB\-\-max\-retries\fR \fI<count>\fR
37
+ Retries for retryable failures.
38
+ .TP
39
+ \fB\-\-format\fR \fI<format>\fR
40
+ Output format: auto, json, jsonl, plain.
41
+ .TP
42
+ \fB\-\-json\fR
43
+ Shorthand for \-\-format json.
44
+ .TP
45
+ \fB\-\-no\-color\fR
46
+ Disable colour.
47
+ .TP
48
+ \fB\-q\fR, \fB\-\-quiet\fR
49
+ Suppress non\-essential output.
50
+ .TP
51
+ \fB\-\-allow\-project\-base\-url\fR
52
+ Send the stored credential to a base URL set by a project .roark.json. Refused by default.
53
+ .SH "EXAMPLES"
54
+ .PP
55
+ .RS 4
56
+ .nf
57
+ roark tool delete <tool\-id>
58
+ .fi
59
+ .RE
60
+ .SH "ENVIRONMENT"
61
+ .TP
62
+ \fBROARK_API_BEARER_TOKEN\fR
63
+ Bearer token used when \-\-token is not given.
64
+ .TP
65
+ \fBROARK_BASE_URL\fR
66
+ API base URL.
67
+ .TP
68
+ \fBROARK_ALLOW_PROJECT_BASE_URL\fR
69
+ Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
70
+ .TP
71
+ \fBNO_COLOR\fR
72
+ Disables colour when set to any value.
73
+ .SH "EXIT STATUS"
74
+ .TP
75
+ \fB0\fR
76
+ The command succeeded.
77
+ .TP
78
+ \fB1\fR
79
+ The API rejected the request.
80
+ .TP
81
+ \fB2\fR
82
+ The command line was wrong.
83
+ .TP
84
+ \fB3\fR
85
+ No credential, or the credential was refused.
86
+ .TP
87
+ \fB4\fR
88
+ The addressed resource does not exist.
89
+ .TP
90
+ \fB5\fR
91
+ The request never completed: connection, timeout, or abort.
92
+ .SH "SEE ALSO"
93
+ .BR roark (1)
@@ -0,0 +1,93 @@
1
+ .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
+ .TH "ROARK\-TOOL\-GET" "1" "" "roark-tool-get" "Roark Analytics API Manual"
3
+ .SH "NAME"
4
+ roark\-tool\-get \- Get a tool
5
+ .SH "SYNOPSIS"
6
+ .B roark tool get
7
+ \fItool\-id\fR [\fIoptions\fR]
8
+ .SH "DESCRIPTION"
9
+ Get a tool
10
+ .SH "API"
11
+ GET /v1/tool/{toolId}
12
+ .SH "ARGUMENTS"
13
+ .TP
14
+ \fItool\-id\fR
15
+ The tool\-id.
16
+ .SH "GLOBAL OPTIONS"
17
+ .TP
18
+ \fB\-\-data\fR \fI<json>\fR
19
+ Request body as JSON, or @file to read one (@\- for stdin).
20
+ .TP
21
+ \fB\-y\fR, \fB\-\-yes\fR
22
+ Skip confirmation prompts.
23
+ .TP
24
+ \fB\-\-no\-input\fR
25
+ Never prompt; fail instead.
26
+ .TP
27
+ \fB\-\-base\-url\fR \fI<url>\fR
28
+ API base URL.
29
+ .TP
30
+ \fB\-\-token\fR \fI<token>\fR
31
+ Bearer token. Prefer ROARK_API_BEARER_TOKEN or the stored credential.
32
+ .TP
33
+ \fB\-\-timeout\fR \fI<ms>\fR
34
+ Request timeout in milliseconds.
35
+ .TP
36
+ \fB\-\-max\-retries\fR \fI<count>\fR
37
+ Retries for retryable failures.
38
+ .TP
39
+ \fB\-\-format\fR \fI<format>\fR
40
+ Output format: auto, json, jsonl, plain.
41
+ .TP
42
+ \fB\-\-json\fR
43
+ Shorthand for \-\-format json.
44
+ .TP
45
+ \fB\-\-no\-color\fR
46
+ Disable colour.
47
+ .TP
48
+ \fB\-q\fR, \fB\-\-quiet\fR
49
+ Suppress non\-essential output.
50
+ .TP
51
+ \fB\-\-allow\-project\-base\-url\fR
52
+ Send the stored credential to a base URL set by a project .roark.json. Refused by default.
53
+ .SH "EXAMPLES"
54
+ .PP
55
+ .RS 4
56
+ .nf
57
+ roark tool get <tool\-id>
58
+ .fi
59
+ .RE
60
+ .SH "ENVIRONMENT"
61
+ .TP
62
+ \fBROARK_API_BEARER_TOKEN\fR
63
+ Bearer token used when \-\-token is not given.
64
+ .TP
65
+ \fBROARK_BASE_URL\fR
66
+ API base URL.
67
+ .TP
68
+ \fBROARK_ALLOW_PROJECT_BASE_URL\fR
69
+ Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
70
+ .TP
71
+ \fBNO_COLOR\fR
72
+ Disables colour when set to any value.
73
+ .SH "EXIT STATUS"
74
+ .TP
75
+ \fB0\fR
76
+ The command succeeded.
77
+ .TP
78
+ \fB1\fR
79
+ The API rejected the request.
80
+ .TP
81
+ \fB2\fR
82
+ The command line was wrong.
83
+ .TP
84
+ \fB3\fR
85
+ No credential, or the credential was refused.
86
+ .TP
87
+ \fB4\fR
88
+ The addressed resource does not exist.
89
+ .TP
90
+ \fB5\fR
91
+ The request never completed: connection, timeout, or abort.
92
+ .SH "SEE ALSO"
93
+ .BR roark (1)
@@ -0,0 +1,96 @@
1
+ .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
+ .TH "ROARK\-TOOL\-LIST" "1" "" "roark-tool-list" "Roark Analytics API Manual"
3
+ .SH "NAME"
4
+ roark\-tool\-list \- List tools
5
+ .SH "SYNOPSIS"
6
+ .B roark tool list
7
+ [\fIoptions\fR]
8
+ .SH "DESCRIPTION"
9
+ The project's tools and the built\-in ones, each with its latest version: inputs, description and, for a tool a hosted agent runs, its request. Attach one to an agent draft by id.
10
+ .SH "API"
11
+ GET /v1/tool
12
+ .SH "OPTIONS"
13
+ .TP
14
+ \fB\-\-agent\-id\fR \fI<value>\fR
15
+ Only tools scoped to this agent Optional.
16
+ .TP
17
+ \fB\-\-include\-built\-in\fR \fI<value>\fR
18
+ Include the built\-in tools (default true) One of: true, false. Optional.
19
+ .SH "GLOBAL OPTIONS"
20
+ .TP
21
+ \fB\-\-data\fR \fI<json>\fR
22
+ Request body as JSON, or @file to read one (@\- for stdin).
23
+ .TP
24
+ \fB\-y\fR, \fB\-\-yes\fR
25
+ Skip confirmation prompts.
26
+ .TP
27
+ \fB\-\-no\-input\fR
28
+ Never prompt; fail instead.
29
+ .TP
30
+ \fB\-\-base\-url\fR \fI<url>\fR
31
+ API base URL.
32
+ .TP
33
+ \fB\-\-token\fR \fI<token>\fR
34
+ Bearer token. Prefer ROARK_API_BEARER_TOKEN or the stored credential.
35
+ .TP
36
+ \fB\-\-timeout\fR \fI<ms>\fR
37
+ Request timeout in milliseconds.
38
+ .TP
39
+ \fB\-\-max\-retries\fR \fI<count>\fR
40
+ Retries for retryable failures.
41
+ .TP
42
+ \fB\-\-format\fR \fI<format>\fR
43
+ Output format: auto, json, jsonl, plain.
44
+ .TP
45
+ \fB\-\-json\fR
46
+ Shorthand for \-\-format json.
47
+ .TP
48
+ \fB\-\-no\-color\fR
49
+ Disable colour.
50
+ .TP
51
+ \fB\-q\fR, \fB\-\-quiet\fR
52
+ Suppress non\-essential output.
53
+ .TP
54
+ \fB\-\-allow\-project\-base\-url\fR
55
+ Send the stored credential to a base URL set by a project .roark.json. Refused by default.
56
+ .SH "EXAMPLES"
57
+ .PP
58
+ .RS 4
59
+ .nf
60
+ roark tool list
61
+ .fi
62
+ .RE
63
+ .SH "ENVIRONMENT"
64
+ .TP
65
+ \fBROARK_API_BEARER_TOKEN\fR
66
+ Bearer token used when \-\-token is not given.
67
+ .TP
68
+ \fBROARK_BASE_URL\fR
69
+ API base URL.
70
+ .TP
71
+ \fBROARK_ALLOW_PROJECT_BASE_URL\fR
72
+ Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
73
+ .TP
74
+ \fBNO_COLOR\fR
75
+ Disables colour when set to any value.
76
+ .SH "EXIT STATUS"
77
+ .TP
78
+ \fB0\fR
79
+ The command succeeded.
80
+ .TP
81
+ \fB1\fR
82
+ The API rejected the request.
83
+ .TP
84
+ \fB2\fR
85
+ The command line was wrong.
86
+ .TP
87
+ \fB3\fR
88
+ No credential, or the credential was refused.
89
+ .TP
90
+ \fB4\fR
91
+ The addressed resource does not exist.
92
+ .TP
93
+ \fB5\fR
94
+ The request never completed: connection, timeout, or abort.
95
+ .SH "SEE ALSO"
96
+ .BR roark (1)
@@ -0,0 +1,127 @@
1
+ .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
+ .TH "ROARK\-TOOL\-UPDATE" "1" "" "roark-tool-update" "Roark Analytics API Manual"
3
+ .SH "NAME"
4
+ roark\-tool\-update \- Update a tool
5
+ .SH "SYNOPSIS"
6
+ .B roark tool update
7
+ \fItool\-id\fR [\fIoptions\fR]
8
+ .SH "DESCRIPTION"
9
+ Replaces the tool: its name, scope, inputs, description, grading hints and runtime. A field left out is cleared, so omitting agentId makes the tool project\-wide. A change declares a new version; agent versions pinned to an older one keep it.
10
+ .SH "API"
11
+ PUT /v1/tool/{toolId}
12
+ .SH "ARGUMENTS"
13
+ .TP
14
+ \fItool\-id\fR
15
+ The tool\-id.
16
+ .SH "OPTIONS"
17
+ .TP
18
+ \fB\-\-name\fR \fI<value>\fR
19
+ Required.
20
+ .TP
21
+ \fB\-\-description\fR \fI<value>\fR
22
+ When the agent should use the tool Required.
23
+ .TP
24
+ \fB\-\-agent\-id\fR \fI<value>\fR
25
+ Optional.
26
+ .TP
27
+ \fB\-\-inputs\fR \fI<value>\fR
28
+ Optional.
29
+ .TP
30
+ \fB\-\-invocation\-criteria\fR \fI<value>\fR
31
+ Optional.
32
+ .TP
33
+ \fB\-\-expected\-result\fR \fI<value>\fR
34
+ Optional.
35
+ .TP
36
+ \fB\-\-runtime\fR \fI<value>\fR
37
+ Omit or null for a tool that is only graded Optional.
38
+ .TP
39
+ \fB\-\-runtime.request\fR \fI<value>\fR
40
+ Required.
41
+ .TP
42
+ \fB\-\-runtime.changes\-data\fR
43
+ Optional.
44
+ .TP
45
+ \fB\-\-runtime.response\-fields\fR \fI<value>\fR
46
+ Repeatable. Optional.
47
+ .TP
48
+ \fB\-\-runtime.messages\fR \fI<value>\fR
49
+ Optional.
50
+ .SH "GLOBAL OPTIONS"
51
+ .TP
52
+ \fB\-\-data\fR \fI<json>\fR
53
+ Request body as JSON, or @file to read one (@\- for stdin).
54
+ .TP
55
+ \fB\-y\fR, \fB\-\-yes\fR
56
+ Skip confirmation prompts.
57
+ .TP
58
+ \fB\-\-no\-input\fR
59
+ Never prompt; fail instead.
60
+ .TP
61
+ \fB\-\-base\-url\fR \fI<url>\fR
62
+ API base URL.
63
+ .TP
64
+ \fB\-\-token\fR \fI<token>\fR
65
+ Bearer token. Prefer ROARK_API_BEARER_TOKEN or the stored credential.
66
+ .TP
67
+ \fB\-\-timeout\fR \fI<ms>\fR
68
+ Request timeout in milliseconds.
69
+ .TP
70
+ \fB\-\-max\-retries\fR \fI<count>\fR
71
+ Retries for retryable failures.
72
+ .TP
73
+ \fB\-\-format\fR \fI<format>\fR
74
+ Output format: auto, json, jsonl, plain.
75
+ .TP
76
+ \fB\-\-json\fR
77
+ Shorthand for \-\-format json.
78
+ .TP
79
+ \fB\-\-no\-color\fR
80
+ Disable colour.
81
+ .TP
82
+ \fB\-q\fR, \fB\-\-quiet\fR
83
+ Suppress non\-essential output.
84
+ .TP
85
+ \fB\-\-allow\-project\-base\-url\fR
86
+ Send the stored credential to a base URL set by a project .roark.json. Refused by default.
87
+ .SH "EXAMPLES"
88
+ .PP
89
+ .RS 4
90
+ .nf
91
+ roark tool update <tool\-id> \-\-name <value> \-\-description <value> \-\-runtime.request <value>
92
+ .fi
93
+ .RE
94
+ .SH "ENVIRONMENT"
95
+ .TP
96
+ \fBROARK_API_BEARER_TOKEN\fR
97
+ Bearer token used when \-\-token is not given.
98
+ .TP
99
+ \fBROARK_BASE_URL\fR
100
+ API base URL.
101
+ .TP
102
+ \fBROARK_ALLOW_PROJECT_BASE_URL\fR
103
+ Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
104
+ .TP
105
+ \fBNO_COLOR\fR
106
+ Disables colour when set to any value.
107
+ .SH "EXIT STATUS"
108
+ .TP
109
+ \fB0\fR
110
+ The command succeeded.
111
+ .TP
112
+ \fB1\fR
113
+ The API rejected the request.
114
+ .TP
115
+ \fB2\fR
116
+ The command line was wrong.
117
+ .TP
118
+ \fB3\fR
119
+ No credential, or the credential was refused.
120
+ .TP
121
+ \fB4\fR
122
+ The addressed resource does not exist.
123
+ .TP
124
+ \fB5\fR
125
+ The request never completed: connection, timeout, or abort.
126
+ .SH "SEE ALSO"
127
+ .BR roark (1)
package/man/roark.1 CHANGED
@@ -186,6 +186,30 @@ List a target’s published generations See roark\-benchmark\-target\-history\-l
186
186
  \fBroark benchmark target score\-sample list\fR
187
187
  List score samples for a target See roark\-benchmark\-target\-score\-sample\-list(1).
188
188
  .TP
189
+ \fBroark calendar\-connection check\fR
190
+ Check a calendar connection See roark\-calendar\-connection\-check(1).
191
+ .TP
192
+ \fBroark calendar\-connection create\fR
193
+ Connect a calendar account See roark\-calendar\-connection\-create(1).
194
+ .TP
195
+ \fBroark calendar\-connection delete\fR
196
+ Delete a calendar connection See roark\-calendar\-connection\-delete(1).
197
+ .TP
198
+ \fBroark calendar\-connection get\fR
199
+ Get a calendar connection See roark\-calendar\-connection\-get(1).
200
+ .TP
201
+ \fBroark calendar\-connection list\fR
202
+ List calendar connections See roark\-calendar\-connection\-list(1).
203
+ .TP
204
+ \fBroark calendar\-connection target get\fR
205
+ Read one bookable target See roark\-calendar\-connection\-target\-get(1).
206
+ .TP
207
+ \fBroark calendar\-connection target list\fR
208
+ List what can be booked on a calendar See roark\-calendar\-connection\-target\-list(1).
209
+ .TP
210
+ \fBroark calendar\-connection update\fR
211
+ Update a calendar connection See roark\-calendar\-connection\-update(1).
212
+ .TP
189
213
  \fBroark call batch delete\fR
190
214
  Delete calls in batch See roark\-call\-batch\-delete(1).
191
215
  .TP
@@ -537,6 +561,21 @@ List tool fixtures See roark\-simulation\-tool\-fixture\-list(1).
537
561
  \fBroark simulation tool\-fixture update\fR
538
562
  Update a tool fixture See roark\-simulation\-tool\-fixture\-update(1).
539
563
  .TP
564
+ \fBroark tool create\fR
565
+ Create a tool See roark\-tool\-create(1).
566
+ .TP
567
+ \fBroark tool delete\fR
568
+ Delete a tool See roark\-tool\-delete(1).
569
+ .TP
570
+ \fBroark tool get\fR
571
+ Get a tool See roark\-tool\-get(1).
572
+ .TP
573
+ \fBroark tool list\fR
574
+ List tools See roark\-tool\-list(1).
575
+ .TP
576
+ \fBroark tool update\fR
577
+ Update a tool See roark\-tool\-update(1).
578
+ .TP
540
579
  \fBroark usage get\fR
541
580
  Get usage & cost See roark\-usage\-get(1).
542
581
  .TP