@roarkanalytics/cli 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.8.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.7.0...v0.8.0) (2026-09-09)
+
+
+### Features
+
+* **cli:** cli update ([#23](https://github.com/roarkhq/cli-roark-analytics/issues/23)) ([3125bb5](https://github.com/roarkhq/cli-roark-analytics/commit/3125bb5cd53fadf570140e437034261ad2f50edf))
+
+## [0.7.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.6.0...v0.7.0) (2026-09-08)
+
+
+### Features
+
+* **cli:** cli update ([#21](https://github.com/roarkhq/cli-roark-analytics/issues/21)) ([5ae1ec8](https://github.com/roarkhq/cli-roark-analytics/commit/5ae1ec8f65f63e07ecdd54427de9f5232bb26c2c))
+
 ## [0.6.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.5.0...v0.6.0) (2026-09-08)
 
 

package/README.md

@@ -144,6 +144,7 @@ roark completion fish | source
 | ---------------------------------------------------------------- | -------------------------------------- |
 | `roark customer-flow create --data '{ ... }'`                    | Create a customer flow                 |
 | `roark customer-flow delete <flow-id>`                           | Delete a customer flow                 |
+| `roark customer-flow duplicate <flow-id>`                        | Duplicate a customer flow              |
 | `roark customer-flow edge-case create <flow-id> --title <value>` | Add an edge case                       |
 | `roark customer-flow edge-case delete <flow-id> <edge-case-id>`  | Remove an edge case                    |
 | `roark customer-flow edge-case promote <flow-id> <edge-case-id>` | Promote an edge case to the happy path |
@@ -194,8 +195,11 @@ roark completion fish | source
 
 | Command                                                                                                                                                 | Description               |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
+| `roark simulation environment create --name <value> --background-noise <value>`                                                                         | Create an environment     |
+| `roark simulation environment delete <environment-id>`                                                                                                  | Delete an environment     |
 | `roark simulation environment get <environment-id>`                                                                                                     | Get environment by ID     |
 | `roark simulation environment list`                                                                                                                     | List environments         |
+| `roark simulation environment update <environment-id>`                                                                                                  | Update an environment     |
 | `roark simulation job get <job-id>`                                                                                                                     | Get simulation by ID      |
 | `roark simulation job lookup --roark-phone-number <value>`                                                                                              | Lookup by phone number    |
 | `roark simulation persona create --name <value> --language <value> --accent <value> --gender <value>`                                                   | Create a new persona      |

package/commands.js

@@ -27,7 +27,7 @@ exports.GROUPS = {
     'metric policy': 'Manage metric policies',
     'metric variant': 'Manage metric variants',
     simulation: 'Manage simulations',
-    'simulation environment': 'Read simulation environments',
+    'simulation environment': 'Manage simulation environments',
     'simulation job': 'Read simulation jobs',
     'simulation persona': 'Manage simulation personas',
     'simulation plan': 'Manage simulation plans',
@@ -970,6 +970,28 @@ exports.COMMANDS = [
         acceptsBody: false,
         requiresAuth: true,
     },
+    {
+        commandPath: ['customer-flow', 'duplicate'],
+        clientProperty: 'customerFlow',
+        methodName: 'duplicate',
+        httpMethod: 'post',
+        httpPath: '/v1/customer-flow/{flowId}/duplicate',
+        summary: 'Duplicate a customer flow',
+        description: "Deep-copies a flow into a new project-owned flow. The copy carries the source's description, branching mode, linked agents, flow-level expectations and flow-owned metrics. A scripted flow copies its whole step graph; an improv flow copies its variants (personas, briefs, expectations). Duplicating a Roark-managed flow is how you customise it. Voicemail flows are Roark-managed and cannot be duplicated.",
+        positionals: [
+            {
+                name: 'flow-id',
+                paramKey: 'flowId',
+            },
+        ],
+        flags: [],
+        hasParams: true,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: true,
+        requiresAuth: true,
+    },
     {
         commandPath: ['customer-flow', 'edge-case', 'create'],
         clientProperty: 'customerFlowEdgeCase',
@@ -2518,6 +2540,92 @@ exports.COMMANDS = [
         acceptsBody: true,
         requiresAuth: true,
     },
+    {
+        commandPath: ['simulation', 'environment', 'create'],
+        clientProperty: 'simulationEnvironment',
+        methodName: 'create',
+        httpMethod: 'post',
+        httpPath: '/v1/simulation/environment',
+        summary: 'Create an environment',
+        description: "Creates an environment for the project: a noise bed and the level it plays at. Reference it by id when setting a customer flow variant's environment. Roark's curated presets always play at the default level, so this is how a project gets the same bed louder or quieter.",
+        positionals: [],
+        flags: [
+            {
+                name: 'name',
+                path: ['name'],
+                location: 'body',
+                required: true,
+                description: 'Display name, shown wherever a flow variant references the environment',
+                valueKind: 'string',
+                repeatable: false,
+            },
+            {
+                name: 'description',
+                path: ['description'],
+                location: 'body',
+                required: false,
+                description: 'Optional note on when to use this environment',
+                valueKind: 'string',
+                repeatable: false,
+            },
+            {
+                name: 'background-noise',
+                path: ['backgroundNoise'],
+                location: 'body',
+                required: true,
+                description: 'The noise bed played underneath the simulated caller. NONE plays nothing.',
+                valueKind: 'string',
+                enumValues: [
+                    'NONE',
+                    'AIRPORT',
+                    'CHILDREN_PLAYING',
+                    'CITY',
+                    'COFFEE_SHOP',
+                    'DRIVING',
+                    'OFFICE',
+                    'THUNDERSTORM',
+                ],
+                repeatable: false,
+            },
+            {
+                name: 'background-noise-volume',
+                path: ['backgroundNoiseVolume'],
+                location: 'body',
+                required: false,
+                description: 'How loud the bed plays, as a gain from 0 (silent) to 1 (as loud as the caller). Defaults to 0.1, which sits well under the caller. Ignored on Vapi endpoints, which have no level control.',
+                valueKind: 'number',
+                repeatable: false,
+            },
+        ],
+        hasParams: true,
+        paramsAllOptional: false,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: true,
+        requiresAuth: true,
+    },
+    {
+        commandPath: ['simulation', 'environment', 'delete'],
+        clientProperty: 'simulationEnvironment',
+        methodName: 'delete',
+        httpMethod: 'delete',
+        httpPath: '/v1/simulation/environment/{environmentId}',
+        summary: 'Delete an environment',
+        description: "Soft-deletes one of the project's environments. It disappears from reads and cannot be picked for new runs; runs already built keep their snapshot. Refused (409) while a live customer flow variant still uses it: move those variants first. Roark-curated environments cannot be deleted (403).",
+        positionals: [
+            {
+                name: 'environment-id',
+                paramKey: 'environmentId',
+            },
+        ],
+        flags: [],
+        hasParams: false,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: false,
+        requiresAuth: true,
+    },
     {
         commandPath: ['simulation', 'environment', 'get'],
         clientProperty: 'simulationEnvironment',
@@ -2574,6 +2682,75 @@ exports.COMMANDS = [
         acceptsBody: false,
         requiresAuth: true,
     },
+    {
+        commandPath: ['simulation', 'environment', 'update'],
+        clientProperty: 'simulationEnvironment',
+        methodName: 'update',
+        httpMethod: 'put',
+        httpPath: '/v1/simulation/environment/{environmentId}',
+        summary: 'Update an environment',
+        description: "Updates one of the project's environments. Only the fields sent are changed. Runs already built keep the snapshot they were built with. Roark-curated environments cannot be edited (403).",
+        positionals: [
+            {
+                name: 'environment-id',
+                paramKey: 'environmentId',
+            },
+        ],
+        flags: [
+            {
+                name: 'name',
+                path: ['name'],
+                location: 'body',
+                required: false,
+                description: 'Display name, shown wherever a flow variant references the environment',
+                valueKind: 'string',
+                repeatable: false,
+            },
+            {
+                name: 'description',
+                path: ['description'],
+                location: 'body',
+                required: false,
+                description: 'Optional note on when to use this environment',
+                valueKind: 'string',
+                repeatable: false,
+            },
+            {
+                name: 'background-noise',
+                path: ['backgroundNoise'],
+                location: 'body',
+                required: false,
+                description: 'The noise bed played underneath the simulated caller. NONE plays nothing.',
+                valueKind: 'string',
+                enumValues: [
+                    'NONE',
+                    'AIRPORT',
+                    'CHILDREN_PLAYING',
+                    'CITY',
+                    'COFFEE_SHOP',
+                    'DRIVING',
+                    'OFFICE',
+                    'THUNDERSTORM',
+                ],
+                repeatable: false,
+            },
+            {
+                name: 'background-noise-volume',
+                path: ['backgroundNoiseVolume'],
+                location: 'body',
+                required: false,
+                description: 'How loud the bed plays, as a gain from 0 (silent) to 1 (as loud as the caller). Defaults to 0.1, which sits well under the caller. Ignored on Vapi endpoints, which have no level control.',
+                valueKind: 'number',
+                repeatable: false,
+            },
+        ],
+        hasParams: true,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: true,
+        requiresAuth: true,
+    },
     {
         commandPath: ['simulation', 'job', 'get'],
         clientProperty: 'simulationJob',
@@ -3943,7 +4120,7 @@ exports.COMMANDS = [
         httpMethod: 'post',
         httpPath: '/v1/simulation/run',
         summary: 'Run a simulation',
-        description: 'Starts a simulation and returns the run. Send `plan` to describe a simulation and run it once. Add `saveAsPlan` to keep that configuration as a reusable run plan. Send `planId` instead to run a plan you already have.',
+        description: 'Starts a simulation and returns the run. Send `template` to run one of the built-in templates: it supplies the metrics and checks, and for some templates the flows too, so the request only names the agent and the direction. Send `plan` to describe a simulation yourself and run it once. Send `planId` to run a plan you already have. `template` and `plan` both resolve to a run plan, returned as `simulationRunPlanId`. Add `saveAsPlan` to keep it, or read it back to see exactly what ran. A plan built from a template is a snapshot: retuning the template later never changes what that plan runs, which is what makes a saved one safe to pin in CI.',
         positionals: [],
         flags: [],
         hasParams: true,
@@ -3958,6 +4135,10 @@ exports.COMMANDS = [
                 name: 'RunSimulationFromPlanId',
                 required: ['planId'],
             },
+            {
+                name: 'RunSimulationFromTemplate',
+                required: ['template', 'agentEndpoints', 'direction'],
+            },
         ],
         acceptsBody: true,
         requiresAuth: true,