@ora-ai/cli 0.7.4 → 0.9.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 +48 -6
- package/dist/generated/operations.d.ts +1 -1
- package/dist/generated/operations.d.ts.map +1 -1
- package/dist/generated/operations.js +3260 -320
- package/dist/generated/operations.js.map +1 -1
- package/dist/generated/types.d.ts +3872 -60
- package/dist/generated/types.d.ts.map +1 -1
- package/dist/generated/types.js +1 -1
- package/package.json +2 -2
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
|
-
- **
|
|
100
|
-
|
|
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: "
|
|
43
|
+
readonly contentHash: "1d3b25b4c612e53f1e666e93e37bfdd3effc5de3f02ff7967c69cd2341c735c1";
|
|
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,
|
|
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,EA8gMrC,CAAC"}
|