@roarkanalytics/cli 0.72.1 → 0.74.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.
Files changed (129) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/README.md +191 -135
  3. package/commands.js +2764 -471
  4. package/completions.js +4 -4
  5. package/man/roark-agent-build.1 +3 -3
  6. package/man/roark-agent-conversation-create.1 +106 -0
  7. package/man/roark-agent-create.1 +27 -3
  8. package/man/roark-agent-draft-update.1 +4 -1
  9. package/man/roark-agent-endpoint-create.1 +5 -5
  10. package/man/roark-agent-endpoint-get.1 +1 -1
  11. package/man/roark-agent-get.1 +1 -1
  12. package/man/roark-autoimprove-job-cancel.1 +1 -1
  13. package/man/roark-autoimprove-job-dismiss.1 +1 -1
  14. package/man/roark-autoimprove-job-guidance-send.1 +1 -1
  15. package/man/roark-autoimprove-job-promote.1 +1 -1
  16. package/man/roark-benchmark-target-history-list.1 +1 -1
  17. package/man/roark-call-create.1 +3 -0
  18. package/man/roark-call-get.1 +1 -1
  19. package/man/roark-connections-agent-backfill-cancel.1 +96 -0
  20. package/man/roark-connections-agent-backfill-create.1 +97 -0
  21. package/man/roark-connections-agent-backfill-list.1 +93 -0
  22. package/man/roark-connections-agent-create.1 +124 -0
  23. package/man/roark-connections-agent-delete.1 +93 -0
  24. package/man/roark-connections-agent-discover.1 +96 -0
  25. package/man/roark-connections-agent-get.1 +93 -0
  26. package/man/roark-connections-agent-list.1 +93 -0
  27. package/man/roark-connections-agent-provider-list.1 +89 -0
  28. package/man/roark-connections-agent-update.1 +128 -0
  29. package/man/roark-connections-calendar-calendar-list.1 +93 -0
  30. package/man/roark-connections-calendar-calendly-oauth-start.1 +99 -0
  31. package/man/{roark-calendar-connection-check.1 → roark-connections-calendar-check.1} +5 -5
  32. package/man/{roark-calendar-connection-create.1 → roark-connections-calendar-create.1} +7 -7
  33. package/man/{roark-calendar-connection-delete.1 → roark-connections-calendar-delete.1} +5 -5
  34. package/man/{roark-calendar-connection-get.1 → roark-connections-calendar-get.1} +5 -5
  35. package/man/roark-connections-calendar-google-oauth-start.1 +102 -0
  36. package/man/{roark-calendar-connection-list.1 → roark-connections-calendar-list.1} +6 -6
  37. package/man/roark-connections-calendar-target-create.1 +124 -0
  38. package/man/roark-connections-calendar-target-delete.1 +96 -0
  39. package/man/{roark-calendar-connection-target-get.1 → roark-connections-calendar-target-get.1} +5 -5
  40. package/man/{roark-calendar-connection-target-list.1 → roark-connections-calendar-target-list.1} +5 -5
  41. package/man/roark-connections-calendar-target-update.1 +124 -0
  42. package/man/{roark-calendar-connection-update.1 → roark-connections-calendar-update.1} +5 -5
  43. package/man/roark-connections-mcp-server-create.1 +105 -0
  44. package/man/roark-connections-mcp-server-delete.1 +93 -0
  45. package/man/roark-connections-mcp-server-discover.1 +99 -0
  46. package/man/roark-connections-mcp-server-get.1 +93 -0
  47. package/man/roark-connections-mcp-server-list.1 +89 -0
  48. package/man/roark-connections-mcp-server-refresh.1 +93 -0
  49. package/man/roark-connections-mcp-server-update.1 +100 -0
  50. package/man/roark-conversation-get.1 +93 -0
  51. package/man/roark-credential-create.1 +2 -2
  52. package/man/roark-credential-list.1 +2 -2
  53. package/man/roark-credential-revoke.1 +2 -2
  54. package/man/roark-customer-attribute-delete.1 +96 -0
  55. package/man/roark-customer-attribute-unlock.1 +96 -0
  56. package/man/roark-customer-attribute-update.1 +100 -0
  57. package/man/roark-customer-conversation-list.1 +100 -0
  58. package/man/roark-customer-delete.1 +93 -0
  59. package/man/roark-customer-field-create.1 +105 -0
  60. package/man/roark-customer-field-delete.1 +93 -0
  61. package/man/roark-customer-field-list.1 +89 -0
  62. package/man/roark-customer-field-update.1 +106 -0
  63. package/man/roark-customer-flow-edge-case-create.1 +1 -1
  64. package/man/roark-customer-flow-edge-case-update.1 +1 -1
  65. package/man/roark-customer-flow-folder-create.1 +99 -0
  66. package/man/roark-customer-flow-folder-delete.1 +93 -0
  67. package/man/roark-customer-flow-folder-list.1 +89 -0
  68. package/man/roark-customer-flow-get.1 +1 -1
  69. package/man/roark-customer-flow-happy-path-update.1 +1 -1
  70. package/man/roark-customer-flow-list.1 +3 -0
  71. package/man/roark-customer-flow-update.1 +4 -1
  72. package/man/roark-customer-get.1 +93 -0
  73. package/man/roark-customer-list.1 +123 -0
  74. package/man/roark-customer-notes-update.1 +97 -0
  75. package/man/roark-dashboard-list.1 +1 -1
  76. package/man/roark-dashboard-update.1 +1 -1
  77. package/man/roark-http-request-definition-create.1 +1 -1
  78. package/man/roark-http-request-definition-get.1 +1 -1
  79. package/man/roark-http-request-definition-update.1 +1 -1
  80. package/man/roark-metric-collection-job-get.1 +1 -1
  81. package/man/roark-metric-definition-create.1 +1 -1
  82. package/man/roark-metric-definition-update.1 +1 -1
  83. package/man/roark-metric-policy-create.1 +1 -1
  84. package/man/roark-metric-policy-get.1 +1 -1
  85. package/man/roark-metric-variant-list.1 +1 -1
  86. package/man/roark-metric-variant-update.1 +1 -1
  87. package/man/roark-project-list.1 +1 -1
  88. package/man/roark-simulation-environment-create.1 +12 -0
  89. package/man/roark-simulation-environment-get.1 +1 -1
  90. package/man/roark-simulation-environment-update.1 +12 -0
  91. package/man/roark-simulation-group-create.1 +2 -2
  92. package/man/roark-simulation-group-delete.1 +1 -1
  93. package/man/roark-simulation-group-get.1 +1 -1
  94. package/man/roark-simulation-group-list.1 +1 -1
  95. package/man/roark-simulation-group-run.1 +2 -2
  96. package/man/roark-simulation-group-update.1 +1 -1
  97. package/man/roark-simulation-job-get.1 +1 -1
  98. package/man/roark-simulation-job-lookup.1 +1 -1
  99. package/man/roark-simulation-persona-create.1 +1 -1
  100. package/man/roark-simulation-persona-get.1 +1 -1
  101. package/man/roark-simulation-persona-update.1 +1 -1
  102. package/man/roark-simulation-plan-get.1 +1 -1
  103. package/man/roark-simulation-plan-job-cancel.1 +1 -1
  104. package/man/roark-simulation-plan-job-cost-get.1 +1 -1
  105. package/man/roark-simulation-plan-job-debrief-create.1 +1 -1
  106. package/man/roark-simulation-plan-job-delete.1 +1 -1
  107. package/man/roark-simulation-plan-job-get.1 +1 -1
  108. package/man/roark-simulation-plan-job-list.1 +1 -1
  109. package/man/roark-simulation-plan-job-result-get.1 +1 -1
  110. package/man/roark-simulation-plan-update.1 +7 -1
  111. package/man/roark-simulation-resource-generate.1 +120 -0
  112. package/man/roark-simulation-resource-generation-answer.1 +97 -0
  113. package/man/roark-simulation-resource-generation-cancel.1 +93 -0
  114. package/man/roark-simulation-resource-generation-get.1 +93 -0
  115. package/man/roark-simulation-resource-generation-guidance-send.1 +97 -0
  116. package/man/roark-simulation-resource-generation-list.1 +96 -0
  117. package/man/roark-simulation-run-group-list.1 +1 -1
  118. package/man/roark-tool-create.1 +32 -2
  119. package/man/roark-tool-update.1 +32 -2
  120. package/man/roark-usage-get.1 +1 -1
  121. package/man/roark-webhook-create.1 +2 -2
  122. package/man/roark-webhook-delete.1 +1 -1
  123. package/man/roark-webhook-get.1 +1 -1
  124. package/man/roark-whoami.1 +1 -1
  125. package/man/roark.1 +208 -70
  126. package/npm-shrinkwrap.json +6 -6
  127. package/package.json +56 -10
  128. package/version.d.ts +1 -1
  129. package/version.js +1 -1
@@ -0,0 +1,93 @@
1
+ .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
+ .TH "ROARK\-SIMULATION\-RESOURCE\-GENERATION\-GET" "1" "" "roark-simulation-resource-generation-get" "Roark Analytics API Manual"
3
+ .SH "NAME"
4
+ roark\-simulation\-resource\-generation\-get \- Get a simulation resource generation
5
+ .SH "SYNOPSIS"
6
+ .B roark simulation resource\-generation get
7
+ \fIgeneration\-id\fR [\fIoptions\fR]
8
+ .SH "DESCRIPTION"
9
+ Returns one simulation resource generation, for example the one a webhook named.
10
+ .SH "API"
11
+ GET /v1/simulation/generations/resources/{generationId}
12
+ .SH "ARGUMENTS"
13
+ .TP
14
+ \fIgeneration\-id\fR
15
+ The generation\-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 simulation resource\-generation get <generation\-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,97 @@
1
+ .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
+ .TH "ROARK\-SIMULATION\-RESOURCE\-GENERATION\-GUIDANCE\-SEND" "1" "" "roark-simulation-resource-generation-guidance-send" "Roark Analytics API Manual"
3
+ .SH "NAME"
4
+ roark\-simulation\-resource\-generation\-guidance\-send \- Guide a running simulation resource generation
5
+ .SH "SYNOPSIS"
6
+ .B roark simulation resource\-generation guidance send
7
+ \fIgeneration\-id\fR [\fIoptions\fR]
8
+ .SH "DESCRIPTION"
9
+ Tells a running simulation resource generation what to focus on or avoid, in your own words. It reads it on its next turn and it outranks its own plan. Refused once the generation has finished.
10
+ .SH "API"
11
+ POST /v1/simulation/generations/resources/{generationId}/guidance
12
+ .SH "ARGUMENTS"
13
+ .TP
14
+ \fIgeneration\-id\fR
15
+ The generation\-id.
16
+ .SH "OPTIONS"
17
+ .TP
18
+ \fB\-\-text\fR \fI<value>\fR
19
+ What you want the generation to know Required.
20
+ .SH "GLOBAL OPTIONS"
21
+ .TP
22
+ \fB\-\-data\fR \fI<json>\fR
23
+ Request body as JSON, or @file to read one (@\- for stdin).
24
+ .TP
25
+ \fB\-y\fR, \fB\-\-yes\fR
26
+ Skip confirmation prompts.
27
+ .TP
28
+ \fB\-\-no\-input\fR
29
+ Never prompt; fail instead.
30
+ .TP
31
+ \fB\-\-base\-url\fR \fI<url>\fR
32
+ API base URL.
33
+ .TP
34
+ \fB\-\-token\fR \fI<token>\fR
35
+ Bearer token. Prefer ROARK_API_BEARER_TOKEN or the stored credential.
36
+ .TP
37
+ \fB\-\-timeout\fR \fI<ms>\fR
38
+ Request timeout in milliseconds.
39
+ .TP
40
+ \fB\-\-max\-retries\fR \fI<count>\fR
41
+ Retries for retryable failures.
42
+ .TP
43
+ \fB\-\-format\fR \fI<format>\fR
44
+ Output format: auto, json, jsonl, plain.
45
+ .TP
46
+ \fB\-\-json\fR
47
+ Shorthand for \-\-format json.
48
+ .TP
49
+ \fB\-\-no\-color\fR
50
+ Disable colour.
51
+ .TP
52
+ \fB\-q\fR, \fB\-\-quiet\fR
53
+ Suppress non\-essential output.
54
+ .TP
55
+ \fB\-\-allow\-project\-base\-url\fR
56
+ Send the stored credential to a base URL set by a project .roark.json. Refused by default.
57
+ .SH "EXAMPLES"
58
+ .PP
59
+ .RS 4
60
+ .nf
61
+ roark simulation resource\-generation guidance send <generation\-id> \-\-text <value>
62
+ .fi
63
+ .RE
64
+ .SH "ENVIRONMENT"
65
+ .TP
66
+ \fBROARK_API_BEARER_TOKEN\fR
67
+ Bearer token used when \-\-token is not given.
68
+ .TP
69
+ \fBROARK_BASE_URL\fR
70
+ API base URL.
71
+ .TP
72
+ \fBROARK_ALLOW_PROJECT_BASE_URL\fR
73
+ Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
74
+ .TP
75
+ \fBNO_COLOR\fR
76
+ Disables colour when set to any value.
77
+ .SH "EXIT STATUS"
78
+ .TP
79
+ \fB0\fR
80
+ The command succeeded.
81
+ .TP
82
+ \fB1\fR
83
+ The API rejected the request.
84
+ .TP
85
+ \fB2\fR
86
+ The command line was wrong.
87
+ .TP
88
+ \fB3\fR
89
+ No credential, or the credential was refused.
90
+ .TP
91
+ \fB4\fR
92
+ The addressed resource does not exist.
93
+ .TP
94
+ \fB5\fR
95
+ The request never completed: connection, timeout, or abort.
96
+ .SH "SEE ALSO"
97
+ .BR roark (1)
@@ -0,0 +1,96 @@
1
+ .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
+ .TH "ROARK\-SIMULATION\-RESOURCE\-GENERATION\-LIST" "1" "" "roark-simulation-resource-generation-list" "Roark Analytics API Manual"
3
+ .SH "NAME"
4
+ roark\-simulation\-resource\-generation\-list \- List simulation resource generations
5
+ .SH "SYNOPSIS"
6
+ .B roark simulation resource\-generation list
7
+ [\fIoptions\fR]
8
+ .SH "DESCRIPTION"
9
+ Returns the project's simulation resource generations, newest first, optionally only for some agents: each one's progress, the run plan it created, and every flow, metric and check it added or left out, with the reason and the source it came from.
10
+ .SH "API"
11
+ GET /v1/simulation/generations/resources
12
+ .SH "OPTIONS"
13
+ .TP
14
+ \fB\-\-agent\-ids\fR \fI<value>\fR
15
+ Only generations for these agents, comma\-separated, at most 100. Omit for every agent. Optional.
16
+ .TP
17
+ \fB\-\-limit\fR \fI<value>\fR
18
+ How many to return, newest first. Default 20, max 50. 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 simulation resource\-generation 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)
@@ -6,7 +6,7 @@ roark\-simulation\-run\-group\-list \- List run groups
6
6
  .B roark simulation run\-group list
7
7
  [\fIoptions\fR]
8
8
  .SH "DESCRIPTION"
9
- Returns the run groups in the project, newest first, with their runs and where each group report stands. Read a report document from GET /v1/simulation/run\-group/{groupId}.
9
+ Returns the run groups in the project, newest first, with their runs and where each group report stands. Read a report document from `GET /v1/simulation/run\-group/{groupId}`.
10
10
  .SH "API"
11
11
  GET /v1/simulation/run\-group
12
12
  .SH "OPTIONS"
@@ -6,7 +6,7 @@ roark\-tool\-create \- Create a tool
6
6
  .B roark tool create
7
7
  [\fIoptions\fR]
8
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.
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, a `calendar` for it to book on a calendar connected to the project, or `mcp` for it to call a tool on an MCP server connected to the project. Header values are returned on read, so keep secrets out of them.
10
10
  .SH "API"
11
11
  POST /v1/tool
12
12
  .SH "OPTIONS"
@@ -43,6 +43,36 @@ Repeatable. Optional.
43
43
  .TP
44
44
  \fB\-\-runtime.messages\fR \fI<value>\fR
45
45
  Optional.
46
+ .TP
47
+ \fB\-\-calendar\fR \fI<value>\fR
48
+ Makes this a calendar tool, which Roark runs against a connected calendar: it takes no runtime and no inputs. Omit or null for any other tool; on update, omitting it makes the tool an ordinary one. Optional.
49
+ .TP
50
+ \fB\-\-calendar.calendar\-connection\-id\fR \fI<value>\fR
51
+ Required.
52
+ .TP
53
+ \fB\-\-calendar.operation\fR \fI<value>\fR
54
+ One of: CHECK_AVAILABILITY, BOOK, LOOKUP_BOOKING, RESCHEDULE, CANCEL, LIST_BOOKINGS. Required.
55
+ .TP
56
+ \fB\-\-calendar.appointment\-types\fR \fI<value>\fR
57
+ Required.
58
+ .TP
59
+ \fB\-\-calendar.simulate\fR
60
+ Optional.
61
+ .TP
62
+ \fB\-\-calendar.messages\fR \fI<value>\fR
63
+ Optional.
64
+ .TP
65
+ \fB\-\-mcp\fR \fI<value>\fR
66
+ Makes this a tool on one of the project's MCP servers: it takes no runtime, no inputs and no calendar, and the description replaces the server's own. On update, omitting it makes the tool an ordinary one. Optional.
67
+ .TP
68
+ \fB\-\-mcp.mcp\-server\-id\fR \fI<value>\fR
69
+ Required.
70
+ .TP
71
+ \fB\-\-mcp.tool\fR \fI<value>\fR
72
+ The tool as the server names it Required.
73
+ .TP
74
+ \fB\-\-mcp.messages\fR \fI<value>\fR
75
+ Optional.
46
76
  .SH "GLOBAL OPTIONS"
47
77
  .TP
48
78
  \fB\-\-data\fR \fI<json>\fR
@@ -84,7 +114,7 @@ Send the stored credential to a base URL set by a project .roark.json. Refused b
84
114
  .PP
85
115
  .RS 4
86
116
  .nf
87
- roark tool create \-\-name <value> \-\-description <value> \-\-runtime.request <value>
117
+ roark tool create \-\-name <value> \-\-description <value> \-\-runtime.request <value> \-\-calendar.calendar\-connection\-id <value> \-\-calendar.operation <value> \-\-calendar.appointment\-types <value> \-\-mcp.mcp\-server\-id <value> \-\-mcp.tool <value>
88
118
  .fi
89
119
  .RE
90
120
  .SH "ENVIRONMENT"
@@ -6,7 +6,7 @@ roark\-tool\-update \- Update a tool
6
6
  .B roark tool update
7
7
  \fItool\-id\fR [\fIoptions\fR]
8
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.
9
+ Replaces the tool: its name, scope, inputs, description, grading hints, runtime, calendar and MCP tool. A field left out is cleared, so omitting agentId makes the tool project\-wide and omitting calendar or mcp makes it an ordinary tool. A change declares a new version; agent versions pinned to an older one keep it. A tool managed by config\-as\-code returns 409.
10
10
  .SH "API"
11
11
  PUT /v1/tool/{toolId}
12
12
  .SH "ARGUMENTS"
@@ -47,6 +47,36 @@ Repeatable. Optional.
47
47
  .TP
48
48
  \fB\-\-runtime.messages\fR \fI<value>\fR
49
49
  Optional.
50
+ .TP
51
+ \fB\-\-calendar\fR \fI<value>\fR
52
+ Makes this a calendar tool, which Roark runs against a connected calendar: it takes no runtime and no inputs. Omit or null for any other tool; on update, omitting it makes the tool an ordinary one. Optional.
53
+ .TP
54
+ \fB\-\-calendar.calendar\-connection\-id\fR \fI<value>\fR
55
+ Required.
56
+ .TP
57
+ \fB\-\-calendar.operation\fR \fI<value>\fR
58
+ One of: CHECK_AVAILABILITY, BOOK, LOOKUP_BOOKING, RESCHEDULE, CANCEL, LIST_BOOKINGS. Required.
59
+ .TP
60
+ \fB\-\-calendar.appointment\-types\fR \fI<value>\fR
61
+ Required.
62
+ .TP
63
+ \fB\-\-calendar.simulate\fR
64
+ Optional.
65
+ .TP
66
+ \fB\-\-calendar.messages\fR \fI<value>\fR
67
+ Optional.
68
+ .TP
69
+ \fB\-\-mcp\fR \fI<value>\fR
70
+ Makes this a tool on one of the project's MCP servers: it takes no runtime, no inputs and no calendar, and the description replaces the server's own. On update, omitting it makes the tool an ordinary one. Optional.
71
+ .TP
72
+ \fB\-\-mcp.mcp\-server\-id\fR \fI<value>\fR
73
+ Required.
74
+ .TP
75
+ \fB\-\-mcp.tool\fR \fI<value>\fR
76
+ The tool as the server names it Required.
77
+ .TP
78
+ \fB\-\-mcp.messages\fR \fI<value>\fR
79
+ Optional.
50
80
  .SH "GLOBAL OPTIONS"
51
81
  .TP
52
82
  \fB\-\-data\fR \fI<json>\fR
@@ -88,7 +118,7 @@ Send the stored credential to a base URL set by a project .roark.json. Refused b
88
118
  .PP
89
119
  .RS 4
90
120
  .nf
91
- roark tool update <tool\-id> \-\-name <value> \-\-description <value> \-\-runtime.request <value>
121
+ roark tool update <tool\-id> \-\-name <value> \-\-description <value> \-\-runtime.request <value> \-\-calendar.calendar\-connection\-id <value> \-\-calendar.operation <value> \-\-calendar.appointment\-types <value> \-\-mcp.mcp\-server\-id <value> \-\-mcp.tool <value>
92
122
  .fi
93
123
  .RE
94
124
  .SH "ENVIRONMENT"
@@ -1,7 +1,7 @@
1
1
  .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
2
  .TH "ROARK\-USAGE\-GET" "1" "" "roark-usage-get" "Roark Analytics API Manual"
3
3
  .SH "NAME"
4
- roark\-usage\-get \- Get usage & cost
4
+ roark\-usage\-get \- Get usage and cost
5
5
  .SH "SYNOPSIS"
6
6
  .B roark usage get
7
7
  [\fIoptions\fR]
@@ -1,7 +1,7 @@
1
1
  .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
2
  .TH "ROARK\-WEBHOOK\-CREATE" "1" "" "roark-webhook-create" "Roark Analytics API Manual"
3
3
  .SH "NAME"
4
- roark\-webhook\-create \- Create webhook
4
+ roark\-webhook\-create \- Create a webhook
5
5
  .SH "SYNOPSIS"
6
6
  .B roark webhook create
7
7
  [\fIoptions\fR]
@@ -21,7 +21,7 @@ Webhook description Optional.
21
21
  Request headers (e.g. authorization tokens) Optional.
22
22
  .TP
23
23
  \fB\-\-events\fR \fI<value>\fR
24
- Event types to subscribe to (at least one required) One of: CALL_ANALYSIS_COMPLETED, CALL_ANALYSIS_FAILED, CALL_ANALYSIS_CANCELLED, CALL_EVALUATION_COMPLETED, CALL_EVALUATION_FAILED, SIMULATION_RUN_PLAN_JOB_STARTED, SIMULATION_RUN_PLAN_JOB_COMPLETED, SIMULATION_RUN_PLAN_JOB_FAILED, SIMULATION_RUN_PLAN_JOB_CANCELLED, SIMULATION_JOB_STARTED, SIMULATION_JOB_COMPLETED, SIMULATION_JOB_FAILED, SIMULATION_JOB_CANCELLED, METRIC_COLLECTION_JOB_COMPLETED, METRIC_COLLECTION_JOB_FAILED, CHAT_ANALYSIS_COMPLETED, CHAT_ANALYSIS_FAILED, ISSUE_OPENED, ISSUE_RESOLVED. Repeatable. Required.
24
+ Event types to subscribe to (at least one required) One of: CALL_ANALYSIS_COMPLETED, CALL_ANALYSIS_FAILED, CALL_ANALYSIS_CANCELLED, CALL_EVALUATION_COMPLETED, CALL_EVALUATION_FAILED, SIMULATION_RUN_PLAN_JOB_STARTED, SIMULATION_RUN_PLAN_JOB_COMPLETED, SIMULATION_RUN_PLAN_JOB_FAILED, SIMULATION_RUN_PLAN_JOB_CANCELLED, SIMULATION_JOB_STARTED, SIMULATION_JOB_COMPLETED, SIMULATION_JOB_FAILED, SIMULATION_JOB_CANCELLED, METRIC_COLLECTION_JOB_COMPLETED, METRIC_COLLECTION_JOB_FAILED, CHAT_ANALYSIS_COMPLETED, CHAT_ANALYSIS_FAILED, ISSUE_OPENED, ISSUE_RESOLVED, SIMULATION_RESOURCE_GENERATION_COMPLETED, SIMULATION_RESOURCE_GENERATION_FAILED. Repeatable. Required.
25
25
  .SH "GLOBAL OPTIONS"
26
26
  .TP
27
27
  \fB\-\-data\fR \fI<json>\fR
@@ -1,7 +1,7 @@
1
1
  .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
2
  .TH "ROARK\-WEBHOOK\-DELETE" "1" "" "roark-webhook-delete" "Roark Analytics API Manual"
3
3
  .SH "NAME"
4
- roark\-webhook\-delete \- Delete webhook
4
+ roark\-webhook\-delete \- Delete a webhook
5
5
  .SH "SYNOPSIS"
6
6
  .B roark webhook delete
7
7
  \fIwebhook\-id\fR [\fIoptions\fR]
@@ -1,7 +1,7 @@
1
1
  .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
2
  .TH "ROARK\-WEBHOOK\-GET" "1" "" "roark-webhook-get" "Roark Analytics API Manual"
3
3
  .SH "NAME"
4
- roark\-webhook\-get \- Get webhook by ID
4
+ roark\-webhook\-get \- Get a webhook
5
5
  .SH "SYNOPSIS"
6
6
  .B roark webhook get
7
7
  \fIwebhook\-id\fR [\fIoptions\fR]
@@ -1,7 +1,7 @@
1
1
  .\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
2
2
  .TH "ROARK\-WHOAMI" "1" "" "roark-whoami" "Roark Analytics API Manual"
3
3
  .SH "NAME"
4
- roark\-whoami \- Describe the current credential
4
+ roark\-whoami \- Get the current credential
5
5
  .SH "SYNOPSIS"
6
6
  .B roark whoami
7
7
  [\fIoptions\fR]