@genroc/eval-node 0.0.0-edge.c42aeea → 0.0.0-edge.cebd211

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 (2) hide show
  1. package/README.md +17 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -90,6 +90,23 @@ queue worker rather than the HTTP sidecar it used to be:
90
90
  that genroc had to be able to reach. A worker only needs outbound access, so it can live
91
91
  anywhere — behind NAT, in another trust zone.
92
92
 
93
+ The cost of that inversion is that genroc cannot reach a running worker, so anything it needs
94
+ to say has to ride the renewal the worker already makes. **Renewing is therefore mandatory,
95
+ not an optimisation** — a worker that stops renewing is indistinguishable from one that died.
96
+ The response answers per token:
97
+
98
+ | list | what it means | what this worker does |
99
+ |---|---|---|
100
+ | `renewed` | still yours | carry on |
101
+ | `lost` | already someone else's | stop; do **not** release — that would bump the new holder's claim |
102
+ | `cancelled` | still yours, nobody wants it | abort the script and release the claim |
103
+
104
+ `cancelled` is how an operator's `genctl cancel` reaches work already running: the evaluation
105
+ is aborted through an `AbortSignal`, its realm is terminated, and no outcome is submitted —
106
+ the process is stopping, so there is nothing left to answer. `renew_before_ms` on the claim
107
+ says how long the worker may wait before renewing again, so the interval is a value it reads
108
+ rather than one it guesses.
109
+
93
110
  ## The task input
94
111
 
95
112
  The `input` of the external task IS the evaluation request:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@genroc/eval-node",
3
- "version": "0.0.0-edge.c42aeea",
3
+ "version": "0.0.0-edge.cebd211",
4
4
  "type": "module",
5
5
  "engines": {
6
6
  "node": ">=24"