@ai-ecoverse/slicc 1.54.0 → 1.55.1
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 +7 -5
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -342,7 +342,7 @@ slicc capabilities [--json]
|
|
|
342
342
|
- **`contract`:** 1. It goes up only for a breaking change to a contract this document describes: a field or event that changes meaning or goes away. New commands, fields, events and ops leave it alone.
|
|
343
343
|
- **`commands`:** every command, keyed by name: `default` for `slicc` with no command, `follow`, `prompt`, `watch`, `wait` and `abort` (also after a join URL), `attach`, `open`, `pair`, `unpair`, `tray`, `browsers`, `launch`, `update`, `install`, `capabilities`, `version` and `help`. `json` says what `--json` prints: `document` (one JSON value), `events` (NDJSON, one event a line) or `none` (no `--json`). An `events` command has `vocabulary`: `events` for lines with `schema` and `event` (see [The default](#the-default-slicc) and [`slicc launch`](#slicc-launch---browser-id---profile-name---url-url---headless---no-seven-flags---json)), or `agent` for seven's agent events with `t` (see [`agent`](#agent-page-cap-agent-node--page)).
|
|
344
344
|
- **`events`:** `schema`, the `schema` every `event` line carries, and `names`, every `event` a `vocabulary: "events"` command can print, sorted.
|
|
345
|
-
- **`agent`:** `events`, the `t` of every agent event slicc knows, and `own`, the lines slicc itself adds to that stream (`settled`, see [Remote control](#remote-control-slicc-prompt-watch-wait-and-abort)).
|
|
345
|
+
- **`agent`:** `events`, the `t` of every agent event slicc knows, and `own`, the lines slicc itself adds to that stream (`settled`, `opened` and `reconnecting`, see [Remote control](#remote-control-slicc-prompt-watch-wait-and-abort)).
|
|
346
346
|
- **`control`:** `v`, the version of the [control socket](#running-links-slicc-tray) protocol, and `ops`, the ops it answers.
|
|
347
347
|
|
|
348
348
|
A program reads `contract` and the names it needs, and treats anything it doesn't know as absent: an older `slicc` lacks the newer commands, events and ops, and a newer one may have more. `TestCapabilitiesNameEveryCommandEventAndOp` fails when a command, an event or a control op is added to the code without appearing here, and keeps the document's fixture, [`test/integration/testdata/native/capabilities.json`](test/integration/testdata/native/capabilities.json), in step with the binary. The control socket's exchange, `status`'s `ops`, the answers to `stop` and `detach` and the `closed` that follows, is in [`control.ndjson`](test/integration/testdata/native/control.ndjson).
|
|
@@ -411,7 +411,7 @@ Without `--browser`, the first row of the ranking that can host seven is chosen,
|
|
|
411
411
|
|
|
412
412
|
**What the link offers:** `net` (tcp, resolve), `http`, `ws`, `udp`, and `cdp` with the browser that hosts seven (`seven: true`) and every extra, under the local policy with all of their debugging ports protected, and this machine's other debugging ports too (see [Network policy](#network-policy)); and kernel services on `--kernel-port` (default 80, or a spare port when this user can't have 80; `--no-kernel` turns them off) when seven offers `kernel-in` (see [Kernel services](#kernel-services)); and `ssh` only with `--runner` (see [SSH server](#ssh-server)); and `fs` with each `--mount` folder (see [Host folders](#host-folders)). seven gets full control of every listed browser, the one it runs in too. The `cdp` list (HELLO `browsers`) has only the browser that hosts seven and the extras picked with `--browser` or in the picker; the other browsers discovery found are never offered.
|
|
413
413
|
|
|
414
|
-
The cdp list follows the browsers: an extra that stops answering is taken off the list (`browser-gone`), and listed again with the same id when it answers on the same endpoint again (`browser-back`). An extra that never made the list, because it has no browser session (see [What a browser must offer](#cdp-browser-control)), gets one `browser-gone` with `reason` `no-browser-session` right after the link starts. Plain mode says `seven can't drive <name> through slicc: it has no browser session, so slicc can't watch its tabs or keep seven's origin out of them. It isn't listed for cdp; the rest of the link works` for it, and the dashboard `<name> isn't listed for cdp: it has no browser session`, where an extra that stops answering gets `<name> quit; it is no longer listed for cdp` and `<name> quit`.
|
|
414
|
+
The cdp list follows the browsers: an extra that stops answering is taken off the list (`browser-gone`), and listed again with the same id when it answers on the same endpoint again (`browser-back`). An extra that never made the list, because it has no browser session (see [What a browser must offer](#cdp-browser-control)), gets one `browser-gone` with `reason` `no-browser-session` right after the link starts. slicc watches the browsers of a link only once it has said what that link offers (`offering …` in plain mode), so the dashboard's reset for a new link never clears a mark that link set. Plain mode says `seven can't drive <name> through slicc: it has no browser session, so slicc can't watch its tabs or keep seven's origin out of them. It isn't listed for cdp; the rest of the link works` for it, and the dashboard `<name> isn't listed for cdp: it has no browser session`, where an extra that stops answering gets `<name> quit; it is no longer listed for cdp` and `<name> quit`.
|
|
415
415
|
|
|
416
416
|
**Flags.**
|
|
417
417
|
- `--browser <id>`: an id from `slicc browsers` (an installed id such as `chrome`, or `cdp:<host>:<port>`), or a name, case-insensitively. Repeatable: the first hosts seven, the others are extras. Without it, the best match that can host seven. An endpoint in SLICC six's profile is refused (`<id> is SLICC six's Chrome; only --profile six uses it`).
|
|
@@ -1233,7 +1233,7 @@ HELLO from `follow`: `{ "v": 1, "role": "node", "name", "host", "version", "mode
|
|
|
1233
1233
|
|
|
1234
1234
|
```
|
|
1235
1235
|
slicc <join-url> prompt [--allsettled <quiet>] [--steer | --reject] [--thinking] [--json] [--plain] [--abort-on-interrupt] <text>|@file|-
|
|
1236
|
-
slicc <join-url> watch [--thinking] [--json] [--plain]
|
|
1236
|
+
slicc <join-url> watch [--thinking] [--json] [--plain] [--since <entry-id>]
|
|
1237
1237
|
slicc <join-url> wait [--allsettled <quiet>] [--timeout <limit>] [--json]
|
|
1238
1238
|
slicc <join-url> abort
|
|
1239
1239
|
slicc prompt --cdp <url> [--origin <origin>]... [flags] <text>|@file|-
|
|
@@ -1293,10 +1293,12 @@ These commands talk to seven's agent over a link that offers nothing to seven (`
|
|
|
1293
1293
|
- `130` on Ctrl-C or `SIGTERM`.
|
|
1294
1294
|
|
|
1295
1295
|
**`watch`** follows the agent until Ctrl-C or `SIGTERM`, then exits 0.
|
|
1296
|
-
- **Output:** `user` events go to stdout as `> <text>`, on one line. Assistant text goes to stdout as for `prompt`, and a line ends at each run's end. Everything else goes to stderr, as for `prompt`, plus `run ended: <reason>` for a run that didn't end with `stop`. `--json` prints the events instead.
|
|
1296
|
+
- **Output:** `user` events go to stdout as `> <text>`, on one line. Assistant text goes to stdout as for `prompt`, and a line ends at each run's end. Everything else goes to stderr, as for `prompt`, plus `run ended: <reason>` for a run that didn't end with `stop`. `--json` prints the events instead, with slicc's own lines among them (below).
|
|
1297
1297
|
- **Status lines** on stderr: `slicc: watching <name>`, `slicc: lost the link to <name>; reconnecting`, and for the tray `<reason>; trying again in <wait>`.
|
|
1298
1298
|
- **Reconnects:** when the stream ends or is reset, slicc opens a new `watch` on the same link. When the link goes, it sets up a new one, through the tray again or by waiting for seven over CDP. Waits start at 1 s, double up to 30 s with ±25 % jitter, and go back to 1 s once a stream opens.
|
|
1299
1299
|
- **Resuming:** each new stream asks for `since`, the id of the last event slicc saw, so nothing still in the transcript is lost. Nothing is shown twice either. For `text` and `thinking`, slicc counts the bytes it has shown per entry and skips that many from the entry's replay. Any other entry is skipped when its id was already seen. `run` events have no id and aren't replayed. When seven answers `gap: true`, slicc prints `some events were missed`.
|
|
1300
|
+
- **`--since <entry-id>`:** the first stream asks for `since` with this id (any event's `id`), as [`agent`](#agent-page-cap-agent-node--page)'s `watch` does, so a program that kept the last id it saw resumes there across restarts of `slicc watch`. seven replays that entry when it's `text` or `thinking`, then every entry after it, or answers `gap: true` when it no longer has it. Later streams resume from the last event slicc saw, as above.
|
|
1301
|
+
- **slicc's own lines with `--json`**, which are slicc's and not seven's, like `prompt`'s and `wait`'s `{"t":"settled"}`: `{"t":"opened","head","gap"?,"busy"?}` first on every stream that opens, before seven's events on it, with `head`, `gap` and `busy` from seven's OPENED (so a `gap` shows on stdout, not only on stderr); and `{"t":"reconnecting","attempt","wait"}` before each new try, with `attempt` counting the tries since a stream last opened and `wait` in milliseconds. A reader that ignores unknown `t` values sees seven's events as before. `run` events still have no id. Fixture: [`watch.ndjson`](test/integration/testdata/native/watch.ndjson).
|
|
1300
1302
|
- **Exit status:** `1` when the link can't be set up for good (a terminal tray failure, or the CDP connection closing), `2` for bad usage, `3` without permission.
|
|
1301
1303
|
|
|
1302
1304
|
**`abort`** aborts the agent's current run. It prints `slicc: aborted the run`, or `slicc: nothing was running`, and exits 0. Otherwise it exits 1 on errors, 3 without permission and 130 on Ctrl-C.
|
|
@@ -1411,7 +1413,7 @@ PID MODE SEVEN DEVICE STATE OFFERS
|
|
|
1411
1413
|
|
|
1412
1414
|
```
|
|
1413
1415
|
slicc <join-url> prompt [--allsettled <quiet>] [--steer | --reject] [--thinking] [--json] [--plain] <text>|@file|-
|
|
1414
|
-
slicc <join-url> watch [--thinking] [--json] [--plain]
|
|
1416
|
+
slicc <join-url> watch [--thinking] [--json] [--plain] [--since <entry-id>]
|
|
1415
1417
|
slicc <join-url> wait [--allsettled <quiet>] [--timeout <limit>] [--json]
|
|
1416
1418
|
slicc <join-url> abort
|
|
1417
1419
|
slicc tray [--json]
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ai-ecoverse/slicc",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.55.1",
|
|
4
4
|
"description": "SLICC's command line for seven: links a machine's network, compute and browsers to seven over WebRTC",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
@@ -18,12 +18,12 @@
|
|
|
18
18
|
"node": ">=18"
|
|
19
19
|
},
|
|
20
20
|
"optionalDependencies": {
|
|
21
|
-
"@ai-ecoverse/slicc-darwin-arm64": "1.
|
|
22
|
-
"@ai-ecoverse/slicc-darwin-amd64": "1.
|
|
23
|
-
"@ai-ecoverse/slicc-linux-arm64": "1.
|
|
24
|
-
"@ai-ecoverse/slicc-linux-amd64": "1.
|
|
25
|
-
"@ai-ecoverse/slicc-windows-arm64": "1.
|
|
26
|
-
"@ai-ecoverse/slicc-windows-amd64": "1.
|
|
21
|
+
"@ai-ecoverse/slicc-darwin-arm64": "1.55.1",
|
|
22
|
+
"@ai-ecoverse/slicc-darwin-amd64": "1.55.1",
|
|
23
|
+
"@ai-ecoverse/slicc-linux-arm64": "1.55.1",
|
|
24
|
+
"@ai-ecoverse/slicc-linux-amd64": "1.55.1",
|
|
25
|
+
"@ai-ecoverse/slicc-windows-arm64": "1.55.1",
|
|
26
|
+
"@ai-ecoverse/slicc-windows-amd64": "1.55.1",
|
|
27
27
|
"@ai-ecoverse/slicc-jerk": "^1.3.9"
|
|
28
28
|
}
|
|
29
29
|
}
|