@roarkanalytics/cli 0.25.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 +7 -0
- package/README.md +25 -24
- package/commands.js +64 -0
- package/completions.js +4 -4
- package/man/roark-simulation-tool-mock.1 +105 -0
- package/man/roark.1 +3 -0
- package/npm-shrinkwrap.json +5 -5
- package/package.json +2 -1
- package/version.d.ts +1 -1
- package/version.js +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
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
|
+
|
|
3
10
|
## [0.25.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.24.0...v0.25.0) (2026-09-23)
|
|
4
11
|
|
|
5
12
|
|
package/README.md
CHANGED
|
@@ -232,30 +232,31 @@ roark completion fish | source
|
|
|
232
232
|
|
|
233
233
|
### simulation
|
|
234
234
|
|
|
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
|
|
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 |
|
|
259
260
|
|
|
260
261
|
### webhook
|
|
261
262
|
|
package/commands.js
CHANGED
|
@@ -47,6 +47,7 @@ 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 = [
|
|
@@ -5373,6 +5374,69 @@ exports.COMMANDS = [
|
|
|
5373
5374
|
acceptsBody: false,
|
|
5374
5375
|
requiresAuth: true,
|
|
5375
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
|
+
},
|
|
5376
5440
|
{
|
|
5377
5441
|
commandPath: ['webhook', 'create'],
|
|
5378
5442
|
clientProperty: 'webhook',
|