@roarkanalytics/cli 0.24.0 → 0.26.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 +14 -0
- package/README.md +26 -24
- package/commands.js +109 -0
- package/completions.js +4 -4
- package/man/roark-agent-build.1 +99 -0
- package/man/roark-simulation-tool-mock.1 +105 -0
- package/man/roark.1 +6 -0
- package/npm-shrinkwrap.json +5 -5
- package/package.json +3 -1
- package/version.d.ts +1 -1
- package/version.js +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.26.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.25.0...v0.26.0) (2026-09-23)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Features
|
|
7
|
+
|
|
8
|
+
* **cli:** cli update ([#65](https://github.com/roarkhq/cli-roark-analytics/issues/65)) ([b897c3c](https://github.com/roarkhq/cli-roark-analytics/commit/b897c3c9088ed6bfdf39c431484cae33d526140d))
|
|
9
|
+
|
|
10
|
+
## [0.25.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.24.0...v0.25.0) (2026-09-23)
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
### Features
|
|
14
|
+
|
|
15
|
+
* **cli:** cli update ([#62](https://github.com/roarkhq/cli-roark-analytics/issues/62)) ([940ab33](https://github.com/roarkhq/cli-roark-analytics/commit/940ab3309f5d28787e74d4644dabdbb81b6b5e45))
|
|
16
|
+
|
|
3
17
|
## [0.24.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.23.1...v0.24.0) (2026-09-22)
|
|
4
18
|
|
|
5
19
|
|
package/README.md
CHANGED
|
@@ -110,6 +110,7 @@ roark completion fish | source
|
|
|
110
110
|
|
|
111
111
|
| Command | Description |
|
|
112
112
|
| ------------------------------------------------------------------------------------ | --------------------------- |
|
|
113
|
+
| `roark agent build --name <value> --job-description <value>` | Build a Roark-hosted agent |
|
|
113
114
|
| `roark agent create --name <value>` | Create a new agent |
|
|
114
115
|
| `roark agent endpoint create --agent-id <value> --value <value> --direction <value>` | Create a new agent endpoint |
|
|
115
116
|
| `roark agent endpoint get <endpoint-id>` | Get agent endpoint by ID |
|
|
@@ -231,30 +232,31 @@ roark completion fish | source
|
|
|
231
232
|
|
|
232
233
|
### simulation
|
|
233
234
|
|
|
234
|
-
| Command | Description
|
|
235
|
-
| ------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
236
|
-
| `roark simulation environment create --name <value> --background-noise <value>` | Create an environment
|
|
237
|
-
| `roark simulation environment delete <environment-id>` | Delete an environment
|
|
238
|
-
| `roark simulation environment get <environment-id>` | Get environment by ID
|
|
239
|
-
| `roark simulation environment list` | List environments
|
|
240
|
-
| `roark simulation environment update <environment-id>` | Update an environment
|
|
241
|
-
| `roark simulation job get <job-id>` | Get simulation by ID
|
|
242
|
-
| `roark simulation job lookup --roark-phone-number <value>` | Lookup by phone number
|
|
243
|
-
| `roark simulation persona create --name <value> --language <value> --accent <value> --gender <value>` | Create a new persona
|
|
244
|
-
| `roark simulation persona get <persona-id>` | Get persona by ID
|
|
245
|
-
| `roark simulation persona list` | List personas
|
|
246
|
-
| `roark simulation persona update <persona-id>` | Update a persona
|
|
247
|
-
| `roark simulation plan create --name <value> --direction <value> --max-simulation-duration-seconds <value> --agent-endpoints <value> --metrics <value>` | Create a run plan
|
|
248
|
-
| `roark simulation plan delete <plan-id>` | Delete a run plan
|
|
249
|
-
| `roark simulation plan get <plan-id>` | Get run plan by ID
|
|
250
|
-
| `roark simulation plan job cancel <job-id>` | Cancel a simulation plan job
|
|
251
|
-
| `roark simulation plan job get <job-id>` | Get simulation plan job
|
|
252
|
-
| `roark simulation plan job list` | List simulation plan jobs
|
|
253
|
-
| `roark simulation plan job start <plan-id>` | Run a simulation plan
|
|
254
|
-
| `roark simulation plan list` | List run plans
|
|
255
|
-
| `roark simulation plan update <plan-id>` | Update a run plan
|
|
256
|
-
| `roark simulation run --data '{ ... }'` | Run a simulation
|
|
257
|
-
| `roark simulation template list` | List simulation templates
|
|
235
|
+
| Command | Description |
|
|
236
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
|
|
237
|
+
| `roark simulation environment create --name <value> --background-noise <value>` | Create an environment |
|
|
238
|
+
| `roark simulation environment delete <environment-id>` | Delete an environment |
|
|
239
|
+
| `roark simulation environment get <environment-id>` | Get environment by ID |
|
|
240
|
+
| `roark simulation environment list` | List environments |
|
|
241
|
+
| `roark simulation environment update <environment-id>` | Update an environment |
|
|
242
|
+
| `roark simulation job get <job-id>` | Get simulation by ID |
|
|
243
|
+
| `roark simulation job lookup --roark-phone-number <value>` | Lookup by phone number |
|
|
244
|
+
| `roark simulation persona create --name <value> --language <value> --accent <value> --gender <value>` | Create a new persona |
|
|
245
|
+
| `roark simulation persona get <persona-id>` | Get persona by ID |
|
|
246
|
+
| `roark simulation persona list` | List personas |
|
|
247
|
+
| `roark simulation persona update <persona-id>` | Update a persona |
|
|
248
|
+
| `roark simulation plan create --name <value> --direction <value> --max-simulation-duration-seconds <value> --agent-endpoints <value> --metrics <value>` | Create a run plan |
|
|
249
|
+
| `roark simulation plan delete <plan-id>` | Delete a run plan |
|
|
250
|
+
| `roark simulation plan get <plan-id>` | Get run plan by ID |
|
|
251
|
+
| `roark simulation plan job cancel <job-id>` | Cancel a simulation plan job |
|
|
252
|
+
| `roark simulation plan job get <job-id>` | Get simulation plan job |
|
|
253
|
+
| `roark simulation plan job list` | List simulation plan jobs |
|
|
254
|
+
| `roark simulation plan job start <plan-id>` | Run a simulation plan |
|
|
255
|
+
| `roark simulation plan list` | List run plans |
|
|
256
|
+
| `roark simulation plan update <plan-id>` | Update a run plan |
|
|
257
|
+
| `roark simulation run --data '{ ... }'` | Run a simulation |
|
|
258
|
+
| `roark simulation template list` | List simulation templates |
|
|
259
|
+
| `roark simulation tool mock --simulation-job-id <value> --tool-name <value>` | Mock a tool call during a test call |
|
|
258
260
|
|
|
259
261
|
### webhook
|
|
260
262
|
|
package/commands.js
CHANGED
|
@@ -47,9 +47,55 @@ exports.GROUPS = {
|
|
|
47
47
|
'simulation plan': 'Manage simulation plans',
|
|
48
48
|
'simulation plan job': 'Manage simulation plan jobs',
|
|
49
49
|
'simulation template': 'Read simulation templates',
|
|
50
|
+
'simulation tool': 'Read simulation tool',
|
|
50
51
|
webhook: 'Manage webhooks',
|
|
51
52
|
};
|
|
52
53
|
exports.COMMANDS = [
|
|
54
|
+
{
|
|
55
|
+
commandPath: ['agent', 'build'],
|
|
56
|
+
clientProperty: 'agent',
|
|
57
|
+
methodName: 'build',
|
|
58
|
+
httpMethod: 'post',
|
|
59
|
+
httpPath: '/v1/agent/build',
|
|
60
|
+
summary: 'Build a Roark-hosted agent',
|
|
61
|
+
description: 'Creates a new Roark-hosted agent from a one-line job description. Roark authors the system prompt and hosts the config, so the agent is live and self-improvable from creation.',
|
|
62
|
+
positionals: [],
|
|
63
|
+
flags: [
|
|
64
|
+
{
|
|
65
|
+
name: 'name',
|
|
66
|
+
path: ['name'],
|
|
67
|
+
location: 'body',
|
|
68
|
+
required: true,
|
|
69
|
+
description: 'Name of the agent',
|
|
70
|
+
valueKind: 'string',
|
|
71
|
+
repeatable: false,
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
name: 'job-description',
|
|
75
|
+
path: ['jobDescription'],
|
|
76
|
+
location: 'body',
|
|
77
|
+
required: true,
|
|
78
|
+
description: 'One-line description of what the agent should do. Roark authors the system prompt from this.',
|
|
79
|
+
valueKind: 'string',
|
|
80
|
+
repeatable: false,
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
name: 'voice',
|
|
84
|
+
path: ['voice'],
|
|
85
|
+
location: 'body',
|
|
86
|
+
required: false,
|
|
87
|
+
description: 'Optional voice label for the hosted agent',
|
|
88
|
+
valueKind: 'string',
|
|
89
|
+
repeatable: false,
|
|
90
|
+
},
|
|
91
|
+
],
|
|
92
|
+
hasParams: true,
|
|
93
|
+
paramsAllOptional: false,
|
|
94
|
+
bodyOpaque: false,
|
|
95
|
+
bodyVariants: [],
|
|
96
|
+
acceptsBody: true,
|
|
97
|
+
requiresAuth: true,
|
|
98
|
+
},
|
|
53
99
|
{
|
|
54
100
|
commandPath: ['agent', 'create'],
|
|
55
101
|
clientProperty: 'agent',
|
|
@@ -5328,6 +5374,69 @@ exports.COMMANDS = [
|
|
|
5328
5374
|
acceptsBody: false,
|
|
5329
5375
|
requiresAuth: true,
|
|
5330
5376
|
},
|
|
5377
|
+
{
|
|
5378
|
+
commandPath: ['simulation', 'tool', 'mock'],
|
|
5379
|
+
clientProperty: 'simulation',
|
|
5380
|
+
methodName: 'mockTool',
|
|
5381
|
+
httpMethod: 'post',
|
|
5382
|
+
httpPath: '/v1/simulation/tool-mock',
|
|
5383
|
+
summary: 'Mock a tool call during a test call',
|
|
5384
|
+
description: 'The server half of the tool guard for code-first agents. When a guarded tool fires during a Roark test call, send the invocation here instead of executing it: Roark answers with a simulated backend response that is valid JSON, shaped by the tool contract you pass, consistent with the test scenario, and consistent with earlier mocked responses in the same call. Real callers are never affected: the guard only diverts when the agent-config resolve response identified the session as a Roark simulation, and this endpoint independently re-validates the simulation before answering. Failure contract for your wrapper: `404` means the simulation id is unknown to this project (treat the session as real). `409` means the simulation has already ended (stale session state: do NOT execute the real tool; return your static fallback). `5xx` means generation failed (return your static fallback). Identical retries (same tool, same arguments) within a few minutes return the stored response, so double-fired handlers stay consistent.',
|
|
5385
|
+
positionals: [],
|
|
5386
|
+
flags: [
|
|
5387
|
+
{
|
|
5388
|
+
name: 'simulation-job-id',
|
|
5389
|
+
path: ['simulationJobId'],
|
|
5390
|
+
location: 'body',
|
|
5391
|
+
required: true,
|
|
5392
|
+
description: 'The simulation this session belongs to, from the agent-config resolve response (`simulationJobId`). Roark re-validates it against the live simulation before answering.',
|
|
5393
|
+
valueKind: 'string',
|
|
5394
|
+
repeatable: false,
|
|
5395
|
+
},
|
|
5396
|
+
{
|
|
5397
|
+
name: 'session-id',
|
|
5398
|
+
path: ['sessionId'],
|
|
5399
|
+
location: 'body',
|
|
5400
|
+
required: false,
|
|
5401
|
+
description: 'Your session or room identifier, echoed back in logs for correlation.',
|
|
5402
|
+
valueKind: 'string',
|
|
5403
|
+
repeatable: false,
|
|
5404
|
+
},
|
|
5405
|
+
{
|
|
5406
|
+
name: 'tool-name',
|
|
5407
|
+
path: ['toolName'],
|
|
5408
|
+
location: 'body',
|
|
5409
|
+
required: true,
|
|
5410
|
+
description: 'The tool the agent invoked.',
|
|
5411
|
+
valueKind: 'string',
|
|
5412
|
+
repeatable: false,
|
|
5413
|
+
},
|
|
5414
|
+
{
|
|
5415
|
+
name: 'tool-description',
|
|
5416
|
+
path: ['toolDescription'],
|
|
5417
|
+
location: 'body',
|
|
5418
|
+
required: false,
|
|
5419
|
+
description: "The tool's contract: its description and, ideally, its parameter and return shape. The more contract you pass, the more faithful the simulated response.",
|
|
5420
|
+
valueKind: 'string',
|
|
5421
|
+
repeatable: false,
|
|
5422
|
+
},
|
|
5423
|
+
{
|
|
5424
|
+
name: 'arguments',
|
|
5425
|
+
path: ['arguments'],
|
|
5426
|
+
location: 'body',
|
|
5427
|
+
required: false,
|
|
5428
|
+
description: 'The arguments the agent called the tool with, verbatim.',
|
|
5429
|
+
valueKind: 'object',
|
|
5430
|
+
repeatable: false,
|
|
5431
|
+
},
|
|
5432
|
+
],
|
|
5433
|
+
hasParams: true,
|
|
5434
|
+
paramsAllOptional: false,
|
|
5435
|
+
bodyOpaque: false,
|
|
5436
|
+
bodyVariants: [],
|
|
5437
|
+
acceptsBody: true,
|
|
5438
|
+
requiresAuth: true,
|
|
5439
|
+
},
|
|
5331
5440
|
{
|
|
5332
5441
|
commandPath: ['webhook', 'create'],
|
|
5333
5442
|
clientProperty: 'webhook',
|