@requence/task 0.7.1 → 0.8.2-edge.1149

package/build/types/helpers/src/protocol/NodeTree.d.ts

@@ -13,7 +13,7 @@ type CriticalGroup = {
     nodeId: string;
     name: OutputName;
 }[];
-type DataSet = {
+export type DataSet = {
     data: unknown;
     overwrite: boolean;
     time: number;
@@ -27,6 +27,20 @@ export declare class NodeTree {
     private edges;
     private data;
     private overriddenNodeData;
+    /**
+     * Payload ids whose own storage field is durable (issue #118). `this.data` is
+     * write-once — a fresh UUID per write, an explicit delete to drop one — so the
+     * difference against it is exactly what a write has to carry, and a
+     * steady-state write carries none of it.
+     */
+    private persistedDataIds;
+    /**
+     * Payloads whose field is still in storage although no edge references them
+     * any more. Their delete is issued only AFTER the snapshot that dropped them
+     * is durable, so they stay in the delta until it actually lands — an
+     * interrupted delete leaks a field, it never strands a reference.
+     */
+    private orphanedDataIds;
     readonly cycles: {
         node: Node;
         name: OutputName;
@@ -34,68 +48,130 @@ export declare class NodeTree {
     readonly entryNode: Extract<Node, {
         type: 'entry';
     }>;
-    constructor({ nodes, edges }: NodeTreeOptions, _data?: Map<string, DataSet>, _cycles?: Cycle[] | null, _overriddenNodeData?: Map<string, Record<string, unknown>>);
+    constructor({ nodes, edges }: NodeTreeOptions, _cycles?: Cycle[] | null, _overriddenNodeData?: Map<string, Record<string, unknown>>);
+    /**
+     * The GRAPH, never the data that flowed through it (issue #118). `this.data`
+     * is deliberately absent: it is persisted per field, so a write is a function
+     * of graph size — bounded by the template — instead of a function of
+     * everything the task has ever emitted.
+     *
+     * `nodes` and `edges` mutate as the graph runs and `overriddenNodeData` is
+     * mutated by `overrideAggregatedNodeData`, so all three have to stay here.
+     */
     pack(): readonly [({
         id: string;
         type: "entry";
-        inputSchema: import("json-schema").JSONSchema7;
         alias?: string | undefined;
+        inputSchema: import("json-schema").JSONSchema7;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "service";
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        alias?: string | undefined;
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
         name: string;
         version: string;
+        configuration?: any;
         configurationSchema: import("json-schema").JSONSchema7;
-        mode: "LINEAR" | "CONTINUOUS";
+        ttl?: number | undefined;
+        retry: number;
+        retryDelay?: number | undefined;
+        mode: "CONTINUOUS" | "LINEAR";
+        privileged: boolean;
+        wireCodec?: "json" | "msgpack" | undefined;
+        configurationServices?: {
+            outputs: {
+                name: string | null;
+                schema: import("json-schema").JSONSchema7 | null;
+            }[];
+            id: string;
+            type: "service";
+            alias?: string | undefined;
+            inputSchema: {
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7) | ({
+                oneOf: ({
+                    type: "null";
+                } | ({
+                    type: "object";
+                } & import("json-schema").JSONSchema7) | ({
+                    $ref: string;
+                } & import("json-schema").JSONSchema7))[];
+            } & import("json-schema").JSONSchema7);
+            name: string;
+            version: string;
+            configuration?: any;
+            configurationSchema: import("json-schema").JSONSchema7;
+            ttl?: number | undefined;
+            retry: number;
+            retryDelay?: number | undefined;
+            mode: "CONTINUOUS" | "LINEAR";
+            privileged: boolean;
+            wireCodec?: "json" | "msgpack" | undefined;
+            configurationServices?: /*elided*/ any[] | undefined;
+        }[] | undefined;
+    } | {
         outputs: {
             name: string | null;
             schema: import("json-schema").JSONSchema7 | null;
         }[];
-        alias?: string | undefined;
-        configuration?: any;
-        ttl?: number | undefined;
-        retry?: number | undefined;
-        retryDelay?: number | undefined;
-    } | {
         id: string;
         type: "logic";
+        alias?: string | undefined;
         script: string;
         concurrency: boolean;
         language: "javascript" | "python" | "typescript";
         maxExecutionTime: number;
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "or";
         alias?: string | undefined;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "reference";
+        alias?: string | undefined;
         reference: string;
         enabled: boolean;
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "exit";
@@ -106,74 +182,157 @@ export declare class NodeTree {
         type: "comment";
         text: string;
         alias?: string | undefined;
-    })[], ExtendedEdge[], Map<string, DataSet>, {
+    })[], ExtendedEdge[], {
         node: Node;
         name: OutputName;
     }[][], Map<string, Record<string, unknown>>];
-    static unpack([nodes, edges, _data, _cycles, _overriddenNodeData]: ReturnType<typeof NodeTree.prototype.pack>): NodeTree;
+    static unpack([nodes, edges, _cycles, _overriddenNodeData]: ReturnType<typeof NodeTree.prototype.pack>): NodeTree;
+    /**
+     * Attaches the write-once payloads read back from their own storage fields
+     * (issue #118). They are durable by definition — a restore is reading them —
+     * so the delta bookkeeping starts from exactly this set.
+     */
+    restoreData(data: Map<string, DataSet>): void;
+    /**
+     * What storage is missing: the payloads written since the last confirmed
+     * write, and the durable ones no edge references any more.
+     *
+     * Call `gc()` first — an entry it would drop is otherwise still in
+     * `this.data` and therefore reported as a payload to write.
+     */
+    dataDelta(): {
+        writes: [string, DataSet][];
+        obsolete: string[];
+    };
+    /**
+     * The write that carried `writtenIds` and dropped `obsoleteIds` is durable:
+     * the first group becomes storage's current content, the second becomes
+     * orphans awaiting their delete.
+     *
+     * Takes both groups explicitly rather than re-deriving them from `this.data`:
+     * the machine may have produced further payloads while the write was in
+     * flight, and marking one of those durable would drop it from every later
+     * delta — it would never be written at all.
+     */
+    confirmDataWrite(writtenIds: Iterable<string>, obsoleteIds: Iterable<string>): void;
+    /** The delete of these fields landed — storage holds nothing for them. */
+    confirmDataDelete(deletedIds: Iterable<string>): void;
     static get ERROR(): string;
     getCriticalGroups(nodeId: string, allowMultipleOutputs?: boolean): CriticalGroup[];
     getNodes(condition?: (node: Node) => boolean): ({
         id: string;
         type: "entry";
-        inputSchema: import("json-schema").JSONSchema7;
         alias?: string | undefined;
+        inputSchema: import("json-schema").JSONSchema7;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "service";
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        alias?: string | undefined;
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
         name: string;
         version: string;
+        configuration?: any;
         configurationSchema: import("json-schema").JSONSchema7;
-        mode: "LINEAR" | "CONTINUOUS";
+        ttl?: number | undefined;
+        retry: number;
+        retryDelay?: number | undefined;
+        mode: "CONTINUOUS" | "LINEAR";
+        privileged: boolean;
+        wireCodec?: "json" | "msgpack" | undefined;
+        configurationServices?: {
+            outputs: {
+                name: string | null;
+                schema: import("json-schema").JSONSchema7 | null;
+            }[];
+            id: string;
+            type: "service";
+            alias?: string | undefined;
+            inputSchema: {
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7) | ({
+                oneOf: ({
+                    type: "null";
+                } | ({
+                    type: "object";
+                } & import("json-schema").JSONSchema7) | ({
+                    $ref: string;
+                } & import("json-schema").JSONSchema7))[];
+            } & import("json-schema").JSONSchema7);
+            name: string;
+            version: string;
+            configuration?: any;
+            configurationSchema: import("json-schema").JSONSchema7;
+            ttl?: number | undefined;
+            retry: number;
+            retryDelay?: number | undefined;
+            mode: "CONTINUOUS" | "LINEAR";
+            privileged: boolean;
+            wireCodec?: "json" | "msgpack" | undefined;
+            configurationServices?: /*elided*/ any[] | undefined;
+        }[] | undefined;
+    } | {
         outputs: {
             name: string | null;
             schema: import("json-schema").JSONSchema7 | null;
         }[];
-        alias?: string | undefined;
-        configuration?: any;
-        ttl?: number | undefined;
-        retry?: number | undefined;
-        retryDelay?: number | undefined;
-    } | {
         id: string;
         type: "logic";
+        alias?: string | undefined;
         script: string;
         concurrency: boolean;
         language: "javascript" | "python" | "typescript";
         maxExecutionTime: number;
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "or";
         alias?: string | undefined;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "reference";
+        alias?: string | undefined;
         reference: string;
         enabled: boolean;
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "exit";
@@ -189,64 +348,117 @@ export declare class NodeTree {
     getChildren(nodeId: string, outputName: OutputName): ({
         id: string;
         type: "entry";
-        inputSchema: import("json-schema").JSONSchema7;
         alias?: string | undefined;
+        inputSchema: import("json-schema").JSONSchema7;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "service";
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        alias?: string | undefined;
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
         name: string;
         version: string;
+        configuration?: any;
         configurationSchema: import("json-schema").JSONSchema7;
-        mode: "LINEAR" | "CONTINUOUS";
+        ttl?: number | undefined;
+        retry: number;
+        retryDelay?: number | undefined;
+        mode: "CONTINUOUS" | "LINEAR";
+        privileged: boolean;
+        wireCodec?: "json" | "msgpack" | undefined;
+        configurationServices?: {
+            outputs: {
+                name: string | null;
+                schema: import("json-schema").JSONSchema7 | null;
+            }[];
+            id: string;
+            type: "service";
+            alias?: string | undefined;
+            inputSchema: {
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7) | ({
+                oneOf: ({
+                    type: "null";
+                } | ({
+                    type: "object";
+                } & import("json-schema").JSONSchema7) | ({
+                    $ref: string;
+                } & import("json-schema").JSONSchema7))[];
+            } & import("json-schema").JSONSchema7);
+            name: string;
+            version: string;
+            configuration?: any;
+            configurationSchema: import("json-schema").JSONSchema7;
+            ttl?: number | undefined;
+            retry: number;
+            retryDelay?: number | undefined;
+            mode: "CONTINUOUS" | "LINEAR";
+            privileged: boolean;
+            wireCodec?: "json" | "msgpack" | undefined;
+            configurationServices?: /*elided*/ any[] | undefined;
+        }[] | undefined;
+    } | {
         outputs: {
             name: string | null;
             schema: import("json-schema").JSONSchema7 | null;
         }[];
-        alias?: string | undefined;
-        configuration?: any;
-        ttl?: number | undefined;
-        retry?: number | undefined;
-        retryDelay?: number | undefined;
-    } | {
         id: string;
         type: "logic";
+        alias?: string | undefined;
         script: string;
         concurrency: boolean;
         language: "javascript" | "python" | "typescript";
         maxExecutionTime: number;
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "or";
         alias?: string | undefined;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "reference";
+        alias?: string | undefined;
         reference: string;
         enabled: boolean;
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "exit";
@@ -262,64 +474,117 @@ export declare class NodeTree {
     getParents(nodeId: string): ({
         id: string;
         type: "entry";
-        inputSchema: import("json-schema").JSONSchema7;
         alias?: string | undefined;
+        inputSchema: import("json-schema").JSONSchema7;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "service";
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        alias?: string | undefined;
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
         name: string;
         version: string;
+        configuration?: any;
         configurationSchema: import("json-schema").JSONSchema7;
-        mode: "LINEAR" | "CONTINUOUS";
+        ttl?: number | undefined;
+        retry: number;
+        retryDelay?: number | undefined;
+        mode: "CONTINUOUS" | "LINEAR";
+        privileged: boolean;
+        wireCodec?: "json" | "msgpack" | undefined;
+        configurationServices?: {
+            outputs: {
+                name: string | null;
+                schema: import("json-schema").JSONSchema7 | null;
+            }[];
+            id: string;
+            type: "service";
+            alias?: string | undefined;
+            inputSchema: {
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7) | ({
+                oneOf: ({
+                    type: "null";
+                } | ({
+                    type: "object";
+                } & import("json-schema").JSONSchema7) | ({
+                    $ref: string;
+                } & import("json-schema").JSONSchema7))[];
+            } & import("json-schema").JSONSchema7);
+            name: string;
+            version: string;
+            configuration?: any;
+            configurationSchema: import("json-schema").JSONSchema7;
+            ttl?: number | undefined;
+            retry: number;
+            retryDelay?: number | undefined;
+            mode: "CONTINUOUS" | "LINEAR";
+            privileged: boolean;
+            wireCodec?: "json" | "msgpack" | undefined;
+            configurationServices?: /*elided*/ any[] | undefined;
+        }[] | undefined;
+    } | {
         outputs: {
             name: string | null;
             schema: import("json-schema").JSONSchema7 | null;
         }[];
-        alias?: string | undefined;
-        configuration?: any;
-        ttl?: number | undefined;
-        retry?: number | undefined;
-        retryDelay?: number | undefined;
-    } | {
         id: string;
         type: "logic";
+        alias?: string | undefined;
         script: string;
         concurrency: boolean;
         language: "javascript" | "python" | "typescript";
         maxExecutionTime: number;
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "or";
         alias?: string | undefined;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "reference";
+        alias?: string | undefined;
         reference: string;
         enabled: boolean;
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "exit";
@@ -334,64 +599,117 @@ export declare class NodeTree {
     getAllParents(nodeId: string): ({
         id: string;
         type: "entry";
-        inputSchema: import("json-schema").JSONSchema7;
         alias?: string | undefined;
+        inputSchema: import("json-schema").JSONSchema7;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "service";
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        alias?: string | undefined;
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
         name: string;
         version: string;
+        configuration?: any;
         configurationSchema: import("json-schema").JSONSchema7;
-        mode: "LINEAR" | "CONTINUOUS";
+        ttl?: number | undefined;
+        retry: number;
+        retryDelay?: number | undefined;
+        mode: "CONTINUOUS" | "LINEAR";
+        privileged: boolean;
+        wireCodec?: "json" | "msgpack" | undefined;
+        configurationServices?: {
+            outputs: {
+                name: string | null;
+                schema: import("json-schema").JSONSchema7 | null;
+            }[];
+            id: string;
+            type: "service";
+            alias?: string | undefined;
+            inputSchema: {
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7) | ({
+                oneOf: ({
+                    type: "null";
+                } | ({
+                    type: "object";
+                } & import("json-schema").JSONSchema7) | ({
+                    $ref: string;
+                } & import("json-schema").JSONSchema7))[];
+            } & import("json-schema").JSONSchema7);
+            name: string;
+            version: string;
+            configuration?: any;
+            configurationSchema: import("json-schema").JSONSchema7;
+            ttl?: number | undefined;
+            retry: number;
+            retryDelay?: number | undefined;
+            mode: "CONTINUOUS" | "LINEAR";
+            privileged: boolean;
+            wireCodec?: "json" | "msgpack" | undefined;
+            configurationServices?: /*elided*/ any[] | undefined;
+        }[] | undefined;
+    } | {
         outputs: {
             name: string | null;
             schema: import("json-schema").JSONSchema7 | null;
         }[];
-        alias?: string | undefined;
-        configuration?: any;
-        ttl?: number | undefined;
-        retry?: number | undefined;
-        retryDelay?: number | undefined;
-    } | {
         id: string;
         type: "logic";
+        alias?: string | undefined;
         script: string;
         concurrency: boolean;
         language: "javascript" | "python" | "typescript";
         maxExecutionTime: number;
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "or";
         alias?: string | undefined;
     } | {
+        outputs: {
+            name: string | null;
+            schema: import("json-schema").JSONSchema7 | null;
+        }[];
         id: string;
         type: "reference";
+        alias?: string | undefined;
         reference: string;
         enabled: boolean;
-        inputSchema: ({
-            type: "object";
-        } & import("json-schema").JSONSchema7) | {
+        inputSchema: {
             type: "null";
         } | ({
+            type: "object";
+        } & import("json-schema").JSONSchema7) | ({
             $ref: string;
+        } & import("json-schema").JSONSchema7) | ({
+            oneOf: ({
+                type: "null";
+            } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
+                $ref: string;
+            } & import("json-schema").JSONSchema7))[];
         } & import("json-schema").JSONSchema7);
-        outputs: {
-            name: string | null;
-            schema: import("json-schema").JSONSchema7 | null;
-        }[];
-        alias?: string | undefined;
     } | {
         id: string;
         type: "exit";
@@ -419,64 +737,117 @@ export declare class NodeTree {
         node: {
             id: string;
             type: "entry";
-            inputSchema: import("json-schema").JSONSchema7;
             alias?: string | undefined;
+            inputSchema: import("json-schema").JSONSchema7;
         } | {
+            outputs: {
+                name: string | null;
+                schema: import("json-schema").JSONSchema7 | null;
+            }[];
             id: string;
             type: "service";
-            inputSchema: ({
-                type: "object";
-            } & import("json-schema").JSONSchema7) | {
+            alias?: string | undefined;
+            inputSchema: {
                 type: "null";
             } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
                 $ref: string;
+            } & import("json-schema").JSONSchema7) | ({
+                oneOf: ({
+                    type: "null";
+                } | ({
+                    type: "object";
+                } & import("json-schema").JSONSchema7) | ({
+                    $ref: string;
+                } & import("json-schema").JSONSchema7))[];
             } & import("json-schema").JSONSchema7);
             name: string;
             version: string;
+            configuration?: any;
             configurationSchema: import("json-schema").JSONSchema7;
-            mode: "LINEAR" | "CONTINUOUS";
+            ttl?: number | undefined;
+            retry: number;
+            retryDelay?: number | undefined;
+            mode: "CONTINUOUS" | "LINEAR";
+            privileged: boolean;
+            wireCodec?: "json" | "msgpack" | undefined;
+            configurationServices?: {
+                outputs: {
+                    name: string | null;
+                    schema: import("json-schema").JSONSchema7 | null;
+                }[];
+                id: string;
+                type: "service";
+                alias?: string | undefined;
+                inputSchema: {
+                    type: "null";
+                } | ({
+                    type: "object";
+                } & import("json-schema").JSONSchema7) | ({
+                    $ref: string;
+                } & import("json-schema").JSONSchema7) | ({
+                    oneOf: ({
+                        type: "null";
+                    } | ({
+                        type: "object";
+                    } & import("json-schema").JSONSchema7) | ({
+                        $ref: string;
+                    } & import("json-schema").JSONSchema7))[];
+                } & import("json-schema").JSONSchema7);
+                name: string;
+                version: string;
+                configuration?: any;
+                configurationSchema: import("json-schema").JSONSchema7;
+                ttl?: number | undefined;
+                retry: number;
+                retryDelay?: number | undefined;
+                mode: "CONTINUOUS" | "LINEAR";
+                privileged: boolean;
+                wireCodec?: "json" | "msgpack" | undefined;
+                configurationServices?: /*elided*/ any[] | undefined;
+            }[] | undefined;
+        } | {
             outputs: {
                 name: string | null;
                 schema: import("json-schema").JSONSchema7 | null;
             }[];
-            alias?: string | undefined;
-            configuration?: any;
-            ttl?: number | undefined;
-            retry?: number | undefined;
-            retryDelay?: number | undefined;
-        } | {
             id: string;
             type: "logic";
+            alias?: string | undefined;
             script: string;
             concurrency: boolean;
             language: "javascript" | "python" | "typescript";
             maxExecutionTime: number;
-            outputs: {
-                name: string | null;
-                schema: import("json-schema").JSONSchema7 | null;
-            }[];
-            alias?: string | undefined;
         } | {
             id: string;
             type: "or";
             alias?: string | undefined;
         } | {
+            outputs: {
+                name: string | null;
+                schema: import("json-schema").JSONSchema7 | null;
+            }[];
             id: string;
             type: "reference";
+            alias?: string | undefined;
             reference: string;
             enabled: boolean;
-            inputSchema: ({
-                type: "object";
-            } & import("json-schema").JSONSchema7) | {
+            inputSchema: {
                 type: "null";
             } | ({
+                type: "object";
+            } & import("json-schema").JSONSchema7) | ({
                 $ref: string;
+            } & import("json-schema").JSONSchema7) | ({
+                oneOf: ({
+                    type: "null";
+                } | ({
+                    type: "object";
+                } & import("json-schema").JSONSchema7) | ({
+                    $ref: string;
+                } & import("json-schema").JSONSchema7))[];
             } & import("json-schema").JSONSchema7);
-            outputs: {
-                name: string | null;
-                schema: import("json-schema").JSONSchema7 | null;
-            }[];
-            alias?: string | undefined;
         } | {
             id: string;
             type: "exit";
@@ -503,6 +874,19 @@ export declare class NodeTree {
     getAggregatedData(targetNodeId: string): Record<string, unknown>;
     getAggregatedEdgeData(edgeId: string): Record<string, unknown>;
     reset(): void;
+    /**
+     * Drops every payload no edge references any more.
+     *
+     * A `Set`, not an array (issue #117): this runs first thing in
+     * `machinePacker.packMutable`, so once per inbound message under the
+     * persist-before-ack contract — 570 flushes/minute on edge during the
+     * 2026-08-06 load test. Testing each candidate against an array made the work
+     * edges × data on every one of those calls.
+     *
+     * Deleting straight out of the iteration is safe (a `Map` iterator tolerates
+     * removal of the entry it is on) and spares the intermediate array of keys.
+     * The deletion behaviour is unchanged; only the lookup moved.
+     */
     gc(): void;
     overrideAggregatedNodeData(nodeId: string, data: Record<string, unknown>): void;
 }