@ora-ai/cli 0.7.3 → 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
@@ -156,6 +156,52 @@ After a run completes, read its artifacts:
156
156
  ora sessions hibernate <id>
157
157
  ora sessions wake <id>
158
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
+
159
205
  ### Scripting
160
206
 
161
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"}