@roarkanalytics/cli 0.20.0 → 0.22.0

package/man/roark-autoimprove-fix-promote.1

@@ -0,0 +1,93 @@
+.\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
+.TH "ROARK\-AUTOIMPROVE\-FIX\-PROMOTE" "1" "" "roark-autoimprove-fix-promote" "Roark Analytics API Manual"
+.SH "NAME"
+roark\-autoimprove\-fix\-promote \- Promote a verified fix to production
+.SH "SYNOPSIS"
+.B roark autoimprove fix promote
+\fIfix\-id\fR [\fIoptions\fR]
+.SH "DESCRIPTION"
+Apply the verified staging changes to the PRODUCTION agent. Only a fix in AWAITING_PROMOTE can be promoted. A snapshot of the production configuration is taken immediately before the write, so the promote is fully rollbackable. After the promote the staging shadow and its phone number are cleaned up.
+.SH "API"
+POST /v1/autoimprove/fix/{fixId}/promote
+.SH "ARGUMENTS"
+.TP
+\fIfix\-id\fR
+The fix\-id.
+.SH "GLOBAL OPTIONS"
+.TP
+\fB\-\-data\fR \fI<json>\fR
+Request body as JSON, or @file to read one (@\- for stdin).
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Skip confirmation prompts.
+.TP
+\fB\-\-no\-input\fR
+Never prompt; fail instead.
+.TP
+\fB\-\-base\-url\fR \fI<url>\fR
+API base URL.
+.TP
+\fB\-\-token\fR \fI<token>\fR
+Bearer token. Prefer ROARK_API_BEARER_TOKEN or the stored credential.
+.TP
+\fB\-\-timeout\fR \fI<ms>\fR
+Request timeout in milliseconds.
+.TP
+\fB\-\-max\-retries\fR \fI<count>\fR
+Retries for retryable failures.
+.TP
+\fB\-\-format\fR \fI<format>\fR
+Output format: auto, json, jsonl, plain.
+.TP
+\fB\-\-json\fR
+Shorthand for \-\-format json.
+.TP
+\fB\-\-no\-color\fR
+Disable colour.
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+Suppress non\-essential output.
+.TP
+\fB\-\-allow\-project\-base\-url\fR
+Send the stored credential to a base URL set by a project .roark.json. Refused by default.
+.SH "EXAMPLES"
+.PP
+.RS 4
+.nf
+roark autoimprove fix promote <fix\-id>
+.fi
+.RE
+.SH "ENVIRONMENT"
+.TP
+\fBROARK_API_BEARER_TOKEN\fR
+Bearer token used when \-\-token is not given.
+.TP
+\fBROARK_BASE_URL\fR
+API base URL.
+.TP
+\fBROARK_ALLOW_PROJECT_BASE_URL\fR
+Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
+.TP
+\fBNO_COLOR\fR
+Disables colour when set to any value.
+.SH "EXIT STATUS"
+.TP
+\fB0\fR
+The command succeeded.
+.TP
+\fB1\fR
+The API rejected the request.
+.TP
+\fB2\fR
+The command line was wrong.
+.TP
+\fB3\fR
+No credential, or the credential was refused.
+.TP
+\fB4\fR
+The addressed resource does not exist.
+.TP
+\fB5\fR
+The request never completed: connection, timeout, or abort.
+.SH "SEE ALSO"
+.BR roark (1)

package/man/roark-simulation-persona-create.1

@@ -63,7 +63,10 @@ How the persona confirms information One of: EXPLICIT, VAGUE. Optional.
 How reliable the persona's memory is One of: HIGH, LOW. Optional.
 .TP
 \fB\-\-response\-timing\fR \fI<value>\fR
-Controls how quickly the persona responds to pauses in conversation (QUICK, NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor for several seconds. One of: RELAXED, NORMAL, QUICK, BARGE_IN. Optional.
+Deprecated and inert: it no longer affects the call. It set how long the persona waited once the agent stopped talking, and measured across production simulations it moved the reply gap by less than the noise floor, because model and speech latency dominate it. Every persona now uses one voice\-activity profile. Use `interruption` for a caller who talks over the agent. Still accepted and stored so existing clients keep working. BARGE_IN is stored as `responseTiming: QUICK` with `interruption: OCCASIONAL`. One of: RELAXED, NORMAL, QUICK, BARGE_IN. Optional.
+.TP
+\fB\-\-interruption\fR \fI<value>\fR
+How much the persona talks over the agent. Defaults to OFF, a caller that waits its turn. One of: OFF, BACKCHANNEL, OCCASIONAL, HEAVY. Optional.
 .TP
 \fB\-\-backstory\-prompt\fR \fI<value>\fR
 Background story and behavioral patterns for the persona Optional.

package/man/roark-simulation-persona-update.1

@@ -67,7 +67,10 @@ How the persona confirms information One of: EXPLICIT, VAGUE. Optional.
 How reliable the persona's memory is One of: HIGH, LOW. Optional.
 .TP
 \fB\-\-response\-timing\fR \fI<value>\fR
-Controls how quickly the persona responds to pauses in conversation (QUICK, NORMAL, RELAXED). BARGE_IN also talks over the agent once it has held the floor for several seconds. One of: RELAXED, NORMAL, QUICK, BARGE_IN. Optional.
+Deprecated and inert: it no longer affects the call. It set how long the persona waited once the agent stopped talking, and measured across production simulations it moved the reply gap by less than the noise floor, because model and speech latency dominate it. Every persona now uses one voice\-activity profile. Use `interruption` for a caller who talks over the agent. Still accepted and stored so existing clients keep working. BARGE_IN is stored as `responseTiming: QUICK` with `interruption: OCCASIONAL`. One of: RELAXED, NORMAL, QUICK, BARGE_IN. Optional.
+.TP
+\fB\-\-interruption\fR \fI<value>\fR
+How much the persona talks over the agent while it is still speaking. OFF waits its turn. BACKCHANNEL makes listening noises ("mm\-hm") over the agent without taking the floor, which tests whether the agent wrongly stops for them. OCCASIONAL adds cutting in on some long agent turns, HEAVY on most of them. Timing is randomised per turn, so two runs of the same persona do not interrupt at identical moments. One of: OFF, BACKCHANNEL, OCCASIONAL, HEAVY. Optional.
 .TP
 \fB\-\-backstory\-prompt\fR \fI<value>\fR
 Background story and behavioral patterns for the persona Optional.

package/man/roark-simulation-plan-create.1

@@ -45,7 +45,7 @@ Execution mode (PARALLEL or SEQUENTIAL) One of: PARALLEL, SEQUENTIAL_SAME_RUN_PL
 Deprecated: use `flows` instead. Scenarios to include in this run plan. The same scenario ID can appear multiple times with different variables. Optional.
 .TP
 \fB\-\-flows\fR \fI<value>\fR
-Customer flows to include in this run plan. The same flow can appear more than once with a different persona override or different variables. Optional.
+Customer flows to include in this run plan. The same flow can appear more than once with a different persona override, different variables, or different `overrides`: attaching it once per value of one property is how you compare that property without a template. Optional.
 .TP
 \fB\-\-personas\fR \fI<value>\fR
 Personas to include in this run plan. Required with `scenarios`; ignored with `flows`, where each variant carries its own persona. Optional.
@@ -63,7 +63,7 @@ Also collect each attached flow's own metrics, on top of the `metrics` named her
 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. Optional.
 .TP
 \fB\-\-comparison\-property\fR \fI<value>\fR
-The property this run plan investigates: the one thing its arms differ by. Set it and the run report compares the arms on that property, so a run answers "what did background noise cost" rather than just "what did each arm score". Every value is a field already recorded on each call, so the report can label an arm `CRYING_BABY` rather than repeating a flow variant's title. Omit it and the report still compares when it can: it detects which property varies across the arms. Setting it is what tells the written summary what you were trying to find out, which detection cannot infer. One of: ACCENT, AGE, BACKGROUND_NOISE, BACKGROUND_NOISE_VOLUME, BASE_EMOTION, CONFIRMATION_STYLE, GENDER, INTENT_CLARITY, LANGUAGE, MEMORY_RELIABILITY, RESPONSE_TIMING, SPEECH_CLARITY, SPEECH_PACE. Optional.
+The property this run plan investigates: the one thing its arms differ by. Set it and the run report compares the arms on that property, so a run answers "what did background noise cost" rather than just "what did each arm score". Every value is a field already recorded on each call, so the report can label an arm `CRYING_BABY` rather than repeating a flow variant's title. Omit it and the report still compares when it can: it detects which property varies across the arms. Setting it is what tells the written summary what you were trying to find out, which detection cannot infer. One of: ACCENT, AGE, BACKGROUND_NOISE, BACKGROUND_NOISE_VOLUME, BASE_EMOTION, CONFIRMATION_STYLE, GENDER, INTENT_CLARITY, LANGUAGE, INTERRUPTION, MEMORY_RELIABILITY, RESPONSE_TIMING, SPEECH_CLARITY, SPEECH_PACE. Optional.
 .TP
 \fB\-\-comparison\-baseline\fR \fI<value>\fR
 The value of `comparisonProperty` every other value is measured against, for example `NONE` for `BACKGROUND_NOISE` or `NORMAL` for `SPEECH_PACE`. Must be a value that property can take. Stored rather than assumed, so the report can say "compared against US accent" instead of implying Roark decided which value is normal. Most properties have an obvious baseline and the dashboard prefills it; `GENDER` has none, so choose the one you are testing against. Optional.

package/man/roark-simulation-plan-update.1

@@ -73,7 +73,7 @@ Whether to also collect each attached flow's own metrics, on top of this plan's
 Whether to let the run add metrics by itself off the attached flows. See `POST /v1/simulation/plan`. Optional.
 .TP
 \fB\-\-comparison\-property\fR \fI<value>\fR
-The property this plan investigates. Send `null` to clear the comparison; omit the field to leave it unchanged. See `POST /v1/simulation/plan`. The pair moves together. Sending `comparisonProperty` also sets `comparisonBaseline` to whatever this request carries, or to `null` if it carries none, because a baseline is a value of one specific property and keeping the old one would store a pair that is not valid. One of: ACCENT, AGE, BACKGROUND_NOISE, BACKGROUND_NOISE_VOLUME, BASE_EMOTION, CONFIRMATION_STYLE, GENDER, INTENT_CLARITY, LANGUAGE, MEMORY_RELIABILITY, RESPONSE_TIMING, SPEECH_CLARITY, SPEECH_PACE. Optional.
+The property this plan investigates. Send `null` to clear the comparison; omit the field to leave it unchanged. See `POST /v1/simulation/plan`. The pair moves together. Sending `comparisonProperty` also sets `comparisonBaseline` to whatever this request carries, or to `null` if it carries none, because a baseline is a value of one specific property and keeping the old one would store a pair that is not valid. One of: ACCENT, AGE, BACKGROUND_NOISE, BACKGROUND_NOISE_VOLUME, BASE_EMOTION, CONFIRMATION_STYLE, GENDER, INTENT_CLARITY, LANGUAGE, INTERRUPTION, MEMORY_RELIABILITY, RESPONSE_TIMING, SPEECH_CLARITY, SPEECH_PACE. Optional.
 .TP
 \fB\-\-comparison\-baseline\fR \fI<value>\fR
 The value every other value is measured against. See `POST /v1/simulation/plan`. A real value cannot be sent on its own: the property it belongs to decides which values are legal, and an omitted property means "leave unchanged", which this endpoint cannot check a baseline against. Send `comparisonProperty` with it, or get a `400`. `null` on its own IS allowed, and clears just the baseline while leaving the property set. Nothing needs validating when clearing, and a property with no baseline is a real state: the report falls back to that property's own norm, and `GENDER` has no norm to fall back to. Optional.

package/man/roark.1

@@ -93,6 +93,30 @@ List a prompt's versions See roark\-agent\-prompt\-version\-list(1).
 \fBroark agent update\fR
 Update an agent See roark\-agent\-update(1).
 .TP
+\fBroark autoimprove fix answer\fR
+Answer Roark's question See roark\-autoimprove\-fix\-answer(1).
+.TP
+\fBroark autoimprove fix cancel\fR
+Cancel a fix See roark\-autoimprove\-fix\-cancel(1).
+.TP
+\fBroark autoimprove fix create\fR
+Start an Autoimprove fix See roark\-autoimprove\-fix\-create(1).
+.TP
+\fBroark autoimprove fix dismiss\fR
+Dismiss a verified fix See roark\-autoimprove\-fix\-dismiss(1).
+.TP
+\fBroark autoimprove fix get\fR
+Get an Autoimprove fix See roark\-autoimprove\-fix\-get(1).
+.TP
+\fBroark autoimprove fix guidance send\fR
+Send guidance to a running fix See roark\-autoimprove\-fix\-guidance\-send(1).
+.TP
+\fBroark autoimprove fix list\fR
+List Autoimprove fixes See roark\-autoimprove\-fix\-list(1).
+.TP
+\fBroark autoimprove fix promote\fR
+Promote a verified fix to production See roark\-autoimprove\-fix\-promote(1).
+.TP
 \fBroark benchmark leaderboard get\fR
 Get the benchmark leaderboard See roark\-benchmark\-leaderboard\-get(1).
 .TP

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@roarkanalytics/cli",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@roarkanalytics/cli",
-      "version": "0.20.0",
+      "version": "0.22.0",
       "license": "Apache-2.0",
       "dependencies": {
         "@roarkanalytics/sdk": "^3.2.1",
@@ -21,9 +21,9 @@
       }
     },
     "node_modules/@roarkanalytics/sdk": {
-      "version": "3.17.0",
-      "resolved": "https://registry.npmjs.org/@roarkanalytics/sdk/-/sdk-3.17.0.tgz",
-      "integrity": "sha512-TdaPwvqqFDwe2JqPvEn27Vu3beysLAb967aFWQetHrbOQHJcPOa3SN7RxvYe0N0w9xG1Eg0EX8wxAaeISuicDQ==",
+      "version": "3.20.0",
+      "resolved": "https://registry.npmjs.org/@roarkanalytics/sdk/-/sdk-3.20.0.tgz",
+      "integrity": "sha512-TzNHwWsEbxYWA3zdgeO+/dzSEF5XYI0HnRRuZTKru0q52VLNoRSqvD9a8L6YLd2F11bedNlHn+HN9N2hpA+alA==",
       "license": "Apache-2.0"
     },
     "node_modules/commander": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roarkanalytics/cli",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "The official command line interface for the Roark API",
   "author": "Roark <james@roark.ai>",
   "type": "commonjs",
@@ -46,6 +46,14 @@
     "./man/roark-agent-prompt-update.1",
     "./man/roark-agent-prompt-version-list.1",
     "./man/roark-agent-update.1",
+    "./man/roark-autoimprove-fix-answer.1",
+    "./man/roark-autoimprove-fix-cancel.1",
+    "./man/roark-autoimprove-fix-create.1",
+    "./man/roark-autoimprove-fix-dismiss.1",
+    "./man/roark-autoimprove-fix-get.1",
+    "./man/roark-autoimprove-fix-guidance-send.1",
+    "./man/roark-autoimprove-fix-list.1",
+    "./man/roark-autoimprove-fix-promote.1",
     "./man/roark-benchmark-leaderboard-get.1",
     "./man/roark-benchmark-metric-list.1",
     "./man/roark-benchmark-suite-list.1",

package/version.d.ts

@@ -1 +1 @@
-export declare const version = "0.20.0";
+export declare const version = "0.22.0";

package/version.js

@@ -10,4 +10,4 @@ exports.version = void 0;
 //
 // Do not edit: an edit here is overwritten, and the published number is whatever
 // package.json says.
-exports.version = '0.20.0'; // x-release-please-version
+exports.version = '0.22.0'; // x-release-please-version