@lansweeper/discovery-sensor-proto 2.85.0 → 2.87.0

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@lansweeper/discovery-sensor-proto",
   "description": "Discovery Sensor proto",
-  "version": "2.85.0",
+  "version": "2.87.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Lansweeper/lansweeperapis.git"
+  },
   "main": "gen-proto/index.js",
   "types": "gen-proto/index.d.ts",
   "license": "MIT",
@@ -16,9 +20,6 @@
   "devDependencies": {
     "@types/google-protobuf": "^3.15.5"
   },
-  "gitHead": "1828c26f6786872e548236aed86b30c8c3c5f07b",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Lansweeper/lansweeperapis.git"
+  "publishConfig": {
   }
-}
+}

package/proto/discovery_sections_other.proto

@@ -46,6 +46,18 @@ message Snmp {
   
   google.protobuf.StringValue processor_architecture = 27;
   google.protobuf.UInt64Value total_memory = 28;
+
+  /* Stack/chassis discovery for stacked switches.
+   * Populated by SnmpStackScanner when device responds to vendor-specific
+   * (Cisco StackWise, HP/Aruba VSF, Juniper VC) or generic (STACK-MIB, ENTITY-MIB) OIDs.
+   * Null when device is not stacked. */
+  SnmpStackInfo stack_info = 29;
+
+  /* Chassis module inventory for modular chassis switches (e.g. Cisco Catalyst 9400,
+   * Nexus 9500, HP/Aruba modular, Juniper EX/MX). Populated by SnmpChassisModuleScanner
+   * via ENTITY-MIB (RFC 6933) entPhysicalTable containment hierarchy.
+   * Null when device has no discoverable chassis modules. */
+  SnmpBusConfigData chassis_info = 30;
 }
 
 message SnmpCustomOid {
@@ -118,6 +130,72 @@ message SnmpArpEntry {
   google.protobuf.UInt32Value mapping_type = 5; // other(1), invalid(2), dynamic(3), static(4)
 }
 
+/* Stack/chassis info for multi-member switch stacks.
+ * Discovered via Cisco StackWise MIB, HP/Aruba VSF MIB, Juniper Virtual Chassis MIB,
+ * a legacy OID tree at 1.3.6.1.2.1.105 (kept only as an opportunistic probe — not a
+ * real IETF stack MIB), or ENTITY-MIB (RFC 6933) entPhysicalClass=chassis(3)/stack(11)
+ * as the standards-based fallback. */
+message SnmpStackInfo {
+  repeated SnmpStackMember members = 1;
+  SnmpStackProtocol protocol = 2;
+}
+
+message SnmpStackMember {
+  google.protobuf.Int32Value member_id = 1;
+  SnmpStackRole role = 2;
+  google.protobuf.StringValue mac_address = 3;
+  google.protobuf.StringValue serial_number = 4;
+  google.protobuf.StringValue model = 5;
+  google.protobuf.StringValue description = 6;
+  google.protobuf.Int32Value priority = 7;
+  SnmpStackMemberState state = 8;
+  /* Running firmware / software image identifier. Populated from
+   * cswSwitchSoftwareImage (Cisco) and jnxVirtualChassisMemberSoftwareVersion
+   * (Juniper). Not exposed by HP-VSF-VC-MIB or ENTITY-MIB. */
+  google.protobuf.StringValue software_image = 9;
+  /* ENTITY-MIB (RFC 6933) entPhysicalIndex of the member's chassis entry.
+   * Authoritative when the scanner used the ENTITY_MIB fallback (member_id
+   * is then derived from this index). Also populated on vendor-discovered
+   * members when the scanner was able to join the vendor stack row to the
+   * corresponding chassis entity, making the per-member identity stable
+   * across rediscoveries and debuggable against raw SNMP walks. */
+  google.protobuf.Int32Value ent_physical_index = 10;
+}
+
+enum SnmpStackProtocol {
+  SNMP_STACK_PROTOCOL_UNKNOWN = 0;
+  SNMP_STACK_PROTOCOL_CISCO_STACKWISE = 1;
+  SNMP_STACK_PROTOCOL_HP_VSF = 2;
+  SNMP_STACK_PROTOCOL_JUNIPER_VC = 3;
+  /* Legacy opportunistic probe at 1.3.6.1.2.1.105 (not an IETF standard). */
+  SNMP_STACK_PROTOCOL_GENERIC_STACK_MIB = 4;
+  /* Standards-based fallback: ENTITY-MIB (RFC 6933) entPhysicalClass chassis/stack. */
+  SNMP_STACK_PROTOCOL_ENTITY_MIB = 5;
+}
+
+enum SnmpStackRole {
+  SNMP_STACK_ROLE_UNKNOWN = 0;
+  SNMP_STACK_ROLE_MASTER = 1;
+  SNMP_STACK_ROLE_MEMBER = 2;
+  SNMP_STACK_ROLE_STANDBY = 3;
+}
+
+/* State of a stack member. Specific mismatch values are populated when the
+ * scanner can distinguish the cause (Cisco cswSwitchState values 5/6/7/11);
+ * DEGRADED remains as a generic bucket for devices that only report a
+ * coarse "unhealthy" signal. */
+enum SnmpStackMemberState {
+  SNMP_STACK_MEMBER_STATE_UNKNOWN = 0;
+  SNMP_STACK_MEMBER_STATE_READY = 1;
+  SNMP_STACK_MEMBER_STATE_NOT_READY = 2;
+  SNMP_STACK_MEMBER_STATE_PROVISIONING = 3;
+  SNMP_STACK_MEMBER_STATE_DEGRADED = 4;
+  SNMP_STACK_MEMBER_STATE_VERSION_MISMATCH = 5;
+  SNMP_STACK_MEMBER_STATE_FEATURE_MISMATCH = 6;
+  SNMP_STACK_MEMBER_STATE_SDM_MISMATCH = 7;
+  SNMP_STACK_MEMBER_STATE_REMOVED = 8;
+}
+
 /* Warranty API scanning root object */
 message Warranties {
   repeated Warranty entries = 1;
@@ -130,4 +208,43 @@ message Warranty {
   google.protobuf.StringValue service_type = 3;
   google.protobuf.StringValue purchase_country = 4;
   optional google.protobuf.Timestamp ship_date = 5;
-}
+}
+
+/* Chassis module inventory via ENTITY-MIB (RFC 6933) entPhysicalTable.
+ * Mirrors the OT BusConfigData/ModuleData contract shape for consistency
+ * across IT and OT scanning pipelines. */
+message SnmpBusConfigData {
+  repeated SnmpBusConfig entries = 1;
+}
+
+message SnmpBusConfig {
+  uint32 index = 1;
+  google.protobuf.StringValue name = 2;
+  uint32 max_size = 3;
+  repeated SnmpModuleData modules = 4;
+  google.protobuf.StringValue type = 5;
+  uint32 module_start_index = 6;
+}
+
+message SnmpModuleData {
+  string component_type = 1;
+  google.protobuf.StringValue name = 2;
+  google.protobuf.StringValue mac = 3;
+  google.protobuf.StringValue manufacturer = 4;
+  google.protobuf.StringValue serial_number = 5;
+  google.protobuf.StringValue model = 6;
+  google.protobuf.StringValue firmware = 7;
+  google.protobuf.StringValue part_number = 8;
+  google.protobuf.Int32Value position_in_bus_config = 9;
+  google.protobuf.UInt32Value width = 10;
+  repeated SnmpModuleExtendedInformation extended_information = 11;
+  repeated SnmpBusConfig bus_config = 12;
+  reserved 13;
+  reserved "firmware_history";
+  google.protobuf.StringValue route_path = 14;
+}
+
+message SnmpModuleExtendedInformation {
+  string key = 1;
+  string value = 2;
+}

package/proto/discovery_sections_windows.proto

@@ -1000,6 +1000,126 @@ message HyperV {
   google.protobuf.StringValue name = 4;
 }
 
+/* Section element for Hyper-V guest network adapter configuration on Windows.
+ * Source: Msvm_GuestNetworkAdapterConfiguration (per-adapter guest network config).
+ * Replaces deprecated KVP keys (NetworkAddressIPv4, NetworkAddressIPv6, RDPAddressIPv4, RDPAddressIPv6). */
+message WindowsHyperVGuestNetwork {
+  repeated HyperVGuestNetworkAdapter entries = 1;
+}
+
+message HyperVGuestNetworkAdapter {
+  google.protobuf.StringValue instance_id = 1;
+  google.protobuf.BoolValue dhcp_enabled = 2;
+  repeated string ip_addresses = 3;
+  repeated string subnets = 4;
+  repeated string default_gateways = 5;
+  repeated string dns_servers = 6;
+  /* Protocol interface type per IANA IfType — discriminates IPv4 (4096) from
+   * IPv6 (4097). Needed to disambiguate which protocol family the adapter
+   * entry represents when a single guest NIC has both v4 and v6 config. */
+  google.protobuf.UInt32Value protocol_if_type = 7;
+  /* Per-IP-address origin code (static, DHCP, etc.); parallel-indexed with
+   * ip_addresses. Values per CIM IPAddressOrigin enum. */
+  repeated uint32 ip_address_origins = 8;
+}
+
+/* Section element for Hyper-V VM settings on Windows.
+ * Source: Msvm_VirtualSystemSettingData (realized VMs only, excludes snapshots).
+ * Contains VM identity, generation, BIOS info, and cluster invariant ID for live migration tracking. */
+message WindowsHyperVSettings {
+  repeated HyperVSettings entries = 1;
+}
+
+message HyperVSettings {
+  google.protobuf.StringValue virtual_system_identifier = 1;
+  google.protobuf.StringValue element_name = 2;
+  google.protobuf.StringValue virtual_system_sub_type = 3;
+  google.protobuf.StringValue version = 4;
+  google.protobuf.StringValue creation_time = 5;
+  repeated string notes = 6;
+  google.protobuf.StringValue bios_serial_number = 7;
+  google.protobuf.StringValue bios_guid = 8;
+  google.protobuf.StringValue cluster_invariant_id = 9;
+  /* Additional asset-identification fields from Msvm_VirtualSystemSettingData.
+   * Useful for matching VM inventory against chassis/asset records. */
+  google.protobuf.StringValue base_board_serial_number = 10;
+  google.protobuf.StringValue chassis_serial_number = 11;
+  google.protobuf.StringValue chassis_asset_tag = 12;
+  /* Full virtualization type descriptor (e.g. "Microsoft:Hyper-V:System:Realized").
+   * Sensor already filters to realized VMs in the query, but retaining the raw
+   * value lets consumers distinguish realized/snapshot/planned if the filter
+   * is ever relaxed. */
+  google.protobuf.StringValue virtual_system_type = 13;
+}
+
+/* Section element for Hyper-V guest KVP (Key-Value Pair) exchange data on Windows.
+ * Source: Msvm_KvpExchangeComponent (GuestIntrinsicExchangeItems from Integration Services).
+ * Deprecated network address keys (NetworkAddressIPv4/IPv6, RDPAddressIPv4/IPv6) are filtered out.
+ *
+ * Field set is driven by what Hyper-V hosts empirically emit, not by the
+ * Microsoft public documentation (which is incomplete) nor the Linux
+ * hv_kvp_daemon source (which describes one specific daemon but not what
+ * the host ultimately surfaces for every guest type):
+ *
+ *   Windows guests (OSPlatformId=2) populate fields 2-18 — including
+ *   os_signature and os_vendor which are emitted by Windows Server 2019
+ *   and later but not listed in public docs.
+ *
+ *   Linux guests (OSPlatformId=129) are observed to populate a distinct
+ *   subset: os_platform_id plus fields 19-21 (os_distribution_name,
+ *   os_distribution_data, os_kernel_version) — and NOT the
+ *   os_name/os_version/etc. fields that hv_kvp_daemon's AUTO pool
+ *   theoretically emits. Other Linux guest integrations may emit
+ *   different key combinations. */
+message WindowsHyperVKvp {
+  repeated HyperVKvpEntry entries = 1;
+}
+
+message HyperVKvpEntry {
+  string system_name = 1;
+  // Windows guest fields (OSPlatformId = 2)
+  google.protobuf.StringValue os_name = 2;
+  google.protobuf.StringValue os_version = 3;
+  google.protobuf.StringValue os_build_number = 4;
+  google.protobuf.StringValue os_major_version = 5;
+  google.protobuf.StringValue os_minor_version = 6;
+  google.protobuf.StringValue os_edition_id = 7;
+  google.protobuf.StringValue os_platform_id = 8;
+  google.protobuf.StringValue os_signature = 9;
+  google.protobuf.StringValue os_vendor = 10;
+  google.protobuf.StringValue product_type = 11;
+  google.protobuf.StringValue suite_mask = 12;
+  google.protobuf.StringValue processor_architecture = 13;
+  google.protobuf.StringValue csd_version = 14;
+  google.protobuf.StringValue service_pack_major = 15;
+  google.protobuf.StringValue service_pack_minor = 16;
+  google.protobuf.StringValue fully_qualified_domain_name = 17;
+  google.protobuf.StringValue integration_services_version = 18;
+  // Linux guest fields (OSPlatformId = 129) — observed on real scans,
+  // distinct from the Windows key set.
+  google.protobuf.StringValue os_distribution_name = 19;
+  google.protobuf.StringValue os_distribution_data = 20;
+  google.protobuf.StringValue os_kernel_version = 21;
+}
+
+/* Section element for Hyper-V VM processor allocation on Windows.
+ * Source: Msvm_ProcessorSettingData (per-VM CPU settings, definition entries filtered). */
+message WindowsHyperVProcessor {
+  repeated HyperVProcessorEntry entries = 1;
+}
+
+message HyperVProcessorEntry {
+  google.protobuf.StringValue instance_id = 1;
+  google.protobuf.UInt32Value virtual_quantity = 2;
+  google.protobuf.UInt32Value reservation = 3;
+  google.protobuf.UInt32Value limit = 4;
+  /* Relative scheduling priority vs other VMs; default 100. */
+  google.protobuf.UInt32Value weight = 5;
+  /* True when CPU features are limited for live-migration compatibility across
+   * hosts with different processor generations. */
+  google.protobuf.BoolValue limit_processor_features = 6;
+}
+
 /* Section element for hard disks on Windows */
 message WindowsHardDisk {
   repeated HardDisk entries = 1;