@re-cinq/floor-contracts 0.1.9 → 0.1.11

package/dist/definitions.d.ts

@@ -39,6 +39,11 @@ export interface LineNode {
     start?: string;
     bind?: Record<string, string>;
     reports?: LineNodeReport[];
+    /** This node reports a list in its produced value `over` (a JSON array of strings); node `to` then runs once per item, with the item as its `item` need, and the walk goes on past `to` when every one has reported. */
+    fanout?: {
+        over: string;
+        to: string;
+    };
 }
 export interface LineEdge {
     from: string;
@@ -49,6 +54,8 @@ export interface LineEdge {
 export interface LineBody {
     entry: string;
     exit: string;
+    /** Node that ends the run as failed on purpose; absent means no node can. */
+    fail?: string;
     start?: LineStart;
     args: Record<string, LineArgSpec>;
     /** Name -> blob hash, seeded into every run's bag at start. */
@@ -65,6 +72,8 @@ export interface NeedSpec {
     /** `git` needs only; `read` is the default. */
     access?: "read" | "write";
     optional?: boolean;
+    /** `value` needs only: the name of an item the body of a fan-out produces. The need is filled with a JSON array of what each branch of the latest fan-out produced under it, in branch order. */
+    collect?: string;
 }
 export interface ProduceSpec {
     name: string;

package/dist/views.d.ts

@@ -3,7 +3,7 @@ export interface RunFields<Time> {
     id: string;
     lineId: string;
     lineHash: string;
-    repo: string;
+    repo: string | null;
     subjectKey: string | null;
     startItems: Record<string, Item>;
     outcome: string | null;
@@ -22,6 +22,8 @@ export interface VisitFields<Time> {
     report: Report | null;
     worker: string | null;
     requestedBy: string | null;
+    /** Which item of a fan-out this visit is the body for; null on an ordinary visit. */
+    branch: number | null;
     deadline: Time | null;
     /** The previous visit's sessionRef, for an executor restoring a conversation. Beyond the public Brief a station author sees: this is the executor's own lookup, resolved once so it is not repeated. */
     resumedFrom: string | null;

package/dist/wire.d.ts

@@ -71,6 +71,12 @@ export type BriefSettings = ExecutorSettings & {
 /** `GET /station-runs/:id/brief`: everything an executor needs to run one visit, and a token that reaches only this visit. */
 export interface VisitBrief {
     visitId: string;
+    /** The assembly run this visit belongs to. */
+    runId: string;
+    /** The assembly line that run walks. */
+    lineId: string;
+    /** The node of that line this visit is a pass at: with `runId`, what a station keys per-node state on. */
+    nodeId: string;
     iteration: number;
     floorBaseUrl: string;
     token: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@re-cinq/floor-contracts",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "The floor's wire, as types: what its HTTP routes and its live socket take and answer, and nothing else. No runtime, no dependencies.",
   "license": "Apache-2.0",
   "repository": {