@roarkanalytics/cli 0.56.1 → 0.58.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 CHANGED
@@ -1,5 +1,19 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.58.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.57.0...v0.58.0) (2026-10-28)
4
+
5
+
6
+ ### Features
7
+
8
+ * **cli:** cli update ([#150](https://github.com/roarkhq/cli-roark-analytics/issues/150)) ([0bb4471](https://github.com/roarkhq/cli-roark-analytics/commit/0bb44717ab2b6e7569ae0f9033bbd359a384ffc4))
9
+
10
+ ## [0.57.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.56.1...v0.57.0) (2026-10-27)
11
+
12
+
13
+ ### Features
14
+
15
+ * **cli:** cli update ([#148](https://github.com/roarkhq/cli-roark-analytics/issues/148)) ([1578c90](https://github.com/roarkhq/cli-roark-analytics/commit/1578c905a0be002255faa24e4ab5f7abbd015c25))
16
+
3
17
  ## [0.56.1](https://github.com/roarkhq/cli-roark-analytics/compare/v0.56.0...v0.56.1) (2026-10-27)
4
18
 
5
19
 
package/README.md CHANGED
@@ -108,20 +108,20 @@ roark completion fish | source
108
108
 
109
109
  ### agent
110
110
 
111
- | Command | Description |
112
- | ------------------------------------------------------------------------------------ | --------------------------- |
113
- | `roark agent build --name <value> --job-description <value>` | Build a Roark-hosted agent |
114
- | `roark agent create --name <value>` | Create a new agent |
115
- | `roark agent endpoint create --agent-id <value> --value <value> --direction <value>` | Create a new agent endpoint |
116
- | `roark agent endpoint get <endpoint-id>` | Get agent endpoint by ID |
117
- | `roark agent endpoint list` | List agent endpoints |
118
- | `roark agent endpoint update <endpoint-id>` | Update an agent endpoint |
119
- | `roark agent get <agent-id>` | Get agent by ID |
120
- | `roark agent list` | List agents |
121
- | `roark agent prompt list <agent-id>` | List an agent's prompts |
122
- | `roark agent prompt update <agent-id> --prompt <value>` | Set an agent's prompt |
123
- | `roark agent prompt version list <agent-id> <prompt-id>` | List a prompt's versions |
124
- | `roark agent update <agent-id>` | Update an agent |
111
+ | Command | Description |
112
+ | ---------------------------------------------------------------------------------------------------------- | --------------------------- |
113
+ | `roark agent build --name <value> --job-description <value> --tts.provider <value> --tts.voice-id <value>` | Build a Roark-hosted agent |
114
+ | `roark agent create --name <value>` | Create a new agent |
115
+ | `roark agent endpoint create --agent-id <value> --value <value> --direction <value>` | Create a new agent endpoint |
116
+ | `roark agent endpoint get <endpoint-id>` | Get agent endpoint by ID |
117
+ | `roark agent endpoint list` | List agent endpoints |
118
+ | `roark agent endpoint update <endpoint-id>` | Update an agent endpoint |
119
+ | `roark agent get <agent-id>` | Get agent by ID |
120
+ | `roark agent list` | List agents |
121
+ | `roark agent prompt list <agent-id>` | List an agent's prompts |
122
+ | `roark agent prompt update <agent-id> --prompt <value>` | Set an agent's prompt |
123
+ | `roark agent prompt version list <agent-id> <prompt-id>` | List a prompt's versions |
124
+ | `roark agent update <agent-id>` | Update an agent |
125
125
 
126
126
  ### agent-config
127
127
 
@@ -271,7 +271,7 @@ roark completion fish | source
271
271
  | --------------------------------------------- | ------------------------------ |
272
272
  | `roark phone-number allowance get` | Get the phone number allowance |
273
273
  | `roark phone-number available list` | Search available phone numbers |
274
- | `roark phone-number create --e164 <value>` | Buy a phone number |
274
+ | `roark phone-number create` | Buy a phone number |
275
275
  | `roark phone-number delete <phone-number-id>` | Release a phone number |
276
276
  | `roark phone-number list` | List phone numbers |
277
277
  | `roark phone-number update <phone-number-id>` | Update a phone number |
package/commands.js CHANGED
@@ -107,7 +107,33 @@ exports.COMMANDS = [
107
107
  path: ['voice'],
108
108
  location: 'body',
109
109
  required: false,
110
- description: 'Optional voice label for the hosted agent',
110
+ description: "Optional display name of the agent's voice. The authored prompt matches its delivery to it.",
111
+ valueKind: 'string',
112
+ repeatable: false,
113
+ },
114
+ {
115
+ name: 'tts',
116
+ path: ['tts'],
117
+ location: 'body',
118
+ required: false,
119
+ description: 'Optional provider voice the hosted agent speaks with',
120
+ valueKind: 'object',
121
+ },
122
+ {
123
+ name: 'tts.provider',
124
+ path: ['tts', 'provider'],
125
+ location: 'body',
126
+ required: true,
127
+ description: 'Text-to-speech provider, for example ELEVENLABS. Not checked against a known list.',
128
+ valueKind: 'string',
129
+ repeatable: false,
130
+ },
131
+ {
132
+ name: 'tts.voice-id',
133
+ path: ['tts', 'voiceId'],
134
+ location: 'body',
135
+ required: true,
136
+ description: "The provider's id for the voice",
111
137
  valueKind: 'string',
112
138
  repeatable: false,
113
139
  },
@@ -4654,15 +4680,35 @@ exports.COMMANDS = [
4654
4680
  httpMethod: 'get',
4655
4681
  httpPath: '/v1/phone-number/available',
4656
4682
  summary: 'Search available phone numbers',
4657
- description: 'Returns US numbers the carrier has for sale, narrowed by area code or by digits the number must contain. Buy one with POST /v1/phone-number.',
4683
+ description: 'Returns US or Canadian numbers the carrier has for sale, local or toll-free, narrowed by area code or by digits the number must contain. When an area code has no numbers, nearby ones are returned flagged bestEffort; an empty list means nothing matched. Buy one with POST /v1/phone-number, or let Roark pick with autoPick.',
4658
4684
  positionals: [],
4659
4685
  flags: [
4686
+ {
4687
+ name: 'country',
4688
+ path: ['country'],
4689
+ location: 'query',
4690
+ required: false,
4691
+ description: 'ISO 3166-1 alpha-2 country of the number: US or CA',
4692
+ valueKind: 'string',
4693
+ enumValues: ['US', 'CA'],
4694
+ repeatable: false,
4695
+ },
4696
+ {
4697
+ name: 'number-type',
4698
+ path: ['numberType'],
4699
+ location: 'query',
4700
+ required: false,
4701
+ description: 'LOCAL for a number in an area code, TOLL_FREE for one from the shared US and Canada toll-free pool',
4702
+ valueKind: 'string',
4703
+ enumValues: ['LOCAL', 'TOLL_FREE'],
4704
+ repeatable: false,
4705
+ },
4660
4706
  {
4661
4707
  name: 'area-code',
4662
4708
  path: ['areaCode'],
4663
4709
  location: 'query',
4664
4710
  required: false,
4665
- description: 'Three-digit US area code',
4711
+ description: 'Three-digit area code, or a toll-free prefix such as 800. When it has no numbers, nearby ones are returned instead, flagged bestEffort.',
4666
4712
  valueKind: 'string',
4667
4713
  repeatable: false,
4668
4714
  },
@@ -4680,7 +4726,7 @@ exports.COMMANDS = [
4680
4726
  path: ['limit'],
4681
4727
  location: 'query',
4682
4728
  required: false,
4683
- description: 'Maximum number of results (default: 20, max: 50)',
4729
+ description: 'Maximum number of results (default: 20, max: 100)',
4684
4730
  valueKind: 'integer',
4685
4731
  repeatable: false,
4686
4732
  },
@@ -4699,18 +4745,74 @@ exports.COMMANDS = [
4699
4745
  httpMethod: 'post',
4700
4746
  httpPath: '/v1/phone-number',
4701
4747
  summary: 'Buy a phone number',
4702
- description: 'Buys a number from the carrier for this project. Free inside the plan allowance; past it, the first month of rent is charged now and monthly after that.',
4748
+ description: 'Buys a number from the carrier for this project: the one named by e164, or one Roark picks to match autoPick (trying the next match if the carrier has just sold one). Free inside the plan allowance; past it, the first month of rent is charged now and monthly after that.',
4703
4749
  positionals: [],
4704
4750
  flags: [
4705
4751
  {
4706
4752
  name: 'e164',
4707
4753
  path: ['e164'],
4708
4754
  location: 'body',
4709
- required: true,
4710
- description: 'The number to buy, in E.164 format, from a search result',
4755
+ required: false,
4756
+ description: 'The number to buy, in E.164 format, from a search result. Give this or autoPick.',
4711
4757
  valueKind: 'string',
4712
4758
  repeatable: false,
4713
4759
  },
4760
+ {
4761
+ name: 'auto-pick',
4762
+ path: ['autoPick'],
4763
+ location: 'body',
4764
+ required: false,
4765
+ description: 'What the number Roark picks should look like. Roark buys the first matching number the carrier will sell, preferring the area code and falling back to a nearby one.',
4766
+ valueKind: 'object',
4767
+ },
4768
+ {
4769
+ name: 'auto-pick.country',
4770
+ path: ['autoPick', 'country'],
4771
+ location: 'body',
4772
+ required: false,
4773
+ description: 'ISO 3166-1 alpha-2 country of the number: US or CA',
4774
+ valueKind: 'string',
4775
+ enumValues: ['US', 'CA'],
4776
+ repeatable: false,
4777
+ },
4778
+ {
4779
+ name: 'auto-pick.number-type',
4780
+ path: ['autoPick', 'numberType'],
4781
+ location: 'body',
4782
+ required: false,
4783
+ description: 'LOCAL for a number in an area code, TOLL_FREE for one from the shared US and Canada toll-free pool',
4784
+ valueKind: 'string',
4785
+ enumValues: ['LOCAL', 'TOLL_FREE'],
4786
+ repeatable: false,
4787
+ },
4788
+ {
4789
+ name: 'auto-pick.area-code',
4790
+ path: ['autoPick', 'areaCode'],
4791
+ location: 'body',
4792
+ required: false,
4793
+ description: 'Three-digit area code, or a toll-free prefix such as 800. When it has no numbers, nearby ones are returned instead, flagged bestEffort.',
4794
+ valueKind: 'string',
4795
+ repeatable: false,
4796
+ },
4797
+ {
4798
+ name: 'auto-pick.contains',
4799
+ path: ['autoPick', 'contains'],
4800
+ location: 'body',
4801
+ required: false,
4802
+ description: 'Digits or letters the number must contain (1 to 7, * matches any digit)',
4803
+ valueKind: 'string',
4804
+ repeatable: false,
4805
+ },
4806
+ {
4807
+ name: 'country',
4808
+ path: ['country'],
4809
+ location: 'body',
4810
+ required: false,
4811
+ description: 'The country of the number given by e164 (default: US). An auto-picked number uses autoPick.country.',
4812
+ valueKind: 'string',
4813
+ enumValues: ['US', 'CA'],
4814
+ repeatable: false,
4815
+ },
4714
4816
  {
4715
4817
  name: 'name',
4716
4818
  path: ['name'],
@@ -4749,7 +4851,7 @@ exports.COMMANDS = [
4749
4851
  },
4750
4852
  ],
4751
4853
  hasParams: true,
4752
- paramsAllOptional: false,
4854
+ paramsAllOptional: true,
4753
4855
  bodyOpaque: false,
4754
4856
  bodyVariants: [],
4755
4857
  acceptsBody: true,