@ora-ai/cli 0.15.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: "45a15097f294c3d57602c6fd2b1c8b03adcd15bd3c0b16904766dbbd87f71698";
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,EAq8RrC,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 45a15097f294c3d57602c6fd2b1c8b03adcd15bd3c0b16904766dbbd87f71698)
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": "45a15097f294c3d57602c6fd2b1c8b03adcd15bd3c0b16904766dbbd87f71698",
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": [
@@ -3772,6 +3798,7 @@ export const OPERATIONS = [
3772
3798
  "kind": "string",
3773
3799
  "enum": [
3774
3800
  "recommended",
3801
+ "answered",
3775
3802
  "accurate",
3776
3803
  "informed",
3777
3804
  "capability",
@@ -4031,6 +4058,7 @@ export const OPERATIONS = [
4031
4058
  "kind": "string",
4032
4059
  "enum": [
4033
4060
  "recommended",
4061
+ "answered",
4034
4062
  "accurate",
4035
4063
  "informed",
4036
4064
  "capability",
@@ -4227,27 +4255,6 @@ export const OPERATIONS = [
4227
4255
  "body": "{\n \"text\": \"<text>\"\n}"
4228
4256
  }
4229
4257
  },
4230
- {
4231
- "id": "intents.agents",
4232
- "commandPath": [
4233
- "intents",
4234
- "agents"
4235
- ],
4236
- "method": "get",
4237
- "pathTemplate": "/studio/v1/agents",
4238
- "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`",
4239
- "scope": "intents:read",
4240
- "product": "studio",
4241
- "pathParams": [],
4242
- "queryParams": [],
4243
- "hasBody": false,
4244
- "bodyRequired": false,
4245
- "isStream": false,
4246
- "watchable": false,
4247
- "help": {
4248
- "command": "ora intents agents"
4249
- }
4250
- },
4251
4258
  {
4252
4259
  "id": "intents.analytics",
4253
4260
  "commandPath": [
@@ -4286,6 +4293,39 @@ export const OPERATIONS = [
4286
4293
  "command": "ora intents analytics <id>"
4287
4294
  }
4288
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
+ },
4289
4329
  {
4290
4330
  "id": "intents.bulkAction",
4291
4331
  "commandPath": [
@@ -4746,6 +4786,7 @@ export const OPERATIONS = [
4746
4786
  "name": "agents",
4747
4787
  "required": false,
4748
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.",
4749
4790
  "placeholder": "[]"
4750
4791
  },
4751
4792
  {
@@ -5150,6 +5191,7 @@ export const OPERATIONS = [
5150
5191
  "name": "agents",
5151
5192
  "required": true,
5152
5193
  "kind": "array",
5194
+ "description": "The agents to run: harness + model pairs from GET /studio/v1/agents (CLI: ora intents agents).",
5153
5195
  "placeholder": "[]"
5154
5196
  },
5155
5197
  {