@aeolus-fleet/common 0.26.1 → 0.27.1

package/dist/schemas/network.d.ts

@@ -1,8 +1,8 @@
 import { z } from 'zod';
 /**
- * Network rules (decision 0034): which ships may send to which. A rule says
- * that the ships matching one label selector may send to the ships matching
- * another; a selector is a list of terms that must all hold (an empty one
+ * Network rules (decision 0034): which ships may send to, read or manage
+ * which. A rule names its verb and says that the ships matching one selector
+ * may do it to the ships matching another; a selector is a list of terms that must all hold (an empty one
  * holds for every ship). Allow-only. The limits are the decision's; the server
  * checks them, so every refusal names it.
  */
@@ -18,8 +18,10 @@ export declare const ANY_LABEL_VALUE: "*";
 export declare const SAME_LABEL_VALUE: "#";
 /**
  * One term of a selector: an exact label value, written as its id, which
- * names its label; or a label with any value (`*`) or with the same value as
- * the other side's (`#`), which binds the same label there only.
+ * names its label; a label with any value (`*`) or with the same value as
+ * the other side's (`#`), which binds the same label there only; or the
+ * owner (decision 0045): an owner's ship by its id, any owner (`*`), or the
+ * same owner as the other side's (`#`), which binds the owner there.
  */
 export declare const selectorTermSchema: 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>>;
@@ -27,8 +29,20 @@ export declare const selectorTermSchema: z.ZodUnion<readonly [z.ZodType<`lbv_${s
         "*": "*";
         "#": "#";
     }>;
+}, 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>]>;
 export type SelectorTerm = z.infer<typeof selectorTermSchema>;
+/** A term of the owner (decision 0045). */
+export type OwnerTerm = Extract<SelectorTerm, {
+    owner: unknown;
+}>;
+/** A term on a label: an exact value, or a label with any or the same value. */
+export type LabelTerm = Exclude<SelectorTerm, OwnerTerm>;
+export declare function isOwnerTerm(term: SelectorTerm): term is OwnerTerm;
 /** The ships for which every one of these terms holds, combined with AND. */
 export declare const labelSelectorSchema: 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>>;
@@ -36,15 +50,33 @@ export declare const labelSelectorSchema: z.ZodArray<z.ZodUnion<readonly [z.ZodT
         "*": "*";
         "#": "#";
     }>;
+}, 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>]>>;
-/** One rule: the ships matching `from` may send to the ships matching `to`. */
+/** What a rule lets one ship do to another: send to it, read it or manage it (decision 0034). */
+export declare const NETWORK_VERBS: readonly ["send", "read", "manage"];
+export type NetworkVerb = (typeof NETWORK_VERBS)[number];
+/** One rule: the ships matching `from` may do its verb to the ships matching `to`. */
 export declare const networkRuleSchema: 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>>;
@@ -52,18 +84,33 @@ export declare const networkRuleSchema: z.ZodObject<{
             "*": "*";
             "#": "#";
         }>;
+    }, 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>;
 export type NetworkRule = z.infer<typeof networkRuleSchema>;
-/** Input of `fleet.setNetworkRules` (fleet:network): every rule the fleet holds from now on, or none for all-to-all. */
+/** 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.ZodNullable<z.ZodArray<z.ZodObject<{
+    rules: 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>>;
@@ -71,9 +118,95 @@ export declare const setNetworkRulesInputSchema: z.ZodObject<{
                 "*": "*";
                 "#": "#";
             }>;
+        }, 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>>>;
+    }, z.core.$strip>>;
 }, 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.
+ */
+export declare const BUILT_IN_RULES: readonly ["argo", "owner", "answer", "pluginRead", "viewerRead", "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 setBuiltInRuleInputSchema: z.ZodObject<{
+    rule: z.ZodEnum<{
+        owner: "owner";
+        open: "open";
+        argo: "argo";
+        answer: "answer";
+        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<{
+    rule: z.ZodEnum<{
+        owner: "owner";
+        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>]>;
+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<{
+    rule: z.ZodEnum<{
+        owner: "owner";
+        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<{
     version: z.ZodInt;
@@ -81,12 +214,22 @@ export declare const setNetworkRulesOutputSchema: z.ZodObject<{
 /** 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). */
 export declare const declareNetworkRulesInputSchema: z.ZodObject<{
     rules: 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>>;
@@ -94,6 +237,11 @@ export declare const declareNetworkRulesInputSchema: z.ZodObject<{
                 "*": "*";
                 "#": "#";
             }>;
+        }, 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>>;
 }, z.core.$strip>;
@@ -105,12 +253,22 @@ export declare const declareNetworkRulesOutputSchema: z.ZodObject<{
 export declare const declaredNetworkRulesOutputSchema: z.ZodArray<z.ZodObject<{
     shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
     rules: 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>>;
@@ -118,6 +276,11 @@ export declare const declaredNetworkRulesOutputSchema: z.ZodArray<z.ZodObject<{
                 "*": "*";
                 "#": "#";
             }>;
+        }, 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>>;
 }, z.core.$strip>>;
@@ -142,7 +305,13 @@ export declare const registerNetworkPluginInputSchema: z.ZodObject<{
     notRespondingAfterSeconds: z.ZodInt;
 }, z.core.$strip>;
 export type NetworkPluginDeclaration = z.infer<typeof registerNetworkPluginInputSchema>;
-/** One refused send: who tried to reach whom, both ships as they were, the settings version that refused it and when. */
+/**
+ * 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. */
 export declare const reachRefusalSchema: z.ZodObject<{
     id: z.ZodType<`rfs_${string}`, unknown, z.core.$ZodTypeInternals<`rfs_${string}`, unknown>>;
     at: z.ZodISODateTime;
@@ -155,7 +324,25 @@ export declare const reachRefusalSchema: z.ZodObject<{
             valueId: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
             value: z.ZodString;
         }, z.core.$strip>>;
+        owner: 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>;
+    askedBy: z.ZodNullable<z.ZodObject<{
+        id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        name: z.ZodString;
+        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>>;
+        owner: 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>>;
     recipient: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"ship">;
         ship: z.ZodObject<{
@@ -167,6 +354,10 @@ export declare const reachRefusalSchema: z.ZodObject<{
                 valueId: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
                 value: z.ZodString;
             }, z.core.$strip>>;
+            owner: 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.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"type">;
@@ -180,8 +371,17 @@ export declare const reachRefusalSchema: z.ZodObject<{
                 valueId: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
                 value: z.ZodString;
             }, z.core.$strip>>;
+            owner: 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.core.$strip>], "kind">;
+    verb: z.ZodEnum<{
+        send: "send";
+        read: "read";
+        manage: "manage";
+    }>;
     settingsVersion: z.ZodInt;
     whilePluginUnavailable: z.ZodNullable<z.ZodEnum<{
         "block-all": "block-all";
@@ -202,7 +402,25 @@ export declare const reachRefusalsOutputSchema: z.ZodArray<z.ZodObject<{
             valueId: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
             value: z.ZodString;
         }, z.core.$strip>>;
+        owner: 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>;
+    askedBy: z.ZodNullable<z.ZodObject<{
+        id: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        name: z.ZodString;
+        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>>;
+        owner: 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>>;
     recipient: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"ship">;
         ship: z.ZodObject<{
@@ -214,6 +432,10 @@ export declare const reachRefusalsOutputSchema: z.ZodArray<z.ZodObject<{
                 valueId: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
                 value: z.ZodString;
             }, z.core.$strip>>;
+            owner: 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.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"type">;
@@ -227,8 +449,17 @@ export declare const reachRefusalsOutputSchema: z.ZodArray<z.ZodObject<{
                 valueId: z.ZodType<`lbv_${string}`, unknown, z.core.$ZodTypeInternals<`lbv_${string}`, unknown>>;
                 value: z.ZodString;
             }, z.core.$strip>>;
+            owner: 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.core.$strip>], "kind">;
+    verb: z.ZodEnum<{
+        send: "send";
+        read: "read";
+        manage: "manage";
+    }>;
     settingsVersion: z.ZodInt;
     whilePluginUnavailable: z.ZodNullable<z.ZodEnum<{
         "block-all": "block-all";
@@ -240,7 +471,83 @@ 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>>>;
 }, z.core.$strip>;
-/** Output of `fleet.explainReach`: the ships it reaches now, by id; never the rules or why (design on #260). */
+/**
+ * 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).
+ */
+export declare const reachRuleSchema: z.ZodUnion<readonly [z.ZodObject<{
+    builtIn: z.ZodEnum<{
+        owner: "owner";
+        open: "open";
+        argo: "argo";
+        answer: "answer";
+        pluginRead: "pluginRead";
+        viewerRead: "viewerRead";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    plugin: z.ZodInt;
+}, z.core.$strip>, z.ZodObject<{
+    declared: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+    index: z.ZodInt;
+}, z.core.$strip>]>;
+export type ReachRule = z.infer<typeof reachRuleSchema>;
+/** Output of `fleet.explainReach`: per verb, the ships it reaches now, each with the rule that allows it. */
 export declare const explainReachOutputSchema: z.ZodObject<{
-    reachableShipIds: z.ZodArray<z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>>;
+    send: z.ZodArray<z.ZodObject<{
+        shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        rule: z.ZodUnion<readonly [z.ZodObject<{
+            builtIn: z.ZodEnum<{
+                owner: "owner";
+                open: "open";
+                argo: "argo";
+                answer: "answer";
+                pluginRead: "pluginRead";
+                viewerRead: "viewerRead";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            plugin: z.ZodInt;
+        }, z.core.$strip>, z.ZodObject<{
+            declared: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            index: z.ZodInt;
+        }, z.core.$strip>]>;
+    }, z.core.$strip>>;
+    read: z.ZodArray<z.ZodObject<{
+        shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        rule: z.ZodUnion<readonly [z.ZodObject<{
+            builtIn: z.ZodEnum<{
+                owner: "owner";
+                open: "open";
+                argo: "argo";
+                answer: "answer";
+                pluginRead: "pluginRead";
+                viewerRead: "viewerRead";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            plugin: z.ZodInt;
+        }, z.core.$strip>, z.ZodObject<{
+            declared: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            index: z.ZodInt;
+        }, z.core.$strip>]>;
+    }, z.core.$strip>>;
+    manage: z.ZodArray<z.ZodObject<{
+        shipId: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+        rule: z.ZodUnion<readonly [z.ZodObject<{
+            builtIn: z.ZodEnum<{
+                owner: "owner";
+                open: "open";
+                argo: "argo";
+                answer: "answer";
+                pluginRead: "pluginRead";
+                viewerRead: "viewerRead";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            plugin: z.ZodInt;
+        }, z.core.$strip>, z.ZodObject<{
+            declared: z.ZodType<`shp_${string}`, unknown, z.core.$ZodTypeInternals<`shp_${string}`, unknown>>;
+            index: z.ZodInt;
+        }, z.core.$strip>]>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
+export type ExplainedReach = z.infer<typeof explainReachOutputSchema>;

package/dist/schemas/network.js

@@ -2,9 +2,9 @@ import { z } from 'zod';
 import { idSchema } from '../ids/index.js';
 import { carriedLabelSchema } from './label.js';
 /**
- * Network rules (decision 0034): which ships may send to which. A rule says
- * that the ships matching one label selector may send to the ships matching
- * another; a selector is a list of terms that must all hold (an empty one
+ * Network rules (decision 0034): which ships may send to, read or manage
+ * which. A rule names its verb and says that the ships matching one selector
+ * may do it to the ships matching another; a selector is a list of terms that must all hold (an empty one
  * holds for every ship). Allow-only. The limits are the decision's; the server
  * checks them, so every refusal names it.
  */
@@ -20,16 +20,58 @@ export const ANY_LABEL_VALUE = '*';
 export const SAME_LABEL_VALUE = '#';
 /**
  * One term of a selector: an exact label value, written as its id, which
- * names its label; or a label with any value (`*`) or with the same value as
- * the other side's (`#`), which binds the same label there only.
+ * names its label; a label with any value (`*`) or with the same value as
+ * the other side's (`#`), which binds the same label there only; or the
+ * owner (decision 0045): an owner's ship by its id, any owner (`*`), or the
+ * same owner as the other side's (`#`), which binds the owner there.
  */
-export const selectorTermSchema = z.union([idSchema('labelValue'), z.object({ labelId: idSchema('label'), value: z.enum([ANY_LABEL_VALUE, SAME_LABEL_VALUE]) })]);
+export const selectorTermSchema = z.union([
+    idSchema('labelValue'),
+    z.object({ labelId: idSchema('label'), value: z.enum([ANY_LABEL_VALUE, SAME_LABEL_VALUE]) }),
+    z.object({ owner: z.union([idSchema('ship'), z.enum([ANY_LABEL_VALUE, SAME_LABEL_VALUE])]) }),
+]);
+export function isOwnerTerm(term) {
+    return typeof term !== 'string' && 'owner' in term;
+}
 /** The ships for which every one of these terms holds, combined with AND. */
 export const labelSelectorSchema = z.array(selectorTermSchema);
-/** One rule: the ships matching `from` may send to the ships matching `to`. */
-export const networkRuleSchema = z.object({ from: labelSelectorSchema, to: labelSelectorSchema });
-/** Input of `fleet.setNetworkRules` (fleet:network): every rule the fleet holds from now on, or none for all-to-all. */
-export const setNetworkRulesInputSchema = z.object({ rules: z.array(networkRuleSchema).nullable() });
+/** What a rule lets one ship do to another: send to it, read it or manage it (decision 0034). */
+export const NETWORK_VERBS = ['send', 'read', 'manage'];
+/** One rule: the ships matching `from` may do its verb to the ships matching `to`. */
+export const networkRuleSchema = z.object({ verb: z.enum(NETWORK_VERBS), from: labelSelectorSchema, to: labelSelectorSchema });
+/** Input of `fleet.setNetworkRules` (fleet:network): every rule the fleet holds from now on beside the built-in ones. */
+export const setNetworkRulesInputSchema = z.object({ rules: z.array(networkRuleSchema) });
+/**
+ * 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.
+ */
+export const BUILT_IN_RULES = ['argo', 'owner', 'answer', 'pluginRead', 'viewerRead', 'open'];
+/** The built-in rules that are never off. */
+export const FIXED_BUILT_IN_RULES = ['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 const setBuiltInRuleInputSchema = z
+    .object({ rule: z.enum(BUILT_IN_RULES), verb: z.enum(NETWORK_VERBS).optional(), isOn: z.boolean() })
+    .refine((input) => (input.rule === 'open') === (input.verb !== undefined), { message: 'open names its verb, and no other built-in rule names one', path: ['verb'] });
+/**
+ * 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 const builtInRuleStateSchema = z.union([
+    z.object({ rule: z.enum(['argo', 'owner', 'answer', 'pluginRead', 'viewerRead']), isOn: z.boolean() }),
+    z.object({ rule: z.literal('open'), verb: z.enum(NETWORK_VERBS), isOn: z.boolean() }),
+]);
+/** 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 const builtInRulesOutputSchema = z.array(builtInRuleStateSchema);
+/**
+ * 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 const networkPluginOutputSchema = z.object({ shipId: idSchema('ship'), registeredAt: z.iso.datetime() }).nullable();
 /** Output of `fleet.setNetworkRules`: the version the fleet's network settings have now. */
 export const setNetworkRulesOutputSchema = z.object({ version: z.int().min(1) });
 /** 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). */
@@ -53,18 +95,33 @@ export const registerNetworkPluginInputSchema = z.object({
     whileUnavailable: z.enum(WHILE_UNAVAILABLE),
     notRespondingAfterSeconds: z.int().min(NETWORK_PLUGIN_NOT_RESPONDING_AFTER_MIN_SECONDS).max(NETWORK_PLUGIN_NOT_RESPONDING_AFTER_MAX_SECONDS),
 });
-/** A ship as a reach refusal saw it: its id, its name and the label values it carried then. */
-const refusedShipSchema = z.object({ id: idSchema('ship'), name: z.string(), labels: z.array(carriedLabelSchema) });
-/** One refused send: who tried to reach whom, both ships as they were, the settings version that refused it and when. */
+/** A ship as a reach refusal saw it: its id, its name, the label values it carried then and its owner's ship then, none for argo and the viewer (decision 0045). */
+const refusedShipSchema = z.object({
+    id: idSchema('ship'),
+    name: z.string(),
+    labels: z.array(carriedLabelSchema),
+    owner: z.object({ id: idSchema('ship'), name: z.string() }).nullable(),
+});
+/**
+ * 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 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. */
 export const reachRefusalSchema = z.object({
     id: idSchema('reachRefusal'),
     at: z.iso.datetime(),
     sender: refusedShipSchema,
+    /** The plugin ship that read on behalf of the sender (decision 0034), as it was then; null for the sender's own call. */
+    askedBy: refusedShipSchema.nullable(),
     recipient: z.discriminatedUnion('kind', [
         z.object({ kind: z.literal('ship'), ship: refusedShipSchema }),
         /** A send to a type: the type and each ship of it, none of which the sender may reach. */
         z.object({ kind: z.literal('type'), type: z.string(), ships: z.array(refusedShipSchema) }),
     ]),
+    /** What the sender tried to do: send, the one verb checked so far. */
+    verb: z.enum(NETWORK_VERBS),
     settingsVersion: z.int().min(1),
     /** What the plugin declared for while it is unavailable, when it refused because the plugin was not responding (decision 0035); null otherwise. */
     whilePluginUnavailable: z.enum(['block-all', 'keep-latest']).nullable(),
@@ -73,6 +130,18 @@ export const reachRefusalSchema = z.object({
 export const reachRefusalsOutputSchema = z.array(reachRefusalSchema);
 /** Input of `fleet.explainReach` (argo only): the ship to explain from, and the one ship asked about, or none for every ship. */
 export const explainReachInputSchema = z.object({ fromShipId: idSchema('ship'), toShipId: idSchema('ship').optional() });
-/** Output of `fleet.explainReach`: the ships it reaches now, by id; never the rules or why (design on #260). */
-export const explainReachOutputSchema = z.object({ reachableShipIds: z.array(idSchema('ship')) });
+/**
+ * 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).
+ */
+export const reachRuleSchema = z.union([
+    z.object({ builtIn: z.enum(BUILT_IN_RULES) }),
+    z.object({ plugin: z.int().min(0) }),
+    z.object({ declared: idSchema('ship'), index: z.int().min(0) }),
+]);
+const reachedShipsSchema = z.array(z.object({ shipId: idSchema('ship'), rule: reachRuleSchema }));
+/** Output of `fleet.explainReach`: per verb, the ships it reaches now, each with the rule that allows it. */
+export const explainReachOutputSchema = z.object({ send: reachedShipsSchema, read: reachedShipsSchema, manage: reachedShipsSchema });
 //# sourceMappingURL=network.js.map

package/dist/schemas/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/schemas/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;GAMG;AAEH,wGAAwG;AACxG,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAY,CAAC;AAE5C,wGAAwG;AACxG,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAIlK,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;AAE/D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,mBAAmB,EAAE,CAAC,CAAC;AAIlG,wHAAwH;AACxH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAErG,4FAA4F;AAC5F,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEjF,uKAAuK;AACvK,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAE9F,mFAAmF;AACnF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEnF,kHAAkH;AAClH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC;AAEnI;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAInF,kIAAkI;AAClI,MAAM,CAAC,MAAM,+CAA+C,GAAG,EAAE,CAAC;AAElE,uBAAuB;AACvB,MAAM,CAAC,MAAM,+CAA+C,GAAG,MAAM,CAAC;AAEtE,oKAAoK;AACpK,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IAC3C,yBAAyB,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,GAAG,CAAC,+CAA+C,CAAC;CAC7I,CAAC,CAAC;AAIH,+FAA+F;AAC/F,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;AAEpH,yHAAyH;AACzH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,QAAQ,CAAC,cAAc,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IACpB,MAAM,EAAE,iBAAiB;IACzB,SAAS,EAAE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACtC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAC9D,0FAA0F;QAC1F,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;KAC3F,CAAC;IACF,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,mJAAmJ;IACnJ,sBAAsB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxE,CAAC,CAAC;AAIH,+HAA+H;AAC/H,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;AAErE,iIAAiI;AACjI,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEzH,gHAAgH;AAChH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/schemas/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;GAMG;AAEH,wGAAwG;AACxG,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAY,CAAC;AAE5C,wGAAwG;AACxG,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC;IACtB,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;IAC5F,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;CAC9F,CAAC,CAAC;AAUH,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,CAAC;AACrD,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;AAE/D,iGAAiG;AACjG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAIjE,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,mBAAmB,EAAE,CAAC,CAAC;AAI/H,yHAAyH;AACzH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAE1F;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,CAAU,CAAC;AAIvG,6CAA6C;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAA2C,CAAC;AAExH,mJAAmJ;AACnJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;KACnG,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,2DAA2D,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAIvK;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC5C,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IACtG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;CACtF,CAAC,CAAC;AAIH,sJAAsJ;AACtJ,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AAE3H,4FAA4F;AAC5F,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEjF,uKAAuK;AACvK,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAE9F,mFAAmF;AACnF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEnF,kHAAkH;AAClH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC;AAEnI;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAInF,kIAAkI;AAClI,MAAM,CAAC,MAAM,+CAA+C,GAAG,EAAE,CAAC;AAElE,uBAAuB;AACvB,MAAM,CAAC,MAAM,+CAA+C,GAAG,MAAM,CAAC;AAEtE,oKAAoK;AACpK,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IAC3C,yBAAyB,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,GAAG,CAAC,+CAA+C,CAAC;CAC7I,CAAC,CAAC;AAIH,oKAAoK;AACpK,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvE,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,yJAAyJ;AACzJ,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,QAAQ,CAAC,cAAc,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IACpB,MAAM,EAAE,iBAAiB;IACzB,yHAAyH;IACzH,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACtC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAC9D,0FAA0F;QAC1F,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;KAC3F,CAAC;IACF,sEAAsE;IACtE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;IAC3B,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,mJAAmJ;IACnJ,sBAAsB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxE,CAAC,CAAC;AAIH,+HAA+H;AAC/H,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;AAErE,iIAAiI;AACjI,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEzH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IACrC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;IAC7C,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;CAChE,CAAC,CAAC;AAIH,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;AAElG,6GAA6G;AAC7G,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC"}