primcli 1.26.0 → 1.27.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.
Files changed (3) hide show
  1. package/README.md +17 -0
  2. package/dist/oclif/index.js +1500 -371
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -300,3 +300,20 @@ The CLI previously shipped inside `@primitivedotdev/sdk`. The shipped surface ar
300
300
  ## License
301
301
 
302
302
  MIT
303
+
304
+ ### Local event listening
305
+
306
+ ```sh
307
+ primitive listen --forward-to localhost:3000
308
+ primitive listen --forward-to 3000 --events email.received
309
+ primitive listen --once --timeout 60
310
+ primitive listen --subscription my-agent --exec "python3 accept.py"
311
+ ```
312
+
313
+ WebSocket is the default transport. Subscription registration and reconnects are
314
+ automatic; the saved default resumes the same durable queue. `--once` waits for
315
+ one successful, confirmed delivery. `--timeout` is in seconds and exits 2 on
316
+ timeout; Ctrl-C exits 130. Bare `primitive listen` prints one raw JSON event per
317
+ line. Use `--transport poll` explicitly for HTTP polling. Accept or enqueue each
318
+ event within 30 seconds. Closing preserves pending work, and retries can deliver
319
+ an event more than once.