@roarkanalytics/cli 0.23.1 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.25.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.24.0...v0.25.0) (2026-09-23)
+
+
+### Features
+
+* **cli:** cli update ([#62](https://github.com/roarkhq/cli-roark-analytics/issues/62)) ([940ab33](https://github.com/roarkhq/cli-roark-analytics/commit/940ab3309f5d28787e74d4644dabdbb81b6b5e45))
+
+## [0.24.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.23.1...v0.24.0) (2026-09-22)
+
+
+### Features
+
+* **cli:** cli update ([#59](https://github.com/roarkhq/cli-roark-analytics/issues/59)) ([9669eda](https://github.com/roarkhq/cli-roark-analytics/commit/9669eda9e475e8cd018d7743d446c8ee30bfdc6f))
+
 ## [0.23.1](https://github.com/roarkhq/cli-roark-analytics/compare/v0.23.0...v0.23.1) (2026-09-21)
 
 

package/README.md

@@ -110,6 +110,7 @@ roark completion fish | source
 
 | Command                                                                              | Description                 |
 | ------------------------------------------------------------------------------------ | --------------------------- |
+| `roark agent build --name <value> --job-description <value>`                         | Build a Roark-hosted agent  |
 | `roark agent create --name <value>`                                                  | Create a new agent          |
 | `roark agent endpoint create --agent-id <value> --value <value> --direction <value>` | Create a new agent endpoint |
 | `roark agent endpoint get <endpoint-id>`                                             | Get agent endpoint by ID    |
@@ -122,6 +123,17 @@ roark completion fish | source
 | `roark agent prompt version list <agent-id> <prompt-id>`                             | List a prompt's versions    |
 | `roark agent update <agent-id>`                                                      | Update an agent             |
 
+### agent-config
+
+| Command                                                                | Description                   |
+| ---------------------------------------------------------------------- | ----------------------------- |
+| `roark agent-config get <key>`                                         | Get a managed config          |
+| `roark agent-config list`                                              | List managed configs          |
+| `roark agent-config promote <key>`                                     | Promote staging to production |
+| `roark agent-config resolve <key>`                                     | Resolve config for a session  |
+| `roark agent-config staging delete <key>`                              | Discard the staging revision  |
+| `roark agent-config update <key> --channel <value> --document <value>` | Write a config revision       |
+
 ### autoimprove
 
 | Command                                                                                                              | Description                          |

package/commands.js

@@ -12,6 +12,8 @@ exports.GROUPS = {
     'agent endpoint': 'Manage agent endpoints',
     'agent prompt': 'Manage agent prompts',
     'agent prompt version': 'Read agent prompt versions',
+    'agent-config': 'Manage agent configs',
+    'agent-config staging': 'Manage agent config staging',
     autoimprove: 'Manage autoimproves',
     'autoimprove job': 'Manage autoimprove jobs',
     'autoimprove job guidance': 'Read autoimprove job guidance',
@@ -48,6 +50,51 @@ exports.GROUPS = {
     webhook: 'Manage webhooks',
 };
 exports.COMMANDS = [
+    {
+        commandPath: ['agent', 'build'],
+        clientProperty: 'agent',
+        methodName: 'build',
+        httpMethod: 'post',
+        httpPath: '/v1/agent/build',
+        summary: 'Build a Roark-hosted agent',
+        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.',
+        positionals: [],
+        flags: [
+            {
+                name: 'name',
+                path: ['name'],
+                location: 'body',
+                required: true,
+                description: 'Name of the agent',
+                valueKind: 'string',
+                repeatable: false,
+            },
+            {
+                name: 'job-description',
+                path: ['jobDescription'],
+                location: 'body',
+                required: true,
+                description: 'One-line description of what the agent should do. Roark authors the system prompt from this.',
+                valueKind: 'string',
+                repeatable: false,
+            },
+            {
+                name: 'voice',
+                path: ['voice'],
+                location: 'body',
+                required: false,
+                description: 'Optional voice label for the hosted agent',
+                valueKind: 'string',
+                repeatable: false,
+            },
+        ],
+        hasParams: true,
+        paramsAllOptional: false,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: true,
+        requiresAuth: true,
+    },
     {
         commandPath: ['agent', 'create'],
         clientProperty: 'agent',
@@ -483,6 +530,216 @@ exports.COMMANDS = [
         acceptsBody: true,
         requiresAuth: true,
     },
+    {
+        commandPath: ['agent-config', 'get'],
+        clientProperty: 'agentConfig',
+        methodName: 'getByID',
+        httpMethod: 'get',
+        httpPath: '/v1/agent-config/{key}',
+        summary: 'Get a managed config',
+        description: 'Fetch one managed config with its channel pointers and recent revisions, newest first.',
+        positionals: [
+            {
+                name: 'key',
+                paramKey: 'key',
+            },
+        ],
+        flags: [],
+        hasParams: false,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: false,
+        requiresAuth: true,
+    },
+    {
+        commandPath: ['agent-config', 'list'],
+        clientProperty: 'agentConfig',
+        methodName: 'list',
+        httpMethod: 'get',
+        httpPath: '/v1/agent-config',
+        summary: 'List managed configs',
+        description: 'List the managed agent configs in this project, most recent first.',
+        positionals: [],
+        flags: [],
+        hasParams: false,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: false,
+        requiresAuth: true,
+    },
+    {
+        commandPath: ['agent-config', 'promote'],
+        clientProperty: 'agentConfig',
+        methodName: 'promote',
+        httpMethod: 'post',
+        httpPath: '/v1/agent-config/{key}/promote',
+        summary: 'Promote staging to production',
+        description: 'Point the production channel at the staging revision. Real traffic reads it from the next session onward; roll back by writing the prior revision id to production (the chain preserves every state).',
+        positionals: [
+            {
+                name: 'key',
+                paramKey: 'key',
+            },
+        ],
+        flags: [],
+        hasParams: false,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: false,
+        requiresAuth: true,
+    },
+    {
+        commandPath: ['agent-config', 'resolve'],
+        clientProperty: 'agentConfig',
+        methodName: 'resolve',
+        httpMethod: 'post',
+        httpPath: '/v1/agent-config/{key}/resolve',
+        summary: 'Resolve config for a session',
+        description: 'The call your agent makes at session start. Returns the config JSON for this session, with per-session simulation recognition built in: when the session was originated by a Roark simulation (matched by caller number against the calls Roark has in flight), the STAGING revision is served for that session only, so Autoimprove candidates are tested on your real deployment. Real traffic always resolves to production; any recognition miss degrades to production too. On the first fetch of an unknown key, pass `defaults` (your baked-in config): the key is registered and the defaults become revision 1. That makes integration a single call. Cache the response per session; do not fetch per turn.',
+        positionals: [
+            {
+                name: 'key',
+                paramKey: 'key',
+            },
+        ],
+        flags: [
+            {
+                name: 'defaults',
+                path: ['defaults'],
+                location: 'body',
+                required: false,
+                description: 'Your baked-in config. On the first fetch of an unknown key this registers the config and becomes revision 1, so integration is a single call. Ignored once the key exists.',
+                valueKind: 'object',
+                repeatable: false,
+            },
+            {
+                name: 'session',
+                path: ['session'],
+                location: 'body',
+                required: false,
+                description: 'Session context. When the call was originated by a Roark simulation, Roark recognizes it here and serves the staging revision for this session only; real traffic always gets production.',
+                valueKind: 'object',
+            },
+            {
+                name: 'session.session-id',
+                path: ['session', 'sessionId'],
+                location: 'body',
+                required: false,
+                description: 'Your session or room identifier, for correlation.',
+                valueKind: 'string',
+                repeatable: false,
+            },
+            {
+                name: 'session.caller-number',
+                path: ['session', 'callerNumber'],
+                location: 'body',
+                required: false,
+                description: 'The number calling your agent (E.164). Required for simulation recognition.',
+                valueKind: 'string',
+                repeatable: false,
+            },
+            {
+                name: 'session.called-number',
+                path: ['session', 'calledNumber'],
+                location: 'body',
+                required: false,
+                description: 'The number your agent was reached on (E.164).',
+                valueKind: 'string',
+                repeatable: false,
+            },
+        ],
+        hasParams: true,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: true,
+        requiresAuth: true,
+    },
+    {
+        commandPath: ['agent-config', 'staging', 'delete'],
+        clientProperty: 'agentConfig',
+        methodName: 'deleteStaging',
+        httpMethod: 'delete',
+        httpPath: '/v1/agent-config/{key}/staging',
+        summary: 'Discard the staging revision',
+        description: 'Clear the staging channel. Production is untouched; recognized simulation sessions go back to reading production.',
+        positionals: [
+            {
+                name: 'key',
+                paramKey: 'key',
+            },
+        ],
+        flags: [],
+        hasParams: false,
+        paramsAllOptional: true,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: false,
+        requiresAuth: true,
+    },
+    {
+        commandPath: ['agent-config', 'update'],
+        clientProperty: 'agentConfig',
+        methodName: 'update',
+        httpMethod: 'put',
+        httpPath: '/v1/agent-config/{key}',
+        summary: 'Write a config revision',
+        description: 'Write a new revision onto a channel. Writing production creates the key when it does not exist; writing staging stages a candidate that only Roark-recognized simulation sessions will read. Every write is a new revision; nothing is overwritten.',
+        positionals: [
+            {
+                name: 'key',
+                paramKey: 'key',
+            },
+        ],
+        flags: [
+            {
+                name: 'channel',
+                path: ['channel'],
+                location: 'body',
+                required: true,
+                description: 'Which channel to write.',
+                valueKind: 'string',
+                enumValues: ['production', 'staging'],
+                repeatable: false,
+            },
+            {
+                name: 'document',
+                path: ['document'],
+                location: 'body',
+                required: true,
+                description: 'The full config JSON for the new revision.',
+                valueKind: 'object',
+                repeatable: false,
+            },
+            {
+                name: 'summary',
+                path: ['summary'],
+                location: 'body',
+                required: false,
+                description: 'One-line story of the change.',
+                valueKind: 'string',
+                repeatable: false,
+            },
+            {
+                name: 'agent-id',
+                path: ['agentId'],
+                location: 'body',
+                required: false,
+                description: 'Link this config to a Roark agent (the one your calls report). Required before Autoimprove can run on it: the link is how a fix finds the config channel.',
+                valueKind: 'string',
+                repeatable: false,
+            },
+        ],
+        hasParams: true,
+        paramsAllOptional: false,
+        bodyOpaque: false,
+        bodyVariants: [],
+        acceptsBody: true,
+        requiresAuth: true,
+    },
     {
         commandPath: ['autoimprove', 'job', 'answer'],
         clientProperty: 'autoimproveJob',
@@ -544,7 +801,7 @@ exports.COMMANDS = [
         httpMethod: 'post',
         httpPath: '/v1/autoimprove/job',
         summary: 'Start an Autoimprove job',
-        description: 'Commission Roark on an objective. It clones the agent into a staging shadow (or uses your designated staging agent), authors a validation suite of simulated callers, measures a baseline, changes the staging configuration, and re-tests until the objective metric passes its target. Production is never touched by the loop; verified changes wait for promotion. Requires an active provider integration (Vapi or Retell) with agent config writes enabled. One live job per agent: starting a second returns a conflict. The job runs asynchronously; poll GET /v1/autoimprove/job/{jobId} or watch it in the dashboard. When its status is NEEDS_INPUT, answer via the answer endpoint; when AWAITING_PROMOTE, promote or dismiss.',
+        description: 'Commission Roark on an objective. It clones the agent into a staging shadow (or uses your designated staging agent), authors a validation suite of simulated callers, measures a baseline, changes the staging configuration, and re-tests until the objective metric passes its target. Production is never touched by the loop; verified changes wait for promotion. Requires an active provider integration (Vapi, Retell, or ElevenLabs) with agent config writes enabled. One live job per agent: starting a second returns a conflict. The job runs asynchronously; poll GET /v1/autoimprove/job/{jobId} or watch it in the dashboard. When its status is NEEDS_INPUT, answer via the answer endpoint; when AWAITING_PROMOTE, promote or dismiss.',
         positionals: [],
         flags: [
             {