@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 +6 -0
- package/dist/generated/operations.d.ts +2 -1
- package/dist/generated/operations.d.ts.map +1 -1
- package/dist/generated/operations.js +65 -23
- package/dist/generated/operations.js.map +1 -1
- package/dist/generated/types.d.ts +57 -8
- package/dist/generated/types.d.ts.map +1 -1
- package/dist/generated/types.js +1 -1
- package/dist/index.js +15 -1
- package/dist/index.js.map +1 -1
- package/dist/program.js +6 -2
- package/dist/program.js.map +1 -1
- package/dist/update-notice/adapters.d.ts +14 -0
- package/dist/update-notice/adapters.d.ts.map +1 -0
- package/dist/update-notice/adapters.js +51 -0
- package/dist/update-notice/adapters.js.map +1 -0
- package/dist/update-notice/update-notice.d.ts +21 -0
- package/dist/update-notice/update-notice.d.ts.map +1 -0
- package/dist/update-notice/update-notice.js +18 -0
- package/dist/update-notice/update-notice.js.map +1 -0
- package/package.json +1 -1
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: "
|
|
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,
|
|
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
|
|
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": "
|
|
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
|
{
|