@ora-ai/cli 0.14.0 → 0.16.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/README.md CHANGED
@@ -12,6 +12,10 @@ matches the API: `https://api.agentfront.sh/openapi.json`.
12
12
  (`npx @ora-ai/cli` also works. Note: bare `npx ora` fetches an unrelated npm
13
13
  spinner library — always use the scoped package name with npx.)
14
14
 
15
+ Once a day the CLI checks npm and prints one line on stderr when a newer
16
+ version is out (never with `--json`, so its stderr stays JSON). Set
17
+ `ORA_NO_UPDATE_CHECK=1` to turn it off.
18
+
15
19
  ## Interactive
16
20
 
17
21
  Just run `ora` — browse every command, get prompted for arguments, and see
@@ -144,6 +148,7 @@ After a run completes, read its artifacts:
144
148
 
145
149
  ### Intents — AEO measurement (studio)
146
150
 
151
+ ora agents # the harness × model pairs you can measure with
147
152
  ora intents list
148
153
  cat > intent.json <<'EOF'
149
154
  { "title": "Best AEO platform for B2B SaaS", "layer": "discovery" }
@@ -170,6 +175,7 @@ After a run completes, read its artifacts:
170
175
  ora goals list <intent-id>
171
176
  ora goals report <intent-id> --window 30d # answer score per question type, weakest checks, prompt × agent grid, Studio link
172
177
  ora intents insights <intent-id> # what to fix: issues, pages that failed, MCP / API tool calls, what each agent said
178
+ ora intents answers <intent-id> # every answer of a measurement: each brand's status, quote, reasons, drawbacks, who was recommended instead
173
179
  ora intents analytics <intent-id> --window 30d # layers, positioning per question type, agents, brands, cited sources
174
180
  ora intents history <intent-id> # each measurement, newest first, with its answer score
175
181
  ora goals delete <goal-id> # deactivate (kept, no longer scored)
@@ -21,6 +21,7 @@ export interface BodyFieldMeta {
21
21
  export interface OperationMeta {
22
22
  id: string;
23
23
  commandPath: string[];
24
+ aliases?: string[][];
24
25
  method: "get" | "post" | "put" | "patch" | "delete";
25
26
  pathTemplate: string;
26
27
  summary: string;
@@ -40,7 +41,7 @@ export interface OperationMeta {
40
41
  }
41
42
  export declare const SPEC: {
42
43
  readonly version: "1.0.0";
43
- readonly contentHash: "eb6b799f0a518958f43d043f29568d40e76e706cf7198aee4ae39ad42b558f1c";
44
+ readonly contentHash: "50b4316a9bb1828f4be8ebe1007aaf935931fc0d7a8299eea96f3f8f1a092201";
44
45
  readonly server: "https://api.ora.ai";
45
46
  readonly bin: "ora";
46
47
  };
@@ -1 +1 @@
1
- {"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/generated/operations.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,IAAI;;;;;CAKP,CAAC;AAEX,eAAO,MAAM,UAAU,EAAE,aAAa,EA00RrC,CAAC"}
1
+ {"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/generated/operations.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,IAAI;;;;;CAKP,CAAC;AAEX,eAAO,MAAM,UAAU,EAAE,aAAa,EA++RrC,CAAC"}
@@ -1,9 +1,9 @@
1
1
  // GENERATED by scripts/generate.mjs — DO NOT EDIT.
2
- // Source: openapi/ora-public.openapi.json (sha256 eb6b799f0a518958f43d043f29568d40e76e706cf7198aee4ae39ad42b558f1c)
2
+ // Source: openapi/ora-public.openapi.json (sha256 50b4316a9bb1828f4be8ebe1007aaf935931fc0d7a8299eea96f3f8f1a092201)
3
3
  // Regenerate: yarn nx run ora-cli:generate
4
4
  export const SPEC = {
5
5
  "version": "1.0.0",
6
- "contentHash": "eb6b799f0a518958f43d043f29568d40e76e706cf7198aee4ae39ad42b558f1c",
6
+ "contentHash": "50b4316a9bb1828f4be8ebe1007aaf935931fc0d7a8299eea96f3f8f1a092201",
7
7
  "server": "https://api.ora.ai",
8
8
  "bin": "ora"
9
9
  };
@@ -85,6 +85,32 @@ export const OPERATIONS = [
85
85
  "command": "ora addons list"
86
86
  }
87
87
  },
88
+ {
89
+ "id": "agents",
90
+ "commandPath": [
91
+ "agents"
92
+ ],
93
+ "aliases": [
94
+ [
95
+ "intents",
96
+ "agents"
97
+ ]
98
+ ],
99
+ "method": "get",
100
+ "pathTemplate": "/studio/v1/agents",
101
+ "summary": "The agents (harness × model) Studio can measure with for your organization. `available: false` gives the reason, such as a plan that doesn't include it. Use these pairs as `agents` in intents measurement-policy, intents bulk-create and journeys create",
102
+ "scope": "intents:read",
103
+ "product": "studio",
104
+ "pathParams": [],
105
+ "queryParams": [],
106
+ "hasBody": false,
107
+ "bodyRequired": false,
108
+ "isStream": false,
109
+ "watchable": false,
110
+ "help": {
111
+ "command": "ora agents"
112
+ }
113
+ },
88
114
  {
89
115
  "id": "analytics.export",
90
116
  "commandPath": [
@@ -3722,7 +3748,7 @@ export const OPERATIONS = [
3722
3748
  ],
3723
3749
  "method": "post",
3724
3750
  "pathTemplate": "/studio/v1/intents/{id}/goals",
3725
- "summary": "Add a goal to an intent. An answer_check goal is an answer criterion: give its criterionGroup, the question type it is checked on (discover, choose, verify, inform, guide, act); without one, Ora files it under a type",
3751
+ "summary": "Add a goal to an intent. An answer_check goal is an answer criterion, checked on the question types in `types` (discover, choose, verify, inform, guide, act), or on every type with `types: \"all\"` (the default)",
3726
3752
  "scope": "intents:write",
3727
3753
  "product": "studio",
3728
3754
  "pathParams": [
@@ -3760,6 +3786,29 @@ export const OPERATIONS = [
3760
3786
  ],
3761
3787
  "placeholder": "choose"
3762
3788
  },
3789
+ {
3790
+ "name": "types",
3791
+ "required": false,
3792
+ "kind": "string",
3793
+ "placeholder": "<types>"
3794
+ },
3795
+ {
3796
+ "name": "category",
3797
+ "required": false,
3798
+ "kind": "string",
3799
+ "enum": [
3800
+ "recommended",
3801
+ "answered",
3802
+ "accurate",
3803
+ "informed",
3804
+ "capability",
3805
+ "real_steps",
3806
+ "safe",
3807
+ "task_done",
3808
+ "other"
3809
+ ],
3810
+ "placeholder": "recommended"
3811
+ },
3763
3812
  {
3764
3813
  "name": "title",
3765
3814
  "required": true,
@@ -3791,6 +3840,31 @@ export const OPERATIONS = [
3791
3840
  "body": "{\n \"kind\": \"answer_check\",\n \"title\": \"Acme DB is the first pick\",\n \"statement\": \"The answer recommends Acme DB as its first option for hosting the database.\",\n \"criterionGroup\": \"choose\"\n}"
3792
3841
  }
3793
3842
  },
3843
+ {
3844
+ "id": "goals.criteriaQuestionTypes",
3845
+ "commandPath": [
3846
+ "goals",
3847
+ "criteria-question-types"
3848
+ ],
3849
+ "method": "get",
3850
+ "pathTemplate": "/studio/v1/intents/{id}/criteria/question-types",
3851
+ "summary": "The question types the intent's prompts ask, each of which takes answer criteria",
3852
+ "scope": "intents:read",
3853
+ "product": "studio",
3854
+ "pathParams": [
3855
+ {
3856
+ "name": "id"
3857
+ }
3858
+ ],
3859
+ "queryParams": [],
3860
+ "hasBody": false,
3861
+ "bodyRequired": false,
3862
+ "isStream": false,
3863
+ "watchable": false,
3864
+ "help": {
3865
+ "command": "ora goals criteria-question-types <id>"
3866
+ }
3867
+ },
3794
3868
  {
3795
3869
  "id": "goals.delete",
3796
3870
  "commandPath": [
@@ -3879,6 +3953,54 @@ export const OPERATIONS = [
3879
3953
  "command": "ora goals report <id>"
3880
3954
  }
3881
3955
  },
3956
+ {
3957
+ "id": "goals.suggestCriteria",
3958
+ "commandPath": [
3959
+ "goals",
3960
+ "suggest-criteria"
3961
+ ],
3962
+ "method": "post",
3963
+ "pathTemplate": "/studio/v1/intents/{id}/criteria/suggestions",
3964
+ "summary": "Ora's suggested criteria for the question types the intent's prompts ask (or the `types` given), from the business profile, the intent and its tools. Nothing is saved",
3965
+ "scope": "intents:write",
3966
+ "product": "studio",
3967
+ "pathParams": [
3968
+ {
3969
+ "name": "id"
3970
+ }
3971
+ ],
3972
+ "queryParams": [],
3973
+ "hasBody": true,
3974
+ "bodyRequired": true,
3975
+ "isStream": false,
3976
+ "bodyFields": [
3977
+ {
3978
+ "name": "types",
3979
+ "required": false,
3980
+ "kind": "array",
3981
+ "placeholder": "[]"
3982
+ },
3983
+ {
3984
+ "name": "type",
3985
+ "required": false,
3986
+ "kind": "string",
3987
+ "enum": [
3988
+ "discover",
3989
+ "choose",
3990
+ "verify",
3991
+ "inform",
3992
+ "guide",
3993
+ "act"
3994
+ ],
3995
+ "placeholder": "discover"
3996
+ }
3997
+ ],
3998
+ "watchable": false,
3999
+ "help": {
4000
+ "command": "ora goals suggest-criteria <id> --file run.json",
4001
+ "body": "{\n \"types\": [],\n \"type\": \"discover\"\n}"
4002
+ }
4003
+ },
3882
4004
  {
3883
4005
  "id": "goals.update",
3884
4006
  "commandPath": [
@@ -3923,6 +4045,29 @@ export const OPERATIONS = [
3923
4045
  "required": false,
3924
4046
  "kind": "string",
3925
4047
  "placeholder": "<config>"
4048
+ },
4049
+ {
4050
+ "name": "types",
4051
+ "required": false,
4052
+ "kind": "string",
4053
+ "placeholder": "<types>"
4054
+ },
4055
+ {
4056
+ "name": "category",
4057
+ "required": false,
4058
+ "kind": "string",
4059
+ "enum": [
4060
+ "recommended",
4061
+ "answered",
4062
+ "accurate",
4063
+ "informed",
4064
+ "capability",
4065
+ "real_steps",
4066
+ "safe",
4067
+ "task_done",
4068
+ "other"
4069
+ ],
4070
+ "placeholder": "recommended"
3926
4071
  }
3927
4072
  ],
3928
4073
  "watchable": false,
@@ -4110,27 +4255,6 @@ export const OPERATIONS = [
4110
4255
  "body": "{\n \"text\": \"<text>\"\n}"
4111
4256
  }
4112
4257
  },
4113
- {
4114
- "id": "intents.agents",
4115
- "commandPath": [
4116
- "intents",
4117
- "agents"
4118
- ],
4119
- "method": "get",
4120
- "pathTemplate": "/studio/v1/agents",
4121
- "summary": "The agents (harness × model) Studio can measure with for your organization. `available: false` gives the reason, such as a plan that doesn't include it. Use these pairs in measurement-policy `agents`",
4122
- "scope": "intents:read",
4123
- "product": "studio",
4124
- "pathParams": [],
4125
- "queryParams": [],
4126
- "hasBody": false,
4127
- "bodyRequired": false,
4128
- "isStream": false,
4129
- "watchable": false,
4130
- "help": {
4131
- "command": "ora intents agents"
4132
- }
4133
- },
4134
4258
  {
4135
4259
  "id": "intents.analytics",
4136
4260
  "commandPath": [
@@ -4169,6 +4293,39 @@ export const OPERATIONS = [
4169
4293
  "command": "ora intents analytics <id>"
4170
4294
  }
4171
4295
  },
4296
+ {
4297
+ "id": "intents.answers",
4298
+ "commandPath": [
4299
+ "intents",
4300
+ "answers"
4301
+ ],
4302
+ "method": "get",
4303
+ "pathTemplate": "/studio/v1/intents/{id}/answers",
4304
+ "summary": "Every answer of one measurement and what it said about each brand: status (recommended / conditional / mentioned / ruled_out), the answer's own quote, what it credited the brand for, its drawbacks, and the brands recommended instead of you. The latest finished measurement unless you pass one from intents.history (CLI: ora intents history)",
4305
+ "scope": "intents:read",
4306
+ "product": "studio",
4307
+ "pathParams": [
4308
+ {
4309
+ "name": "id"
4310
+ }
4311
+ ],
4312
+ "queryParams": [
4313
+ {
4314
+ "name": "measurement",
4315
+ "flag": "measurement",
4316
+ "optionKey": "measurement",
4317
+ "required": false,
4318
+ "kind": "string"
4319
+ }
4320
+ ],
4321
+ "hasBody": false,
4322
+ "bodyRequired": false,
4323
+ "isStream": false,
4324
+ "watchable": false,
4325
+ "help": {
4326
+ "command": "ora intents answers <id>"
4327
+ }
4328
+ },
4172
4329
  {
4173
4330
  "id": "intents.bulkAction",
4174
4331
  "commandPath": [
@@ -4318,6 +4475,12 @@ export const OPERATIONS = [
4318
4475
  "required": false,
4319
4476
  "kind": "string",
4320
4477
  "placeholder": "<domainId>"
4478
+ },
4479
+ {
4480
+ "name": "criteria",
4481
+ "required": false,
4482
+ "kind": "array",
4483
+ "placeholder": "[]"
4321
4484
  }
4322
4485
  ],
4323
4486
  "watchable": false,
@@ -4623,6 +4786,7 @@ export const OPERATIONS = [
4623
4786
  "name": "agents",
4624
4787
  "required": false,
4625
4788
  "kind": "array",
4789
+ "description": "The agents this intent runs: harness + model pairs from GET /studio/v1/agents (CLI: ora intents agents). Replaces the stored list, so send every agent to keep. An empty list follows the org's default agents.",
4626
4790
  "placeholder": "[]"
4627
4791
  },
4628
4792
  {
@@ -5027,6 +5191,7 @@ export const OPERATIONS = [
5027
5191
  "name": "agents",
5028
5192
  "required": true,
5029
5193
  "kind": "array",
5194
+ "description": "The agents to run: harness + model pairs from GET /studio/v1/agents (CLI: ora intents agents).",
5030
5195
  "placeholder": "[]"
5031
5196
  },
5032
5197
  {