changedOutput schema / (root)
Previous value: -nullNew value: +{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "additionalProperties": false,
+ "properties": {
+ "data": {
+ "additionalProperties": {},
+ "description": "Catalog search result payload.",
+ "properties": {
+ "blueprints": {
+ "description": "Matching hardware blueprint summary records.",
+ "items": {
+ "additionalProperties": {},
+ "description": "Compact hardware blueprint summary returned by search_catalog.",
+ "properties": {
+ "category": {
+ "description": "Primary functional category of the hardware unit.",
+ "enum": [
+ "switch",
+ "router",
+ "compute-node",
+ "mini-pc",
+ "sbc",
+ "nas",
+ "patch-panel",
+ "pdu",
+ "ups",
+ "modular-carrier",
+ "brush-panel",
+ "blanking-panel",
+ "blank-panel",
+ "shelf",
+ "keystone-module"
+ ],
+ "type": "string"
+ },
+ "depth_mm": {
+ "description": "Chassis depth in millimeters.",
+ "type": "number"
+ },
+ "electrical_role": {
+ "description": "Role in the electrical and PoE Directed Acyclic Graph (DAG).",
+ "enum": [
+ "consumer",
+ "pse-switch",
+ "pdu",
+ "ups",
+ "passive"
+ ],
+ "type": "string"
+ },
+ "height_mm": {
+ "description": "Chassis height in millimeters.",
+ "type": "number"
+ },
+ "manufacturer": {
+ "description": "Hardware manufacturer name.",
+ "type": "string"
+ },
+ "max_system_watts": {
+ "description": "Peak system power consumption in watts.",
+ "type": "number"
+ },
+ "model": {
+ "description": "Hardware model name.",
+ "type": "string"
+ },
+ "mount_type": {
+ "description": "Physical form factor and mounting mechanism.",
+ "enum": [
+ "rackmount-19",
+ "rackmount-10",
+ "rackmount-6",
+ "sub-module",
+ "shelf-standing"
+ ],
+ "type": "string"
+ },
+ "poe_budget_watts": {
+ "description": "Available PSE PoE output budget in watts (0 if non-PSE).",
+ "type": "number"
+ },
+ "port_count": {
+ "description": "Total number of expanded physical ports.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "slot_compatibility": {
+ "description": "Sub-module slot compatibility token, or null for rackmount equipment.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "slots": {
+ "description": "Available carrier bays when mount_type is \"modular-carrier\".",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "accepted_slot_type": {
+ "description": "Accepted child sub-module compatibility token.",
+ "type": "string"
+ },
+ "max_dimensions_mm": {
+ "additionalProperties": false,
+ "description": "Maximum internal bounding dimensions of a carrier slot in mm.",
+ "properties": {
+ "depth": {
+ "description": "Maximum allowed child depth in mm.",
+ "exclusiveMinimum": 0,
+ "type": "number"
+ },
+ "height": {
+ "description": "Maximum allowed child height in mm.",
+ "exclusiveMinimum": 0,
+ "type": "number"
+ },
+ "width": {
+ "description": "Maximum allowed child width in mm.",
+ "exclusiveMinimum": 0,
+ "type": "number"
+ }
+ },
+ "required": [
+ "width",
+ "height",
+ "depth"
+ ],
+ "type": "object"
+ },
+ "slot_id": {
+ "description": "Carrier bay slot identifier.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "slot_id",
+ "accepted_slot_type",
+ "max_dimensions_mm"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "slug": {
+ "description": "Unique lowercase kebab-case hardware blueprint slug.",
+ "type": "string"
+ },
+ "u_height": {
+ "description": "Nominal height in Rack Units (U).",
+ "type": "number"
+ },
+ "weight_grams": {
+ "description": "Device mass in grams.",
+ "type": "number"
+ },
+ "width_mm": {
+ "description": "Chassis width in millimeters.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "slug",
+ "manufacturer",
+ "model",
+ "category",
+ "mount_type",
+ "u_height",
+ "width_mm",
+ "height_mm",
+ "depth_mm",
+ "weight_grams",
+ "electrical_role",
+ "max_system_watts",
+ "poe_budget_watts",
+ "slot_compatibility",
+ "slots",
+ "port_count"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "count": {
+ "description": "Total number of catalog blueprints matching all supplied filter criteria.",
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "count",
+ "blueprints"
+ ],
+ "type": "object"
+ },
+ "issues": {
+ "description": "Structured diagnostic findings (ERROR, WARNING, INFO) with actionable remediation_suggestions.",
+ "items": {
+ "additionalProperties": false,
+ "description": "Single validation finding with deterministic self-correction feedback.",
+ "properties": {
+ "affected_instances": {
+ "description": "Device instance IDs involved in this diagnostic issue.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "code": {
+ "description": "Machine-readable deterministic validation diagnostic code.",
+ "enum": [
+ "CHASSIS_COLLISION",
+ "PLUG_CLEARANCE_COLLISION",
+ "FRONT_DOOR_COLLISION",
+ "SLOT_DIMENSION_OVERFLOW",
+ "SLOT_INCOMPATIBLE",
+ "OUT_OF_RACK_BOUNDS",
+ "BLUEPRINT_NOT_FOUND",
+ "PORT_NOT_FOUND",
+ "PORT_ALREADY_OCCUPIED",
+ "CONNECTOR_INCOMPATIBLE",
+ "SIGNAL_PROTOCOL_INCOMPATIBLE",
+ "SPEED_MISMATCH",
+ "POE_BUDGET_EXCEEDED",
+ "POE_CLASS_EXCEEDED",
+ "UPS_OVERLOAD",
+ "UNPOWERED_DEVICE",
+ "TOP_HEAVY_RACK",
+ "NO_FRONT_TO_REAR_PORTAL",
+ "THERMAL_AIRFLOW_CONFLICT",
+ "THERMAL_HOTSPOT_STACKING",
+ "ACOUSTIC_NOISE_HIGH"
+ ],
+ "type": "string"
+ },
+ "message": {
+ "description": "Detailed engineering explanation with exact millimeter/watt figures.",
+ "type": "string"
+ },
+ "remediation_actions": {
+ "description": "Optional machine-actionable remediation descriptors.",
+ "items": {
+ "additionalProperties": false,
+ "description": "Structured self-correction action for autonomous agent remediation.",
+ "properties": {
+ "action_type": {
+ "description": "Recommended self-correction operation category.",
+ "enum": [
+ "move_device",
+ "change_cable_type",
+ "connect_power",
+ "disconnect_cable",
+ "redistribute_poe",
+ "add_portal_gap",
+ "change_rack_depth"
+ ],
+ "type": "string"
+ },
+ "description": {
+ "description": "Human- and agent-readable explanation of the remediation step.",
+ "type": "string"
+ },
+ "suggested_cable_type": {
+ "description": "Suggested replacement cable_type (e.g. angled plug or higher speed grade).",
+ "type": "string"
+ },
+ "suggested_face": {
+ "description": "Mounting or port face relative to the rack or chassis.",
+ "enum": [
+ "front",
+ "rear"
+ ],
+ "type": "string"
+ },
+ "suggested_u_positions": {
+ "description": "Candidate 1-indexed U positions that resolve the spatial conflict.",
+ "items": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "type": "array"
+ },
+ "target_cable_id": {
+ "description": "Cable connection cable_id targeted by this remediation action.",
+ "type": "string"
+ },
+ "target_instance_id": {
+ "description": "Device instance_id targeted by this remediation action.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action_type",
+ "description"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "remediation_suggestions": {
+ "description": "Actionable self-correction instructions for the calling LLM agent.",
+ "items": {
+ "type": "string"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "severity": {
+ "description": "Severity level of the engineering constraint diagnostic.",
+ "enum": [
+ "ERROR",
+ "WARNING",
+ "INFO"
+ ],
+ "type": "string"
+ },
+ "stage": {
+ "description": "Validation pipeline stage (1..5) that produced this finding.",
+ "maximum": 5,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "u_range": {
+ "additionalItems": false,
+ "description": "Inclusive [start_u, end_u] range where the issue occurs.",
+ "items": [
+ {
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ {
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ ],
+ "maxItems": 2,
+ "minItems": 2,
+ "type": "array"
+ }
+ },
+ "required": [
+ "code",
+ "severity",
+ "affected_instances",
+ "message",
+ "remediation_suggestions"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "status": {
+ "description": "Deterministic execution outcome: \"VALID\" when the operation succeeded with 0 validation errors; \"INVALID\" when precondition or engineering validation errors are present in issues[].",
+ "enum": [
+ "VALID",
+ "INVALID"
+ ],
+ "type": "string"
+ },
+ "summary": {
+ "description": "Concise human- and agent-readable summary of the tool result and validation status.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "summary",
+ "data",
+ "issues"
+ ],
+ "type": "object"
+}