@aws/nx-plugin 1.0.0 → 1.0.1

package/src/open-api/py-client/vessel-registry-spec.json

@@ -0,0 +1,2716 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "VesselRegistry",
+    "version": "0.1.0"
+  },
+  "paths": {
+    "/fleet/vessels": {
+      "get": {
+        "tags": ["fleet"],
+        "summary": "List registered vessels",
+        "operationId": "list_vessels",
+        "parameters": [
+          {
+            "name": "hull_class",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/HullClass"
+                  }
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Repeatable hull class filter",
+              "title": "Hull Class"
+            },
+            "description": "Repeatable hull class filter"
+          },
+          {
+            "name": "status",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "$ref": "#/components/schemas/VesselStatus"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Status"
+            }
+          },
+          {
+            "name": "min_cargo_tonnage",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0,
+              "title": "Min Cargo Tonnage"
+            }
+          },
+          {
+            "name": "home_port",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "pattern": "^[A-Z]{3}-\\d{1,2}$"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Home Port"
+            }
+          },
+          {
+            "name": "sort_by",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "$ref": "#/components/schemas/VesselSortKey",
+              "default": "call-sign"
+            }
+          },
+          {
+            "name": "descending",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "title": "Descending"
+            }
+          },
+          {
+            "name": "page_size",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "maximum": 200,
+              "minimum": 1,
+              "default": 25,
+              "title": "Page Size"
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Cursor"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/VesselPage"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "tags": ["fleet"],
+        "summary": "Commission a new vessel",
+        "operationId": "commission_vessel",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CommissionVesselRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Vessel"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/fleet/vessels/{vessel_id}": {
+      "get": {
+        "tags": ["fleet"],
+        "summary": "Fetch one vessel",
+        "operationId": "get_vessel",
+        "parameters": [
+          {
+            "name": "vessel_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "pattern": "^ves_[a-z0-9_]+$",
+              "title": "Vessel Id"
+            }
+          },
+          {
+            "name": "as_of",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "format": "date-time"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Read the registry as it stood at this instant",
+              "title": "As Of"
+            },
+            "description": "Read the registry as it stood at this instant"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Vessel"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": ["fleet"],
+        "summary": "Strike a vessel from the registry",
+        "operationId": "decommission_vessel",
+        "parameters": [
+          {
+            "name": "vessel_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "title": "Vessel Id"
+            }
+          },
+          {
+            "name": "scuttle",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "description": "Scuttle the hull rather than sell it on",
+              "default": false,
+              "title": "Scuttle"
+            },
+            "description": "Scuttle the hull rather than sell it on"
+          },
+          {
+            "name": "reason",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 3,
+              "maxLength": 256,
+              "default": "end of service life",
+              "title": "Reason"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Successful Response"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/fleet/vessels/{vessel_id}/status": {
+      "patch": {
+        "tags": ["fleet"],
+        "summary": "Amend a vessel's operational status",
+        "operationId": "update_vessel_status",
+        "parameters": [
+          {
+            "name": "vessel_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "title": "Vessel Id"
+            }
+          },
+          {
+            "name": "X-Dock-Authority",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "minLength": 4,
+              "maxLength": 64,
+              "title": "X-Dock-Authority"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/VesselStatusPatch"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Vessel"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/fleet/vessels/{vessel_id}/refuel": {
+      "post": {
+        "tags": ["fleet"],
+        "summary": "Take on propellant",
+        "operationId": "refuel_vessel",
+        "parameters": [
+          {
+            "name": "vessel_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "title": "Vessel Id"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RefuelRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RefuelReceipt"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/fleet/vessels/{vessel_id}/telemetry": {
+      "get": {
+        "tags": ["fleet"],
+        "summary": "Stream live telemetry frames",
+        "operationId": "stream_vessel_telemetry",
+        "parameters": [
+          {
+            "name": "vessel_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "title": "Vessel Id"
+            }
+          },
+          {
+            "name": "frames",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "maximum": 1000,
+              "minimum": 1,
+              "description": "Number of frames before the stream closes",
+              "default": 10,
+              "title": "Frames"
+            },
+            "description": "Number of frames before the stream closes"
+          },
+          {
+            "name": "interval_ms",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "maximum": 5000,
+              "minimum": 0,
+              "default": 250,
+              "title": "Interval Ms"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A JSON Lines stream of telemetry frames",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TelemetryFrame"
+                }
+              },
+              "application/jsonl": {
+                "itemSchema": {
+                  "$ref": "#/components/schemas/TelemetryFrame"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/ports": {
+      "get": {
+        "tags": ["ports"],
+        "summary": "List orbital ports",
+        "operationId": "list_ports",
+        "parameters": [
+          {
+            "name": "sector",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "maxLength": 64
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Sector"
+            }
+          },
+          {
+            "name": "max_gravity_well_g",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "number",
+              "maximum": 50,
+              "exclusiveMinimum": 0,
+              "default": 50,
+              "title": "Max Gravity Well G"
+            }
+          },
+          {
+            "name": "drydock_only",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "title": "Drydock Only"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Port"
+                  },
+                  "title": "Response List Ports"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/ports/{port_code}/berths": {
+      "get": {
+        "tags": ["ports"],
+        "summary": "List berths at a port",
+        "operationId": "list_berths",
+        "parameters": [
+          {
+            "name": "port_code",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "pattern": "^[A-Z]{3}-\\d{1,2}$",
+              "examples": ["SOL-3", "PRX-1"],
+              "title": "Port Code"
+            }
+          },
+          {
+            "name": "free_between",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "format": "date"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Start of the availability window",
+              "title": "Free Between"
+            },
+            "description": "Start of the availability window"
+          },
+          {
+            "name": "free_and",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "format": "date"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "End of the availability window",
+              "title": "Free And"
+            },
+            "description": "End of the availability window"
+          },
+          {
+            "name": "fits_tonnage",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0,
+              "title": "Fits Tonnage"
+            }
+          },
+          {
+            "name": "pressurised_only",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "title": "Pressurised Only"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Berth"
+                  },
+                  "title": "Response List Berths"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/ports/{port_code}/berths/reservations": {
+      "post": {
+        "tags": ["ports"],
+        "summary": "Reserve a berth",
+        "operationId": "reserve_berth",
+        "parameters": [
+          {
+            "name": "port_code",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "pattern": "^[A-Z]{3}-\\d{1,2}$",
+              "examples": ["SOL-3", "PRX-1"],
+              "title": "Port Code"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BerthReservationRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BerthReservation"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/ports/{port_code}/berths/reservations/{reservation_id}": {
+      "delete": {
+        "tags": ["ports"],
+        "summary": "Release a berth reservation",
+        "operationId": "cancel_berth_reservation",
+        "parameters": [
+          {
+            "name": "port_code",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "pattern": "^[A-Z]{3}-\\d{1,2}$",
+              "examples": ["SOL-3", "PRX-1"],
+              "title": "Port Code"
+            }
+          },
+          {
+            "name": "reservation_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "pattern": "^res_[a-z0-9]+$",
+              "title": "Reservation Id"
+            }
+          },
+          {
+            "name": "waive_penalty",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "title": "Waive Penalty"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Successful Response"
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/manifests": {
+      "get": {
+        "tags": ["manifests"],
+        "summary": "Search lodged manifests",
+        "operationId": "list_manifests",
+        "parameters": [
+          {
+            "name": "status",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ManifestStatus"
+                  }
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Repeatable status filter",
+              "title": "Status"
+            },
+            "description": "Repeatable status filter"
+          },
+          {
+            "name": "carrying",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/HazardClass"
+                  }
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Carrying"
+            }
+          },
+          {
+            "name": "lodged_after",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "format": "date-time"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Lodged After"
+            }
+          },
+          {
+            "name": "lodged_before",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "format": "date-time"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Lodged Before"
+            }
+          },
+          {
+            "name": "consignee_like",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 2,
+                  "maxLength": 128
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Consignee Like"
+            }
+          },
+          {
+            "name": "page_size",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "maximum": 100,
+              "minimum": 1,
+              "default": 20,
+              "title": "Page Size"
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Cursor"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ManifestPage"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "tags": ["manifests"],
+        "summary": "Lodge a draft manifest",
+        "operationId": "create_manifest",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ManifestUpsert"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Manifest"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/manifests/{manifest_id}": {
+      "get": {
+        "tags": ["manifests"],
+        "summary": "Fetch one manifest",
+        "operationId": "get_manifest",
+        "parameters": [
+          {
+            "name": "manifest_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "pattern": "^man_[a-z0-9]+$",
+              "title": "Manifest Id"
+            }
+          },
+          {
+            "name": "expand_lines",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "description": "Include line items; false returns the header only",
+              "default": true,
+              "title": "Expand Lines"
+            },
+            "description": "Include line items; false returns the header only"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Manifest"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": ["manifests"],
+        "summary": "Replace a draft manifest",
+        "operationId": "replace_manifest",
+        "parameters": [
+          {
+            "name": "manifest_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "title": "Manifest Id"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ManifestUpsert"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Manifest"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/manifests/{manifest_id}/seal": {
+      "post": {
+        "tags": ["manifests"],
+        "summary": "Seal a manifest for customs",
+        "operationId": "seal_manifest",
+        "parameters": [
+          {
+            "name": "manifest_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "title": "Manifest Id"
+            }
+          },
+          {
+            "name": "Idempotency-Key",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "maxLength": 128
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Idempotency-Key"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SealManifestRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Manifest"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/lanes/plot": {
+      "post": {
+        "tags": ["lanes"],
+        "summary": "Plot a jump lane between two ports",
+        "operationId": "plot_lane",
+        "parameters": [
+          {
+            "name": "objective",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "$ref": "#/components/schemas/PlotObjective",
+              "description": "What the plotter should optimise for",
+              "default": "fastest"
+            },
+            "description": "What the plotter should optimise for"
+          },
+          {
+            "name": "include_dwell",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": true,
+              "title": "Include Dwell"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PlotLaneRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PlottedLane"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/lanes/{lane_id}/hazards": {
+      "get": {
+        "tags": ["lanes"],
+        "summary": "List hazards reported on a lane",
+        "operationId": "list_lane_hazards",
+        "parameters": [
+          {
+            "name": "lane_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "pattern": "^lane_[a-z0-9]{6,}$",
+              "examples": ["lane_kuiper1"],
+              "title": "Lane Id"
+            }
+          },
+          {
+            "name": "at_least",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "$ref": "#/components/schemas/HazardSeverity",
+              "description": "Minimum severity to report",
+              "default": "nuisance"
+            },
+            "description": "Minimum severity to report"
+          },
+          {
+            "name": "include_expired",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "title": "Include Expired"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "maximum": 100,
+              "minimum": 1,
+              "default": 20,
+              "title": "Limit"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/LaneHazard"
+                  },
+                  "title": "Response List Lane Hazards"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/crew": {
+      "get": {
+        "tags": ["crew"],
+        "summary": "Search the crew roster",
+        "operationId": "search_crew",
+        "parameters": [
+          {
+            "name": "q",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 2,
+                  "maxLength": 128
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Free-text name search",
+              "title": "Q"
+            },
+            "description": "Free-text name search"
+          },
+          {
+            "name": "rank",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/CrewRank"
+                  }
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Rank"
+            }
+          },
+          {
+            "name": "certified_in",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "maxItems": 8
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Certified In"
+            }
+          },
+          {
+            "name": "unassigned_only",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "title": "Unassigned Only"
+            }
+          },
+          {
+            "name": "page_size",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "maximum": 100,
+              "minimum": 1,
+              "default": 25,
+              "title": "Page Size"
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Cursor"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CrewSearchResults"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/crew/{crew_id}/assignment": {
+      "patch": {
+        "tags": ["crew"],
+        "summary": "Reassign or promote a crew member",
+        "operationId": "amend_crew_assignment",
+        "parameters": [
+          {
+            "name": "crew_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "pattern": "^crw_[a-z0-9_]+$",
+              "title": "Crew Id"
+            }
+          },
+          {
+            "name": "effective_from",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "format": "date"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Effective From"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CrewAssignmentPatch"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CrewMember"
+                }
+              }
+            }
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorDetails"
+                }
+              }
+            },
+            "description": "Internal Server Error"
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "Berth": {
+        "properties": {
+          "berth_id": {
+            "type": "string",
+            "title": "Berth Id"
+          },
+          "port_code": {
+            "type": "string",
+            "title": "Port Code"
+          },
+          "max_tonnage": {
+            "type": "integer",
+            "title": "Max Tonnage"
+          },
+          "pressurised": {
+            "type": "boolean",
+            "title": "Pressurised"
+          },
+          "available_from": {
+            "type": "string",
+            "format": "date",
+            "title": "Available From"
+          },
+          "available_until": {
+            "type": "string",
+            "format": "date",
+            "title": "Available Until"
+          }
+        },
+        "type": "object",
+        "required": [
+          "berth_id",
+          "port_code",
+          "max_tonnage",
+          "pressurised",
+          "available_from",
+          "available_until"
+        ],
+        "title": "Berth"
+      },
+      "BerthReservation": {
+        "properties": {
+          "reservation_id": {
+            "type": "string",
+            "title": "Reservation Id"
+          },
+          "port_code": {
+            "type": "string",
+            "title": "Port Code"
+          },
+          "berth_id": {
+            "type": "string",
+            "title": "Berth Id"
+          },
+          "vessel_id": {
+            "type": "string",
+            "title": "Vessel Id"
+          },
+          "arrival": {
+            "type": "string",
+            "format": "date",
+            "title": "Arrival"
+          },
+          "departure": {
+            "type": "string",
+            "format": "date",
+            "title": "Departure"
+          },
+          "mooring_fee_credits": {
+            "type": "number",
+            "title": "Mooring Fee Credits"
+          }
+        },
+        "type": "object",
+        "required": [
+          "reservation_id",
+          "port_code",
+          "berth_id",
+          "vessel_id",
+          "arrival",
+          "departure",
+          "mooring_fee_credits"
+        ],
+        "title": "BerthReservation"
+      },
+      "BerthReservationRequest": {
+        "properties": {
+          "vessel_id": {
+            "type": "string",
+            "title": "Vessel Id"
+          },
+          "berth_id": {
+            "type": "string",
+            "title": "Berth Id"
+          },
+          "arrival": {
+            "type": "string",
+            "format": "date",
+            "title": "Arrival"
+          },
+          "departure": {
+            "type": "string",
+            "format": "date",
+            "title": "Departure"
+          },
+          "requires_pressurised": {
+            "type": "boolean",
+            "title": "Requires Pressurised",
+            "default": false
+          }
+        },
+        "type": "object",
+        "required": ["vessel_id", "berth_id", "arrival", "departure"],
+        "title": "BerthReservationRequest"
+      },
+      "CommissionVesselRequest": {
+        "properties": {
+          "call_sign": {
+            "type": "string",
+            "maxLength": 32,
+            "minLength": 3,
+            "title": "Call Sign"
+          },
+          "hull_class": {
+            "$ref": "#/components/schemas/HullClass"
+          },
+          "cargo_tonnage": {
+            "type": "integer",
+            "maximum": 2000000.0,
+            "minimum": 0.0,
+            "title": "Cargo Tonnage"
+          },
+          "home_port": {
+            "type": "string",
+            "pattern": "^[A-Z]{3}-\\d{1,2}$",
+            "title": "Home Port"
+          },
+          "registry_notes": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 512
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Registry Notes"
+          }
+        },
+        "type": "object",
+        "required": ["call_sign", "hull_class", "cargo_tonnage", "home_port"],
+        "title": "CommissionVesselRequest"
+      },
+      "CrewAssignmentPatch": {
+        "properties": {
+          "assigned_vessel_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Assigned Vessel Id"
+          },
+          "rank": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/CrewRank"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object",
+        "title": "CrewAssignmentPatch"
+      },
+      "CrewMember": {
+        "properties": {
+          "crew_id": {
+            "type": "string",
+            "title": "Crew Id"
+          },
+          "name": {
+            "type": "string",
+            "title": "Name"
+          },
+          "rank": {
+            "$ref": "#/components/schemas/CrewRank"
+          },
+          "certifications": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array",
+            "title": "Certifications"
+          },
+          "assigned_vessel_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Assigned Vessel Id"
+          }
+        },
+        "type": "object",
+        "required": ["crew_id", "name", "rank", "certifications"],
+        "title": "CrewMember"
+      },
+      "CrewRank": {
+        "type": "string",
+        "enum": ["deckhand", "navigator", "quartermaster", "master"],
+        "title": "CrewRank"
+      },
+      "CrewSearchResults": {
+        "properties": {
+          "crew": {
+            "items": {
+              "$ref": "#/components/schemas/CrewMember"
+            },
+            "type": "array",
+            "title": "Crew"
+          },
+          "next_cursor": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Next Cursor"
+          }
+        },
+        "type": "object",
+        "required": ["crew"],
+        "title": "CrewSearchResults"
+      },
+      "HTTPValidationError": {
+        "properties": {
+          "detail": {
+            "items": {
+              "$ref": "#/components/schemas/ValidationError"
+            },
+            "type": "array",
+            "title": "Detail"
+          }
+        },
+        "type": "object",
+        "title": "HTTPValidationError"
+      },
+      "HazardClass": {
+        "type": "string",
+        "enum": ["inert", "cryogenic", "fissile", "bioactive", "sentient"],
+        "title": "HazardClass"
+      },
+      "HazardSeverity": {
+        "type": "string",
+        "enum": ["nuisance", "notable", "severe", "lane-closing"],
+        "title": "HazardSeverity"
+      },
+      "HullClass": {
+        "type": "string",
+        "enum": ["skiff", "hauler", "bulk-freighter", "ore-barge"],
+        "title": "HullClass"
+      },
+      "InternalServerErrorDetails": {
+        "properties": {
+          "detail": {
+            "type": "string",
+            "title": "Detail"
+          }
+        },
+        "type": "object",
+        "required": ["detail"],
+        "title": "InternalServerErrorDetails"
+      },
+      "LaneHazard": {
+        "properties": {
+          "hazard_id": {
+            "type": "string",
+            "title": "Hazard Id"
+          },
+          "lane_id": {
+            "type": "string",
+            "title": "Lane Id"
+          },
+          "kind": {
+            "type": "string",
+            "title": "Kind"
+          },
+          "severity": {
+            "$ref": "#/components/schemas/HazardSeverity"
+          },
+          "reported_at": {
+            "type": "string",
+            "format": "date-time",
+            "title": "Reported At"
+          },
+          "expires_at": {
+            "anyOf": [
+              {
+                "type": "string",
+                "format": "date-time"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Expires At"
+          }
+        },
+        "type": "object",
+        "required": ["hazard_id", "lane_id", "kind", "severity", "reported_at"],
+        "title": "LaneHazard"
+      },
+      "LaneWaypoint": {
+        "properties": {
+          "port_code": {
+            "type": "string",
+            "pattern": "^[A-Z]{3}-\\d{1,2}$",
+            "title": "Port Code"
+          },
+          "dwell_hours": {
+            "type": "number",
+            "maximum": 720.0,
+            "minimum": 0.0,
+            "title": "Dwell Hours",
+            "default": 0
+          }
+        },
+        "type": "object",
+        "required": ["port_code"],
+        "title": "LaneWaypoint"
+      },
+      "Manifest": {
+        "properties": {
+          "manifest_id": {
+            "type": "string",
+            "title": "Manifest Id"
+          },
+          "status": {
+            "$ref": "#/components/schemas/ManifestStatus"
+          },
+          "consignor": {
+            "type": "string",
+            "title": "Consignor"
+          },
+          "consignee": {
+            "type": "string",
+            "title": "Consignee"
+          },
+          "origin_port": {
+            "type": "string",
+            "title": "Origin Port"
+          },
+          "destination_port": {
+            "type": "string",
+            "title": "Destination Port"
+          },
+          "lines": {
+            "items": {
+              "$ref": "#/components/schemas/ManifestLine"
+            },
+            "type": "array",
+            "title": "Lines"
+          },
+          "declared_value_credits": {
+            "type": "number",
+            "title": "Declared Value Credits"
+          },
+          "total_tonnage": {
+            "type": "number",
+            "title": "Total Tonnage"
+          },
+          "lodged_at": {
+            "type": "string",
+            "format": "date-time",
+            "title": "Lodged At"
+          },
+          "seal_hash": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Seal Hash"
+          }
+        },
+        "type": "object",
+        "required": [
+          "manifest_id",
+          "status",
+          "consignor",
+          "consignee",
+          "origin_port",
+          "destination_port",
+          "lines",
+          "declared_value_credits",
+          "total_tonnage",
+          "lodged_at"
+        ],
+        "title": "Manifest"
+      },
+      "ManifestLine": {
+        "properties": {
+          "sku": {
+            "type": "string",
+            "maxLength": 64,
+            "minLength": 1,
+            "title": "Sku"
+          },
+          "description": {
+            "type": "string",
+            "maxLength": 256,
+            "title": "Description"
+          },
+          "tonnage": {
+            "type": "number",
+            "exclusiveMinimum": 0.0,
+            "title": "Tonnage"
+          },
+          "hazard_class": {
+            "$ref": "#/components/schemas/HazardClass",
+            "default": "inert"
+          }
+        },
+        "type": "object",
+        "required": ["sku", "description", "tonnage"],
+        "title": "ManifestLine"
+      },
+      "ManifestPage": {
+        "properties": {
+          "manifests": {
+            "items": {
+              "$ref": "#/components/schemas/Manifest"
+            },
+            "type": "array",
+            "title": "Manifests"
+          },
+          "next_cursor": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Next Cursor"
+          }
+        },
+        "type": "object",
+        "required": ["manifests"],
+        "title": "ManifestPage"
+      },
+      "ManifestStatus": {
+        "type": "string",
+        "enum": ["draft", "sealed", "in-transit", "delivered", "quarantined"],
+        "title": "ManifestStatus"
+      },
+      "ManifestUpsert": {
+        "properties": {
+          "consignor": {
+            "type": "string",
+            "maxLength": 128,
+            "minLength": 1,
+            "title": "Consignor"
+          },
+          "consignee": {
+            "type": "string",
+            "maxLength": 128,
+            "minLength": 1,
+            "title": "Consignee"
+          },
+          "origin_port": {
+            "type": "string",
+            "pattern": "^[A-Z]{3}-\\d{1,2}$",
+            "title": "Origin Port"
+          },
+          "destination_port": {
+            "type": "string",
+            "pattern": "^[A-Z]{3}-\\d{1,2}$",
+            "title": "Destination Port"
+          },
+          "lines": {
+            "items": {
+              "$ref": "#/components/schemas/ManifestLine"
+            },
+            "type": "array",
+            "maxItems": 500,
+            "minItems": 1,
+            "title": "Lines"
+          },
+          "declared_value_credits": {
+            "type": "number",
+            "minimum": 0.0,
+            "title": "Declared Value Credits"
+          }
+        },
+        "type": "object",
+        "required": [
+          "consignor",
+          "consignee",
+          "origin_port",
+          "destination_port",
+          "lines",
+          "declared_value_credits"
+        ],
+        "title": "ManifestUpsert"
+      },
+      "PlotLaneRequest": {
+        "properties": {
+          "origin": {
+            "type": "string",
+            "pattern": "^[A-Z]{3}-\\d{1,2}$",
+            "title": "Origin"
+          },
+          "destination": {
+            "type": "string",
+            "pattern": "^[A-Z]{3}-\\d{1,2}$",
+            "title": "Destination"
+          },
+          "via": {
+            "items": {
+              "$ref": "#/components/schemas/LaneWaypoint"
+            },
+            "type": "array",
+            "maxItems": 12,
+            "title": "Via"
+          },
+          "max_hazard": {
+            "$ref": "#/components/schemas/HazardSeverity",
+            "default": "notable"
+          }
+        },
+        "type": "object",
+        "required": ["origin", "destination"],
+        "title": "PlotLaneRequest"
+      },
+      "PlotObjective": {
+        "type": "string",
+        "enum": ["fastest", "cheapest", "safest"],
+        "title": "PlotObjective"
+      },
+      "PlottedLane": {
+        "properties": {
+          "lane_id": {
+            "type": "string",
+            "title": "Lane Id"
+          },
+          "objective": {
+            "$ref": "#/components/schemas/PlotObjective"
+          },
+          "legs": {
+            "items": {
+              "$ref": "#/components/schemas/PlottedLeg"
+            },
+            "type": "array",
+            "title": "Legs"
+          },
+          "total_hours": {
+            "type": "number",
+            "title": "Total Hours"
+          },
+          "total_fuel_litres": {
+            "type": "number",
+            "title": "Total Fuel Litres"
+          }
+        },
+        "type": "object",
+        "required": [
+          "lane_id",
+          "objective",
+          "legs",
+          "total_hours",
+          "total_fuel_litres"
+        ],
+        "title": "PlottedLane"
+      },
+      "PlottedLeg": {
+        "properties": {
+          "from_port": {
+            "type": "string",
+            "title": "From Port"
+          },
+          "to_port": {
+            "type": "string",
+            "title": "To Port"
+          },
+          "jump_distance_parsecs": {
+            "type": "number",
+            "title": "Jump Distance Parsecs"
+          },
+          "estimated_hours": {
+            "type": "number",
+            "title": "Estimated Hours"
+          }
+        },
+        "type": "object",
+        "required": [
+          "from_port",
+          "to_port",
+          "jump_distance_parsecs",
+          "estimated_hours"
+        ],
+        "title": "PlottedLeg"
+      },
+      "Port": {
+        "properties": {
+          "port_code": {
+            "type": "string",
+            "title": "Port Code"
+          },
+          "name": {
+            "type": "string",
+            "title": "Name"
+          },
+          "sector": {
+            "type": "string",
+            "title": "Sector"
+          },
+          "gravity_well_g": {
+            "type": "number",
+            "title": "Gravity Well G"
+          },
+          "has_drydock": {
+            "type": "boolean",
+            "title": "Has Drydock"
+          },
+          "berth_count": {
+            "type": "integer",
+            "title": "Berth Count"
+          }
+        },
+        "type": "object",
+        "required": [
+          "port_code",
+          "name",
+          "sector",
+          "gravity_well_g",
+          "has_drydock",
+          "berth_count"
+        ],
+        "title": "Port"
+      },
+      "ProblemDetails": {
+        "properties": {
+          "detail": {
+            "type": "string",
+            "title": "Detail"
+          }
+        },
+        "type": "object",
+        "required": ["detail"],
+        "title": "ProblemDetails"
+      },
+      "Propellant": {
+        "type": "string",
+        "enum": ["deuterium-slush", "helium-3", "ion-paste"],
+        "title": "Propellant"
+      },
+      "RefuelReceipt": {
+        "properties": {
+          "vessel_id": {
+            "type": "string",
+            "title": "Vessel Id"
+          },
+          "propellant": {
+            "$ref": "#/components/schemas/Propellant"
+          },
+          "litres_loaded": {
+            "type": "number",
+            "title": "Litres Loaded"
+          },
+          "tank_pressure_kpa": {
+            "type": "number",
+            "title": "Tank Pressure Kpa"
+          },
+          "credits_charged": {
+            "type": "number",
+            "title": "Credits Charged"
+          }
+        },
+        "type": "object",
+        "required": [
+          "vessel_id",
+          "propellant",
+          "litres_loaded",
+          "tank_pressure_kpa",
+          "credits_charged"
+        ],
+        "title": "RefuelReceipt"
+      },
+      "RefuelRequest": {
+        "properties": {
+          "propellant": {
+            "$ref": "#/components/schemas/Propellant"
+          },
+          "litres": {
+            "type": "number",
+            "maximum": 4000000.0,
+            "exclusiveMinimum": 0.0,
+            "title": "Litres"
+          },
+          "top_up_only": {
+            "type": "boolean",
+            "title": "Top Up Only",
+            "default": false
+          }
+        },
+        "type": "object",
+        "required": ["propellant", "litres"],
+        "title": "RefuelRequest"
+      },
+      "SealManifestRequest": {
+        "properties": {
+          "sealed_by": {
+            "type": "string",
+            "maxLength": 128,
+            "minLength": 1,
+            "title": "Sealed By"
+          },
+          "customs_declaration": {
+            "type": "string",
+            "maxLength": 1024,
+            "title": "Customs Declaration"
+          }
+        },
+        "type": "object",
+        "required": ["sealed_by", "customs_declaration"],
+        "title": "SealManifestRequest"
+      },
+      "TelemetryFrame": {
+        "properties": {
+          "vessel_id": {
+            "type": "string",
+            "title": "Vessel Id"
+          },
+          "sequence": {
+            "type": "integer",
+            "title": "Sequence"
+          },
+          "captured_at": {
+            "type": "string",
+            "format": "date-time",
+            "title": "Captured At"
+          },
+          "hull_temp_kelvin": {
+            "type": "number",
+            "title": "Hull Temp Kelvin"
+          },
+          "reactor_output_mw": {
+            "type": "number",
+            "title": "Reactor Output Mw"
+          },
+          "drift_metres_per_second": {
+            "type": "number",
+            "title": "Drift Metres Per Second"
+          }
+        },
+        "type": "object",
+        "required": [
+          "vessel_id",
+          "sequence",
+          "captured_at",
+          "hull_temp_kelvin",
+          "reactor_output_mw",
+          "drift_metres_per_second"
+        ],
+        "title": "TelemetryFrame"
+      },
+      "ValidationError": {
+        "properties": {
+          "loc": {
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "integer"
+                }
+              ]
+            },
+            "type": "array",
+            "title": "Location"
+          },
+          "msg": {
+            "type": "string",
+            "title": "Message"
+          },
+          "type": {
+            "type": "string",
+            "title": "Error Type"
+          },
+          "input": {
+            "title": "Input"
+          },
+          "ctx": {
+            "type": "object",
+            "title": "Context"
+          }
+        },
+        "type": "object",
+        "required": ["loc", "msg", "type"],
+        "title": "ValidationError"
+      },
+      "Vessel": {
+        "properties": {
+          "vessel_id": {
+            "type": "string",
+            "title": "Vessel Id"
+          },
+          "call_sign": {
+            "type": "string",
+            "maxLength": 32,
+            "minLength": 3,
+            "title": "Call Sign"
+          },
+          "hull_class": {
+            "$ref": "#/components/schemas/HullClass"
+          },
+          "cargo_tonnage": {
+            "type": "integer",
+            "maximum": 2000000.0,
+            "minimum": 0.0,
+            "title": "Cargo Tonnage"
+          },
+          "status": {
+            "$ref": "#/components/schemas/VesselStatus"
+          },
+          "home_port": {
+            "type": "string",
+            "title": "Home Port"
+          },
+          "last_seen_at": {
+            "type": "string",
+            "format": "date-time",
+            "title": "Last Seen At"
+          }
+        },
+        "type": "object",
+        "required": [
+          "vessel_id",
+          "call_sign",
+          "hull_class",
+          "cargo_tonnage",
+          "status",
+          "home_port",
+          "last_seen_at"
+        ],
+        "title": "Vessel"
+      },
+      "VesselPage": {
+        "properties": {
+          "vessels": {
+            "items": {
+              "$ref": "#/components/schemas/Vessel"
+            },
+            "type": "array",
+            "title": "Vessels"
+          },
+          "next_cursor": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Next Cursor"
+          },
+          "total_matched": {
+            "type": "integer",
+            "title": "Total Matched"
+          }
+        },
+        "type": "object",
+        "required": ["vessels", "total_matched"],
+        "title": "VesselPage"
+      },
+      "VesselSortKey": {
+        "type": "string",
+        "enum": ["call-sign", "tonnage", "last-seen"],
+        "title": "VesselSortKey"
+      },
+      "VesselStatus": {
+        "type": "string",
+        "enum": [
+          "in-drydock",
+          "berthed",
+          "under-way",
+          "impounded",
+          "lost-with-all-hands"
+        ],
+        "title": "VesselStatus"
+      },
+      "VesselStatusPatch": {
+        "properties": {
+          "status": {
+            "$ref": "#/components/schemas/VesselStatus"
+          },
+          "reason": {
+            "type": "string",
+            "maxLength": 256,
+            "minLength": 3,
+            "title": "Reason"
+          }
+        },
+        "type": "object",
+        "required": ["status", "reason"],
+        "title": "VesselStatusPatch"
+      }
+    }
+  }
+}