@ora-ai/cli 0.7.4 → 0.8.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
@@ -96,12 +96,8 @@ whose CLI isn't currently connected answers 502 `TUNNEL_NOT_CONNECTED`.
96
96
  - **Journey**: create the tunnel `--access public`, then use the hostname as
97
97
  the journey's `targetDomain` — e.g. `924649e0-….t.agentfront.sh`. The
98
98
  agent browses it like any site.
99
- - **Audit** (the agent-readiness audit at ora.ai): create the tunnel
100
- `--access public` and let `ax` run it end to end —
101
- `ax audit localhost:<port> --tunnel-cmd 'ora tunnel <port> --access public'`
102
- (npm `ax`; `ax audit localhost:<port> --tunnel ora` does the same with just
103
- `ORA_API_KEY`). `tunnel://<id>/` targets are for ora's in-cluster scanners
104
- only, not a public API.
99
+ - **Scan**: `{ "url": "tunnel://<tunnelId>/", "url_kind": "tunnel" }` — works
100
+ for any access mode, including `private`.
105
101
 
106
102
  ### Manage tunnels
107
103
 
@@ -160,6 +156,52 @@ After a run completes, read its artifacts:
160
156
  ora sessions hibernate <id>
161
157
  ora sessions wake <id>
162
158
 
159
+ ### Image builds — build and run custom harness images
160
+
161
+ ora experiment images builds create --help # every source kind + an example body
162
+
163
+ Build a custom harness image from a context you already host somewhere
164
+ (`archive`) or a git repo (`git`) — both work end to end from the CLI alone,
165
+ api-key auth included:
166
+
167
+ cat > build.json <<'EOF'
168
+ { "name": "my-harness", "source": { "kind": "archive", "url": "https://example.com/ctx.tar.gz", "sha256": "…" } }
169
+ EOF
170
+ ora experiment images builds create --file build.json # -> {id, phase}
171
+ ora experiment images builds get <id> # phase, image, digest once succeeded
172
+ ora experiment images builds stream <id> # SSE — follow it live instead of polling
173
+ ora experiment images builds list --phase succeeded
174
+ ora experiment images builds cancel <id> # in-flight builds only
175
+
176
+ cat > build-git.json <<'EOF'
177
+ { "name": "my-harness", "source": { "kind": "git", "url": "https://github.com/you/repo", "ref": "main" } }
178
+ EOF
179
+ ora experiment images builds create --file build-git.json
180
+
181
+ Then launch a run from a build that reached `succeeded`:
182
+
183
+ cat > run.json <<'EOF'
184
+ { "buildId": "<id>", "mode": "harness", "task": "say hello" }
185
+ EOF
186
+ ora experiment images runs create --file run.json # -> {runId} — follow it like any other run
187
+
188
+ **`upload`/`inline` sources are NOT reachable from this CLI.** Both need a
189
+ files-service `fileId` (`upload` directly; `inline` materializes one for
190
+ you), and files-service is closed to api-key callers ENTIRELY — every one of
191
+ its routes 403s `NOT_PUBLIC_API` for an `api_key`-typed token, `inline`
192
+ additionally requires an attributable human (`created_by` is a real
193
+ `users.id`, which an api-key principal's synthetic grant id can't satisfy).
194
+ Only a real user SESSION bearer (`POST /api/auth/login`, not `ora login`'s
195
+ api key) can call `POST /files/upload/direct` to mint a `fileId` first — a
196
+ script driving both steps needs that separate login, this CLI's own
197
+ `ora login` cannot supply it. `archive`/`git` have no such requirement:
198
+ that's why they're the two kinds shown above.
199
+
200
+ **Scopes**: these commands need an api key minted with `images:read`
201
+ (get/list/stream) and/or `images:write` (create/cancel/runs create) — see
202
+ "Errors that explain themselves" below if a command answers 403
203
+ `INSUFFICIENT_SCOPE`.
204
+
163
205
  ### Scripting
164
206
 
165
207
  `--json` prints the raw API response; with `--watch` it becomes NDJSON (the
@@ -40,7 +40,7 @@ export interface OperationMeta {
40
40
  }
41
41
  export declare const SPEC: {
42
42
  readonly version: "1.0.0";
43
- readonly contentHash: "98e8dcd240af6566a738e2b6e7bc70893cbb066c99304fc112f1b8ce7f83d90e";
43
+ readonly contentHash: "067a219e40d4ab8e05bcd2f6fb9b38e772c34e946852e4ad1ee19264faba71b1";
44
44
  readonly server: "https://api.agentfront.sh";
45
45
  readonly bin: "ora";
46
46
  };
@@ -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,EAkpGrC,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,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,EAggMrC,CAAC"}