@roarkanalytics/cli 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.9.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.8.0...v0.9.0) (2026-09-10)
+
+
+### Features
+
+* **cli:** cli update ([#26](https://github.com/roarkhq/cli-roark-analytics/issues/26)) ([23042b3](https://github.com/roarkhq/cli-roark-analytics/commit/23042b34d2dfa69e9d27c25e16ce963fbd1fbeb5))
+
+## [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)
 
 

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',
@@ -2652,6 +2829,15 @@ exports.COMMANDS = [
                 valueKind: 'string',
                 repeatable: false,
             },
+            {
+                name: 'display-name',
+                path: ['displayName'],
+                location: 'body',
+                required: false,
+                description: 'Label shown in place of the name across the dashboard (e.g. a short descriptor like "Irate Escalator"). The persona still identifies as `name` on calls. Omit or set null to display the name itself.',
+                valueKind: 'string',
+                repeatable: false,
+            },
             {
                 name: 'description',
                 path: ['description'],
@@ -3033,6 +3219,15 @@ exports.COMMANDS = [
                 valueKind: 'string',
                 repeatable: false,
             },
+            {
+                name: 'display-name',
+                path: ['displayName'],
+                location: 'body',
+                required: false,
+                description: 'Label shown in place of the name across the dashboard (e.g. a short descriptor like "Irate Escalator"). The persona still identifies as `name` on calls. Omit or set null to display the name itself.',
+                valueKind: 'string',
+                repeatable: false,
+            },
             {
                 name: 'description',
                 path: ['description'],
@@ -3480,6 +3675,15 @@ exports.COMMANDS = [
                 valueKind: 'boolean',
                 repeatable: false,
             },
+            {
+                name: 'include-automatic-metrics',
+                path: ['includeAutomaticMetrics'],
+                location: 'body',
+                required: false,
+                description: 'Let the run add metrics by itself off the attached flows, on top of the `metrics` named here. Two attach this way today: Agent Expectations wherever an attached flow has agent expectations written on it, and Keypad Entry wherever one has steps where the agent is expected to press keys. Both grade something authored on the flow that nothing else measures, which is why it is on by default. Set false when the `metrics` list is meant to be exhaustive: a plan testing only whether the caller can complete the flow may not want the agent graded on its expectations as well. False also pins the plan against any automatic metric Roark adds later.',
+                valueKind: 'boolean',
+                repeatable: false,
+            },
             {
                 name: 'enrich-with-live-conversation',
                 path: ['enrichWithLiveConversation'],
@@ -3928,6 +4132,15 @@ exports.COMMANDS = [
                 valueKind: 'boolean',
                 repeatable: false,
             },
+            {
+                name: 'include-automatic-metrics',
+                path: ['includeAutomaticMetrics'],
+                location: 'body',
+                required: false,
+                description: 'Whether to let the run add metrics by itself off the attached flows. See `POST /v1/simulation/plan`.',
+                valueKind: 'boolean',
+                repeatable: false,
+            },
         ],
         hasParams: true,
         paramsAllOptional: true,