@openscout/scout 0.2.65 → 0.2.68

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
@@ -33,7 +33,7 @@ It also discovers local and project-backed agents from your configured workspace
33
33
 
34
34
  `scout init` writes `~/.openscout/config.json` with the broker, web, and pairing ports that every Scout component reads. Run it once after install, or with `--force` to overwrite.
35
35
 
36
- When the input is not a known subcommand and includes exactly one `@agent` mention, Scout treats it as an implicit `ask` and waits for the reply. For example:
36
+ When the input is not a known subcommand and includes exactly one `@agent` mention, Scout treats it as an implicit `ask`: it records durable work with the broker, waits for the target to acknowledge or complete immediately, and leaves later completion visible through the conversation or flight follow-up. For example:
37
37
 
38
38
  ```bash
39
39
  scout @dewey can you review our docs?
@@ -56,10 +56,22 @@ When sender, target, or recent activity is unclear, the shortest orientation loo
56
56
 
57
57
  ```bash
58
58
  scout whoami
59
+ scout inbox --latest 10 --json
59
60
  scout who
61
+ scout channel triage --latest 10 --json
60
62
  scout latest
63
+ scout latest --channel triage --messages --limit 3
61
64
  ```
62
65
 
66
+ Use `channel <name> --latest <count> --json` for the cheapest agent-facing
67
+ channel catch-up. It reads broker messages for that channel and exits. Use
68
+ `latest --channel <name>` when you want the compact activity projection instead.
69
+ Use `inbox --latest <count> --json` for direct messages addressed to the
70
+ current inferred agent identity.
71
+
72
+ CLI agents should use these commands rather than curling broker HTTP endpoints
73
+ or reading relay files directly.
74
+
63
75
  ### Sender identity
64
76
 
65
77
  `scout send`, `scout ask`, and `scout broadcast` all use the
@@ -149,6 +161,23 @@ scout ask --as premotion.master.mini --to hudson "Build the editable CodeViewer
149
161
  Use `channel.shared` only when the work is genuinely for a group, not for a
150
162
  single owner.
151
163
 
164
+ ### Label-scoped catch-up
165
+
166
+ Use labels to tie related asks together without creating a new workflow object:
167
+
168
+ ```bash
169
+ scout ask --to hudson --label release:0.2.66 "Review the package bump."
170
+ scout ask --to lattices --label release:0.2.66 "Check the install path."
171
+ scout label feed release:0.2.66 --since 10m
172
+ scout label watch release:0.2.66 --interval 2
173
+ scout label brief release:0.2.66
174
+ ```
175
+
176
+ Labels are plain metadata. They can mean a goal, release, milestone, incident,
177
+ or any local convention. `scout label watch` streams a normalized firehose of
178
+ matching Scout-owned activity; `scout label brief` gives a compact digest. Scout
179
+ does not assign a lifecycle to the label.
180
+
152
181
  ### Addressing specific agents
153
182
 
154
183
  Agent identity has six dimensions: `definitionId`, workspace qualifier, `profile`, `harness`, `model`, `node`. Canonical form:
@@ -254,7 +283,7 @@ scout server open
254
283
  scout server start
255
284
  scout server start --port 3200
256
285
  scout server open --path /agents/arc-codex-2.master.mini
257
- scout server start --public-origin https://scout.local
286
+ scout server start --public-origin http://scout.local
258
287
  scout server edge --local-name m1
259
288
  scout server start --vite-url http://127.0.0.1:43173 # SPA dev server
260
289
  scout server start --static --static-root /custom/client
@@ -262,7 +291,7 @@ scout server start --static --static-root /custom/client
262
291
 
263
292
  `scout server open` reuses an already-running matching Scout server on that port, or starts one in the background and opens the browser for you. Use `scout server` or `scout server help` for full flags.
264
293
 
265
- The application server binds to `0.0.0.0` by default, treats `scout.local` as the local portal name, and derives the node URL as `<machine>.scout.local` unless the user configures a short alias such as `m1`. `scout server edge` publishes `scout.local` plus the node host with Bonjour/mDNS and runs Caddy against the active web port. The managed edge serves HTTP on port `80` for zero-cert local browsing and HTTPS on port `443` with Caddy's local CA; the HTTPS path needs the local CA trusted once by browsers that enforce their own trust store.
294
+ The application server binds to `0.0.0.0` by default, treats `scout.local` as the local portal name, and derives the node URL as `<machine>.scout.local` unless the user configures a short alias such as `m1`. `scout server edge` publishes `scout.local` plus the node host with Bonjour/mDNS and runs Caddy against the active web port. The managed edge defaults to HTTP on port `80` for zero-cert local browsing. HTTPS remains an explicit opt-in via `--edge-scheme https` or `--edge-scheme both` plus `scout server trust`.
266
295
 
267
296
  `scout setup` verifies Caddy for this path. The setup command installs it with Homebrew on macOS when `caddy` is not already available, but Scout still runs Caddy directly with the generated `~/.scout/local-edge/Caddyfile` instead of registering a separate Homebrew service. The base LaunchAgent is labelled `dev.openscout` in source/dev installs and supervises the broker, local edge, web startup, and menu bar app; `scout doctor` prints the exact `launchctl bootout ...` command for the current mode.
268
297
 
@@ -0,0 +1 @@
1
+ const o={};throw new Error('Could not resolve "@xterm/addon-fit" imported by "hudsonkit".');export{o as default};
@@ -0,0 +1 @@
1
+ const o={};throw new Error('Could not resolve "@xterm/addon-webgl" imported by "hudsonkit".');export{o as default};