@aeolus-fleet/common 0.27.1 → 0.28.1

package/dist/schemas/network.d.ts

@@ -6,7 +6,7 @@ import { z } from 'zod';
  * holds for every ship). Allow-only. The limits are the decision's; the server
  * checks them, so every refusal names it.
  */
-/** The most rules of argo's one fleet may hold, beside the rules its ships declared (decision 0037). */
+/** The most rules of its own one fleet may hold, beside the rules its ships declared (decision 0037). */
 export declare const NETWORK_RULES_MAX = 200;
 /** The most rules one ship may declare (decision 0037). */
 export declare const DECLARED_NETWORK_RULES_MAX = 20;
@@ -92,9 +92,41 @@ export declare const networkRuleSchema: z.ZodObject<{
     }, z.core.$strip>]>>;
 }, z.core.$strip>;
 export type NetworkRule = z.infer<typeof networkRuleSchema>;
-/** Input of `fleet.setNetworkRules` (fleet:network): every rule the fleet holds from now on beside the built-in ones. */
-export declare const setNetworkRulesInputSchema: z.ZodObject<{
-    rules: z.ZodArray<z.ZodObject<{
+/** The fleet's own rules: the whole list, or none for all-to-all, open on (decision 0034). */
+export declare const networkRulesSchema: z.ZodNullable<z.ZodArray<z.ZodObject<{
+    verb: z.ZodEnum<{
+        send: "send";
+        read: "read";
+        manage: "manage";
+    }>;
+    from: z.ZodArray<z.ZodUnion<readonly [z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>, z.ZodObject<{
+        labelId: z.ZodType<`lbl_${string}`, unknown, z.core.$ZodTypeInternals<`lbl_${string}`, unknown>>;
+        value: z.ZodEnum<{
+            "*": "*";
+            "#": "#";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        owner: z.ZodUnion<readonly [z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>, z.ZodEnum<{
+            "*": "*";
+            "#": "#";
+        }>]>;
+    }, z.core.$strip>]>>;
+    to: z.ZodArray<z.ZodUnion<readonly [z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>, z.ZodObject<{
+        labelId: z.ZodType<`lbl_${string}`, unknown, z.core.$ZodTypeInternals<`lbl_${string}`, unknown>>;
+        value: z.ZodEnum<{
+            "*": "*";
+            "#": "#";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        owner: z.ZodUnion<readonly [z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>, z.ZodEnum<{
+            "*": "*";
+            "#": "#";
+        }>]>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>>>;
+/** Input of `fleet.saveNetworkRulesDraft` (fleet:network): the draft of the fleet's own rules, a whole list or none for all-to-all. */
+export declare const saveNetworkRulesDraftInputSchema: z.ZodObject<{
+    rules: z.ZodNullable<z.ZodArray<z.ZodObject<{
         verb: z.ZodEnum<{
             send: "send";
             read: "read";
@@ -124,23 +156,113 @@ export declare const setNetworkRulesInputSchema: z.ZodObject<{
                 "#": "#";
             }>]>;
         }, z.core.$strip>]>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Output of `fleet.saveNetworkRulesDraft`: the settings version the draft was saved against, which its apply names. */
+export declare const saveNetworkRulesDraftOutputSchema: z.ZodObject<{
+    savedAgainstVersion: z.ZodInt;
+}, z.core.$strip>;
+/** Input of `fleet.applyNetworkRules` (fleet:network): the settings version the caller saw the draft against; a moved one refuses the apply. */
+export declare const applyNetworkRulesInputSchema: z.ZodObject<{
+    version: z.ZodInt;
+}, z.core.$strip>;
+/**
+ * Output of `fleet.networkRules` (fleet:network): the applied rules at the
+ * settings version, none for a fleet that never set any, and the draft, with
+ * when it was saved and against which version, or none.
+ */
+export declare const networkRulesOutputSchema: z.ZodObject<{
+    applied: z.ZodObject<{
+        rules: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            verb: z.ZodEnum<{
+                send: "send";
+                read: "read";
+                manage: "manage";
+            }>;
+            from: z.ZodArray<z.ZodUnion<readonly [z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>, z.ZodObject<{
+                labelId: z.ZodType<`lbl_${string}`, unknown, z.core.$ZodTypeInternals<`lbl_${string}`, unknown>>;
+                value: z.ZodEnum<{
+                    "*": "*";
+                    "#": "#";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                owner: z.ZodUnion<readonly [z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>, z.ZodEnum<{
+                    "*": "*";
+                    "#": "#";
+                }>]>;
+            }, z.core.$strip>]>>;
+            to: z.ZodArray<z.ZodUnion<readonly [z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>, z.ZodObject<{
+                labelId: z.ZodType<`lbl_${string}`, unknown, z.core.$ZodTypeInternals<`lbl_${string}`, unknown>>;
+                value: z.ZodEnum<{
+                    "*": "*";
+                    "#": "#";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                owner: z.ZodUnion<readonly [z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>, z.ZodEnum<{
+                    "*": "*";
+                    "#": "#";
+                }>]>;
+            }, z.core.$strip>]>>;
+        }, z.core.$strip>>>;
+        version: z.ZodInt;
+    }, z.core.$strip>;
+    draft: z.ZodNullable<z.ZodObject<{
+        rules: z.ZodNullable<z.ZodArray<z.ZodObject<{
+            verb: z.ZodEnum<{
+                send: "send";
+                read: "read";
+                manage: "manage";
+            }>;
+            from: z.ZodArray<z.ZodUnion<readonly [z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>, z.ZodObject<{
+                labelId: z.ZodType<`lbl_${string}`, unknown, z.core.$ZodTypeInternals<`lbl_${string}`, unknown>>;
+                value: z.ZodEnum<{
+                    "*": "*";
+                    "#": "#";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                owner: z.ZodUnion<readonly [z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>, z.ZodEnum<{
+                    "*": "*";
+                    "#": "#";
+                }>]>;
+            }, z.core.$strip>]>>;
+            to: z.ZodArray<z.ZodUnion<readonly [z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>, z.ZodObject<{
+                labelId: z.ZodType<`lbl_${string}`, unknown, z.core.$ZodTypeInternals<`lbl_${string}`, unknown>>;
+                value: z.ZodEnum<{
+                    "*": "*";
+                    "#": "#";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                owner: z.ZodUnion<readonly [z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>, z.ZodEnum<{
+                    "*": "*";
+                    "#": "#";
+                }>]>;
+            }, z.core.$strip>]>>;
+        }, z.core.$strip>>>;
+        savedAt: z.ZodISODateTime;
+        savedAgainstVersion: z.ZodInt;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export type NetworkRules = z.infer<typeof networkRulesOutputSchema>;
+/** Output of `fleet.discardNetworkRulesDraft`. */
+export declare const discardNetworkRulesDraftOutputSchema: z.ZodObject<{}, z.core.$strip>;
 /**
  * The built-in rules, core's own (decision 0034): argo to and from every ship,
  * the owner's ship to the ships it owns, an answer to the sender of the
  * message it answers, and a connected plugin's ship reading every ship, which
  * are never off; the viewer reading every ship,
- * which argo turns off or on; and open, every ship to every ship, one per
- * verb, which the networking plugin turns off or on.
+ * which an actor holding fleet:network turns off or on; the installation
+ * managing person ships and the ships they own, never off (decision 0020); and
+ * open, every ship to every ship by every verb, on exactly while the fleet has
+ * no rules applied.
  */
-export declare const BUILT_IN_RULES: readonly ["argo", "owner", "answer", "pluginRead", "viewerRead", "open"];
+export declare const BUILT_IN_RULES: readonly ["argo", "owner", "answer", "pluginRead", "viewerRead", "installation", "open"];
 export type BuiltInRule = (typeof BUILT_IN_RULES)[number];
 /** The built-in rules that are never off. */
-export declare const FIXED_BUILT_IN_RULES: readonly ["argo", "owner", "answer", "pluginRead"];
-/** Input of `fleet.setBuiltInRule` (fleet:network): a built-in rule turned on or off, open for one verb, which it names and no other rule does. */
+export declare const FIXED_BUILT_IN_RULES: readonly ["argo", "owner", "answer", "pluginRead", "installation"];
+/** Input of `fleet.setBuiltInRule` (fleet:network): a built-in rule turned on or off; the server turns only the viewer reading. */
 export declare const setBuiltInRuleInputSchema: z.ZodObject<{
     rule: z.ZodEnum<{
+        installation: "installation";
         owner: "owner";
         open: "open";
         argo: "argo";
@@ -148,67 +270,38 @@ export declare const setBuiltInRuleInputSchema: z.ZodObject<{
         pluginRead: "pluginRead";
         viewerRead: "viewerRead";
     }>;
-    verb: z.ZodOptional<z.ZodEnum<{
-        send: "send";
-        read: "read";
-        manage: "manage";
-    }>>;
     isOn: z.ZodBoolean;
 }, z.core.$strip>;
 export type SetBuiltInRuleInput = z.infer<typeof setBuiltInRuleInputSchema>;
-/**
- * One built-in rule as it is now: open for one verb, which it names and no
- * other rule does, and whether it is on; the fixed ones always are.
- */
-export declare const builtInRuleStateSchema: z.ZodUnion<readonly [z.ZodObject<{
+/** One built-in rule as it is now, and whether it is on; the fixed ones always are. */
+export declare const builtInRuleStateSchema: z.ZodObject<{
     rule: z.ZodEnum<{
+        installation: "installation";
         owner: "owner";
+        open: "open";
         argo: "argo";
         answer: "answer";
         pluginRead: "pluginRead";
         viewerRead: "viewerRead";
     }>;
     isOn: z.ZodBoolean;
-}, z.core.$strip>, z.ZodObject<{
-    rule: z.ZodLiteral<"open">;
-    verb: z.ZodEnum<{
-        send: "send";
-        read: "read";
-        manage: "manage";
-    }>;
-    isOn: z.ZodBoolean;
-}, z.core.$strip>]>;
+}, z.core.$strip>;
 export type BuiltInRuleState = z.infer<typeof builtInRuleStateSchema>;
 /** Output of `fleet.builtInRules` (fleet:network): every built-in rule as it is now, in the order the rule list shows them, first (decision 0034). */
-export declare const builtInRulesOutputSchema: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+export declare const builtInRulesOutputSchema: z.ZodArray<z.ZodObject<{
     rule: z.ZodEnum<{
+        installation: "installation";
         owner: "owner";
+        open: "open";
         argo: "argo";
         answer: "answer";
         pluginRead: "pluginRead";
         viewerRead: "viewerRead";
     }>;
     isOn: z.ZodBoolean;
-}, z.core.$strip>, z.ZodObject<{
-    rule: z.ZodLiteral<"open">;
-    verb: z.ZodEnum<{
-        send: "send";
-        read: "read";
-        manage: "manage";
-    }>;
-    isOn: z.ZodBoolean;
-}, z.core.$strip>]>>;
-/**
- * Output of `fleet.networkPlugin` (fleet:read): the fleet's networking plugin,
- * its ship and when it registered, or null without one (decision 0035). The
- * gateway reads it before it switches on for a fleet (interop I-3).
- */
-export declare const networkPluginOutputSchema: z.ZodNullable<z.ZodObject<{
-    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
-    registeredAt: z.ZodISODateTime;
 }, z.core.$strip>>;
-/** Output of `fleet.setNetworkRules`: the version the fleet's network settings have now. */
-export declare const setNetworkRulesOutputSchema: z.ZodObject<{
+/** Output of `fleet.applyNetworkRules` and `fleet.setBuiltInRule`: the version the fleet's network settings have now. */
+export declare const networkVersionOutputSchema: z.ZodObject<{
     version: z.ZodInt;
 }, z.core.$strip>;
 /** Input of `fleet.declareNetworkRules` (labels:define): every rule the ship declares from now on, on labels it owns; an empty list withdraws them (decision 0037). */
@@ -249,9 +342,22 @@ export declare const declareNetworkRulesInputSchema: z.ZodObject<{
 export declare const declareNetworkRulesOutputSchema: z.ZodObject<{
     rules: z.ZodInt;
 }, z.core.$strip>;
-/** Output of `fleet.declaredNetworkRules` (fleet:network): each ship that declared rules, with its whole list. */
-export declare const declaredNetworkRulesOutputSchema: z.ZodArray<z.ZodObject<{
+/** Who declared network rules (decisions 0037, 0052): a ship, or the installation on the labels it owns. */
+export declare const declarerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"ship">;
     shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"installation">;
+}, z.core.$strip>], "kind">;
+export type Declarer = z.infer<typeof declarerSchema>;
+/** Output of `fleet.declaredNetworkRules` (fleet:network): each declarer of rules, with its whole list. */
+export declare const declaredNetworkRulesOutputSchema: z.ZodArray<z.ZodObject<{
+    declarer: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"ship">;
+        shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+    }, z.core.$strip>], "kind">;
     rules: z.ZodArray<z.ZodObject<{
         verb: z.ZodEnum<{
             send: "send";
@@ -284,38 +390,17 @@ export declare const declaredNetworkRulesOutputSchema: z.ZodArray<z.ZodObject<{
         }, z.core.$strip>]>>;
     }, z.core.$strip>>;
 }, z.core.$strip>>;
-/**
- * What happens to sends while a fleet's networking plugin is unavailable
- * (decision 0035): every send refused but the fixed exceptions, every send
- * allowed, or the rules it supplied last kept.
- */
-export declare const WHILE_UNAVAILABLE: readonly ["block-all", "open-all", "keep-latest"];
-export type WhileUnavailable = (typeof WHILE_UNAVAILABLE)[number];
-/** The least time without a call from its ship after which a networking plugin is not responding: longer than a receive waits. */
-export declare const NETWORK_PLUGIN_NOT_RESPONDING_AFTER_MIN_SECONDS = 60;
-/** The most: a day. */
-export declare const NETWORK_PLUGIN_NOT_RESPONDING_AFTER_MAX_SECONDS = 86400;
-/** Input of `fleet.registerNetworkPlugin` (fleet:network): what happens while the plugin is unavailable, and after how long without a call it is not responding. */
-export declare const registerNetworkPluginInputSchema: z.ZodObject<{
-    whileUnavailable: z.ZodEnum<{
-        "block-all": "block-all";
-        "open-all": "open-all";
-        "keep-latest": "keep-latest";
-    }>;
-    notRespondingAfterSeconds: z.ZodInt;
-}, z.core.$strip>;
-export type NetworkPluginDeclaration = z.infer<typeof registerNetworkPluginInputSchema>;
 /**
  * The request header a plugin ship names the ship it reads on behalf of with,
  * by id: every fleet:read read then answers with that ship's read reach
  * (decision 0034). Any other call refuses it.
  */
 export declare const ON_BEHALF_OF_HEADER = "aeolus-on-behalf-of";
-/** One refused send: who tried to reach whom by which verb, both ships as they were with their owners, the settings version that refused it and when. */
+/** One refused call: who tried to reach whom by which verb, the actor and the ship as they were with their owners, the settings version that refused it and when. */
 export declare const reachRefusalSchema: z.ZodObject<{
     id: z.ZodType<`rfs_${string}`, unknown, z.core.$ZodTypeInternals<`rfs_${string}`, unknown>>;
     at: z.ZodISODateTime;
-    sender: z.ZodObject<{
+    sender: z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
         name: z.ZodString;
         labels: z.ZodArray<z.ZodObject<{
@@ -328,7 +413,23 @@ export declare const reachRefusalSchema: z.ZodObject<{
             id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
             name: z.ZodString;
         }, z.core.$strip>>;
-    }, z.core.$strip>;
+        kind: z.ZodLiteral<"ship">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"account">;
+        accountId: z.core.$ZodBranded<z.ZodString, "AccountId", "out">;
+        labels: z.ZodArray<z.ZodObject<{
+            labelId: z.ZodType<`lbl_${string}`, unknown, z.core.$ZodTypeInternals<`lbl_${string}`, unknown>>;
+            key: z.ZodString;
+            valueId: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        personShip: z.ZodNullable<z.ZodObject<{
+            id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+    }, z.core.$strip>], "kind">;
     askedBy: z.ZodNullable<z.ZodObject<{
         id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
         name: z.ZodString;
@@ -383,17 +484,13 @@ export declare const reachRefusalSchema: z.ZodObject<{
         manage: "manage";
     }>;
     settingsVersion: z.ZodInt;
-    whilePluginUnavailable: z.ZodNullable<z.ZodEnum<{
-        "block-all": "block-all";
-        "keep-latest": "keep-latest";
-    }>>;
 }, z.core.$strip>;
 export type ReachRefusal = z.infer<typeof reachRefusalSchema>;
 /** Output of `fleet.reachRefusals` (argo only): the fleet's latest refusals, newest first, at most REACH_REFUSALS_READ_MAX. */
 export declare const reachRefusalsOutputSchema: z.ZodArray<z.ZodObject<{
     id: z.ZodType<`rfs_${string}`, unknown, z.core.$ZodTypeInternals<`rfs_${string}`, unknown>>;
     at: z.ZodISODateTime;
-    sender: z.ZodObject<{
+    sender: z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
         name: z.ZodString;
         labels: z.ZodArray<z.ZodObject<{
@@ -406,7 +503,23 @@ export declare const reachRefusalsOutputSchema: z.ZodArray<z.ZodObject<{
             id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
             name: z.ZodString;
         }, z.core.$strip>>;
-    }, z.core.$strip>;
+        kind: z.ZodLiteral<"ship">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"account">;
+        accountId: z.core.$ZodBranded<z.ZodString, "AccountId", "out">;
+        labels: z.ZodArray<z.ZodObject<{
+            labelId: z.ZodType<`lbl_${string}`, unknown, z.core.$ZodTypeInternals<`lbl_${string}`, unknown>>;
+            key: z.ZodString;
+            valueId: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        personShip: z.ZodNullable<z.ZodObject<{
+            id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+    }, z.core.$strip>], "kind">;
     askedBy: z.ZodNullable<z.ZodObject<{
         id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
         name: z.ZodString;
@@ -461,24 +574,25 @@ export declare const reachRefusalsOutputSchema: z.ZodArray<z.ZodObject<{
         manage: "manage";
     }>;
     settingsVersion: z.ZodInt;
-    whilePluginUnavailable: z.ZodNullable<z.ZodEnum<{
-        "block-all": "block-all";
-        "keep-latest": "keep-latest";
-    }>>;
 }, z.core.$strip>>;
-/** Input of `fleet.explainReach` (argo only): the ship to explain from, and the one ship asked about, or none for every ship. */
+/** Input of `fleet.explainReach` (fleet:explain): the ship to explain from, the one ship asked about or none for every ship, and the rules to explain against: the applied ones, or the draft. */
 export declare const explainReachInputSchema: z.ZodObject<{
     fromShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
     toShipId: z.ZodOptional<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+    against: z.ZodOptional<z.ZodEnum<{
+        applied: "applied";
+        draft: "draft";
+    }>>;
 }, z.core.$strip>;
 /**
  * The rule that lets one ship reach another (decision 0034): a built-in rule;
- * a rule the networking plugin supplied, by its place in the fleet's list;
- * or a rule a ship declared, by its declarer and its place in that ship's
- * list (decision 0037).
+ * one of the fleet's own rules, by its place in the fleet's list;
+ * or a declared rule, by its declarer, a ship or the installation, and its
+ * place in that declarer's list (decision 0037).
  */
 export declare const reachRuleSchema: z.ZodUnion<readonly [z.ZodObject<{
     builtIn: z.ZodEnum<{
+        installation: "installation";
         owner: "owner";
         open: "open";
         argo: "argo";
@@ -487,9 +601,14 @@ export declare const reachRuleSchema: z.ZodUnion<readonly [z.ZodObject<{
         viewerRead: "viewerRead";
     }>;
 }, z.core.$strip>, z.ZodObject<{
-    plugin: z.ZodInt;
+    rule: z.ZodInt;
 }, z.core.$strip>, z.ZodObject<{
-    declared: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"ship">;
+        shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"installation">;
+    }, z.core.$strip>], "kind">;
     index: z.ZodInt;
 }, z.core.$strip>]>;
 export type ReachRule = z.infer<typeof reachRuleSchema>;
@@ -499,6 +618,7 @@ export declare const explainReachOutputSchema: z.ZodObject<{
         shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
         rule: z.ZodUnion<readonly [z.ZodObject<{
             builtIn: z.ZodEnum<{
+                installation: "installation";
                 owner: "owner";
                 open: "open";
                 argo: "argo";
@@ -507,9 +627,14 @@ export declare const explainReachOutputSchema: z.ZodObject<{
                 viewerRead: "viewerRead";
             }>;
         }, z.core.$strip>, z.ZodObject<{
-            plugin: z.ZodInt;
+            rule: z.ZodInt;
         }, z.core.$strip>, z.ZodObject<{
-            declared: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"ship">;
+                shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+            }, z.core.$strip>], "kind">;
             index: z.ZodInt;
         }, z.core.$strip>]>;
     }, z.core.$strip>>;
@@ -517,6 +642,7 @@ export declare const explainReachOutputSchema: z.ZodObject<{
         shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
         rule: z.ZodUnion<readonly [z.ZodObject<{
             builtIn: z.ZodEnum<{
+                installation: "installation";
                 owner: "owner";
                 open: "open";
                 argo: "argo";
@@ -525,9 +651,14 @@ export declare const explainReachOutputSchema: z.ZodObject<{
                 viewerRead: "viewerRead";
             }>;
         }, z.core.$strip>, z.ZodObject<{
-            plugin: z.ZodInt;
+            rule: z.ZodInt;
         }, z.core.$strip>, z.ZodObject<{
-            declared: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"ship">;
+                shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+            }, z.core.$strip>], "kind">;
             index: z.ZodInt;
         }, z.core.$strip>]>;
     }, z.core.$strip>>;
@@ -535,6 +666,7 @@ export declare const explainReachOutputSchema: z.ZodObject<{
         shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
         rule: z.ZodUnion<readonly [z.ZodObject<{
             builtIn: z.ZodEnum<{
+                installation: "installation";
                 owner: "owner";
                 open: "open";
                 argo: "argo";
@@ -543,11 +675,181 @@ export declare const explainReachOutputSchema: z.ZodObject<{
                 viewerRead: "viewerRead";
             }>;
         }, z.core.$strip>, z.ZodObject<{
-            plugin: z.ZodInt;
+            rule: z.ZodInt;
         }, z.core.$strip>, z.ZodObject<{
-            declared: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"ship">;
+                shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"installation">;
+            }, z.core.$strip>], "kind">;
             index: z.ZodInt;
         }, z.core.$strip>]>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ExplainedReach = z.infer<typeof explainReachOutputSchema>;
+/**
+ * Output of `fleet.networkRulesDraftChanges` (fleet:network): per verb, the
+ * pairs of ships the caller reads whose reach the draft gains, each with the
+ * draft's rule that allows it, and loses, each with the applied rule that
+ * allows it now (decision 0034).
+ */
+export declare const networkRulesDraftChangesOutputSchema: z.ZodObject<{
+    send: z.ZodObject<{
+        gained: z.ZodArray<z.ZodObject<{
+            fromShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            toShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            rule: z.ZodUnion<readonly [z.ZodObject<{
+                builtIn: z.ZodEnum<{
+                    installation: "installation";
+                    owner: "owner";
+                    open: "open";
+                    argo: "argo";
+                    answer: "answer";
+                    pluginRead: "pluginRead";
+                    viewerRead: "viewerRead";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                rule: z.ZodInt;
+            }, z.core.$strip>, z.ZodObject<{
+                declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"ship">;
+                    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                }, z.core.$strip>], "kind">;
+                index: z.ZodInt;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>;
+        lost: z.ZodArray<z.ZodObject<{
+            fromShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            toShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            rule: z.ZodUnion<readonly [z.ZodObject<{
+                builtIn: z.ZodEnum<{
+                    installation: "installation";
+                    owner: "owner";
+                    open: "open";
+                    argo: "argo";
+                    answer: "answer";
+                    pluginRead: "pluginRead";
+                    viewerRead: "viewerRead";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                rule: z.ZodInt;
+            }, z.core.$strip>, z.ZodObject<{
+                declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"ship">;
+                    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                }, z.core.$strip>], "kind">;
+                index: z.ZodInt;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    read: z.ZodObject<{
+        gained: z.ZodArray<z.ZodObject<{
+            fromShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            toShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            rule: z.ZodUnion<readonly [z.ZodObject<{
+                builtIn: z.ZodEnum<{
+                    installation: "installation";
+                    owner: "owner";
+                    open: "open";
+                    argo: "argo";
+                    answer: "answer";
+                    pluginRead: "pluginRead";
+                    viewerRead: "viewerRead";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                rule: z.ZodInt;
+            }, z.core.$strip>, z.ZodObject<{
+                declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"ship">;
+                    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                }, z.core.$strip>], "kind">;
+                index: z.ZodInt;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>;
+        lost: z.ZodArray<z.ZodObject<{
+            fromShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            toShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            rule: z.ZodUnion<readonly [z.ZodObject<{
+                builtIn: z.ZodEnum<{
+                    installation: "installation";
+                    owner: "owner";
+                    open: "open";
+                    argo: "argo";
+                    answer: "answer";
+                    pluginRead: "pluginRead";
+                    viewerRead: "viewerRead";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                rule: z.ZodInt;
+            }, z.core.$strip>, z.ZodObject<{
+                declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"ship">;
+                    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                }, z.core.$strip>], "kind">;
+                index: z.ZodInt;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    manage: z.ZodObject<{
+        gained: z.ZodArray<z.ZodObject<{
+            fromShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            toShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            rule: z.ZodUnion<readonly [z.ZodObject<{
+                builtIn: z.ZodEnum<{
+                    installation: "installation";
+                    owner: "owner";
+                    open: "open";
+                    argo: "argo";
+                    answer: "answer";
+                    pluginRead: "pluginRead";
+                    viewerRead: "viewerRead";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                rule: z.ZodInt;
+            }, z.core.$strip>, z.ZodObject<{
+                declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"ship">;
+                    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                }, z.core.$strip>], "kind">;
+                index: z.ZodInt;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>;
+        lost: z.ZodArray<z.ZodObject<{
+            fromShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            toShipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            rule: z.ZodUnion<readonly [z.ZodObject<{
+                builtIn: z.ZodEnum<{
+                    installation: "installation";
+                    owner: "owner";
+                    open: "open";
+                    argo: "argo";
+                    answer: "answer";
+                    pluginRead: "pluginRead";
+                    viewerRead: "viewerRead";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                rule: z.ZodInt;
+            }, z.core.$strip>, z.ZodObject<{
+                declared: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"ship">;
+                    shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"installation">;
+                }, z.core.$strip>], "kind">;
+                index: z.ZodInt;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type NetworkRulesDraftChanges = z.infer<typeof networkRulesDraftChangesOutputSchema>;