@re-cinq/floor-station 0.1.9 → 0.1.10

package/README.md

@@ -35,7 +35,7 @@ why the picture in [the map](https://github.com/re-cinq/floor/blob/main/README.m
 | | |
 |---|---|
 | claims | the dispatches tagged `station:<name>`, and only those |
-| the brief | each need by name: a value as its text, a file as an address, a repo as `url@ref` |
+| the brief | `visitId`, `runId`, `lineId`, `nodeId`, `iteration`, and each need by name: a value as its text, a file as an address, a repo as `url@ref`. Key what must survive a retried visit on `runId`, and add `nodeId` when the state belongs to one node of the line rather than the whole run |
 | `tools.read(need)` | the bytes of a file need |
 | `tools.produce(name, bytes)` | stores a file with the floor and names it in the report |
 | `tools.modelCall(call)` | records a model call, so the floor's costs count it |

package/dist/types.d.ts

@@ -1,5 +1,11 @@
 export interface Brief {
     visitId: string;
+    /** The assembly run this visit belongs to: what to key on, so a retried visit finds what the first one stored. */
+    runId: string;
+    /** The assembly line that run walks. */
+    lineId: string;
+    /** The node of that line this visit is a pass at. A line may visit one station at two nodes, so state kept per node is keyed on this beside `runId`. */
+    nodeId: string;
     iteration: number;
     /** Each need by name: a value as its text, a file as the address `tools.read` fetches, a repo as `url@ref`. */
     needs: Record<string, string>;

package/dist/visit.js

@@ -20,7 +20,7 @@ async function handled(handle, brief, tools) {
 }
 function briefOf(fetched) {
     const needs = fetched.needs.map((need) => [need.name, textOf(need)]);
-    return { visitId: fetched.visitId, iteration: fetched.iteration, needs: Object.fromEntries(needs) };
+    return { visitId: fetched.visitId, runId: fetched.runId, lineId: fetched.lineId, nodeId: fetched.nodeId, iteration: fetched.iteration, needs: Object.fromEntries(needs) };
 }
 function textOf(need) {
     if (need.kind === "value")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@re-cinq/floor-station",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "The floor's service station SDK: defineStation(name, handle) claims the station's dispatches from a floor's queue, hands each to one function as a brief, and posts what it returns as the visit's report. A station needs only a way out to the floor; the floor never calls it.",
   "license": "Apache-2.0",
   "repository": {
@@ -45,8 +45,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@re-cinq/floor-client": "0.1.9",
-    "@re-cinq/floor-contracts": "0.1.9"
+    "@re-cinq/floor-client": "0.1.10",
+    "@re-cinq/floor-contracts": "0.1.10"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",