Skip to main content
Glama

Initialize and Reset Rack Enclosure

init_rack
DestructiveIdempotent

Initializes a new rack project by resetting rack.yaml to an empty enclosure with chosen width, U height, and rail depth, clearing devices, cables, and endpoints while preserving undo state.

Instructions

Initialize a new rack project and destructively reset the active rack.yaml state to an empty enclosure with the specified width standard, U height, and rail depth. Overwrites the current enclosure and clears all mounted devices, child sub-modules, cables, and external endpoints, while pushing the previous project state onto the in-memory undo stack for recovery via undo_redo. 'project_name' sets the title used in exported schematics and BOMs, 'rail_depth_mm' plus 'rear_clearance_mm' bounds total +Z chassis and rear plug depth before wall collision, and 'front_door_clearance_mm' is enforced only when 'enclosure_type' has a closed front door. Use when starting a rack design from scratch or changing enclosure dimensions; use validate_rack to inspect the current rack, or modify_equipment to move or remove individual devices.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "standard": "<standard>",
      "u_height": "<u_height>",
      "rail_depth_mm": "<rail_depth_mm>"
    },
    "name": "init_rack"
  }
}

Input Schema

NameRequiredDescriptionDefault
standardYesMechanical rack width standard ("19inch" = 482.6mm, "10inch" = 254.0mm, "6inch" = 152.4mm).
u_heightYesTotal usable vertical rack height in Rack Units (1U = 44.45mm, 1..60U).
project_nameNoHuman-readable project name stored in rack.yaml.Rack Project
rail_depth_mmYesFront-to-rear mounting rail depth in millimeters along the Z-axis (max 2000mm).
enclosure_typeNoEnclosure door style ("open-frame", "closed-glass-front", or "closed-vented-front").open-frame
rear_clearance_mmNoAvailable clearance in millimeters behind the rear mounting rails (Z=rail_depth_mm) for power plugs and bending radii.
front_door_clearance_mmNoAvailable clearance in millimeters between front mounting rails (Z=0) and a closed front door.

Output Schema

NameRequiredDescriptionDefault
dataYesRack initialization payload.
issuesYesStructured diagnostic findings (ERROR, WARNING, INFO) with actionable remediation_suggestions.
statusYesDeterministic execution outcome: "VALID" when the operation succeeded with 0 validation errors; "INVALID" when precondition or engineering validation errors are present in issues[].
summaryYesConcise human- and agent-readable summary of the tool result and validation status.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed13 schema fields changedv0.5.0
    • addedInput schema / properties / front_door_clearance_mm / maximum
      Added value: +1000
    • addedInput schema / properties / project_name / maxLength
      Added value: +160
    • changedInput schema / properties / rail_depth_mm / description
      Previous value: -"Front-to-rear mounting rail depth in millimeters along the Z-axis."New value: +"Front-to-rear mounting rail depth in millimeters along the Z-axis (max 2000mm)."
    • addedInput schema / properties / rail_depth_mm / maximum
      Added value: +2000
    • addedInput schema / properties / rear_clearance_mm / maximum
      Added value: +1000
    • changedInput schema / properties / u_height / description
      Previous value: -"Total usable vertical rack height in Rack Units (1U = 44.45mm)."New value: +"Total usable vertical rack height in Rack Units (1U = 44.45mm, 1..60U)."
    • changedInput schema / properties / u_height / maximum
      Previous value: -9007199254740991New value: +60
    • addedOutput schema / properties / data / properties / rack / properties / front_door_clearance_mm / maximum
      Added value: +1000
    • changedOutput schema / properties / data / properties / rack / properties / rail_depth_mm / description
      Previous value: -"Distance from front mounting rail face (Z=0) to rear mounting rail face in mm."New value: +"Distance from front mounting rail face (Z=0) to rear mounting rail face in mm (max 2000mm)."
    • addedOutput schema / properties / data / properties / rack / properties / rail_depth_mm / maximum
      Added value: +2000
    • addedOutput schema / properties / data / properties / rack / properties / rear_clearance_mm / maximum
      Added value: +1000
    • changedOutput schema / properties / data / properties / rack / properties / u_height / description
      Previous value: -"Total vertical rack capacity in Rack Units (U / HE)."New value: +"Total vertical rack capacity in Rack Units (U / HE, 1..60)."
    • changedOutput schema / properties / data / properties / rack / properties / u_height / maximum
      Previous value: -9007199254740991New value: +60
  2. Changed8 schema fields changedv0.4.10
    • changedInput schema / properties / enclosure_type / description
      Previous value: -"Physical rack enclosure style governing front door clearance checks."New value: +"Enclosure door style (\"open-frame\", \"closed-glass-front\", or \"closed-vented-front\")."
    • changedInput schema / properties / front_door_clearance_mm / description
      Previous value: -"Clearance in mm between front rails and door."New value: +"Available clearance in millimeters between front mounting rails (Z=0) and a closed front door."
    • changedInput schema / properties / project_name / description
      Previous value: -"Human-readable project name."New value: +"Human-readable project name stored in rack.yaml."
    • changedInput schema / properties / rail_depth_mm / description
      Previous value: -"Front-to-rear mounting rail depth in millimeters."New value: +"Front-to-rear mounting rail depth in millimeters along the Z-axis."
    • changedInput schema / properties / rear_clearance_mm / description
      Previous value: -"Clearance in mm behind rear rails."New value: +"Available clearance in millimeters behind the rear mounting rails (Z=rail_depth_mm) for power plugs and bending radii."
    • changedInput schema / properties / standard / description
      Previous value: -"EIA-310-D or homelab rack width standard."New value: +"Mechanical rack width standard (\"19inch\" = 482.6mm, \"10inch\" = 254.0mm, \"6inch\" = 152.4mm)."
    • changedInput schema / properties / u_height / description
      Previous value: -"Total usable rack height in U (1U = 44.45mm)."New value: +"Total usable vertical rack height in Rack Units (1U = 44.45mm)."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "data": {
      +      "additionalProperties": {},
      +      "description": "Rack initialization payload.",
      +      "properties": {
      +        "geometry": {
      +          "additionalProperties": {},
      +          "description": "Computed millimeter enclosure dimensions.",
      +          "properties": {
      +            "aperture_width_mm": {
      +              "description": "Inner usable rail aperture width in millimeters.",
      +              "type": "number"
      +            },
      +            "panel_width_mm": {
      +              "description": "Outer mounting ear panel width in millimeters.",
      +              "type": "number"
      +            },
      +            "rail_depth_mm": {
      +              "description": "Front-to-rear mounting rail depth in millimeters.",
      +              "type": "number"
      +            },
      +            "total_height_mm": {
      +              "description": "Total vertical mounting height in millimeters (u_height * 44.45).",
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "total_height_mm",
      +            "rail_depth_mm",
      +            "panel_width_mm",
      +            "aperture_width_mm"
      +          ],
      +          "type": "object"
      +        },
      +        "rack": {
      +          "additionalProperties": false,
      +          "description": "Initialized physical rack frame specification.",
      +          "properties": {
      +            "enclosure_type": {
      +              "default": "open-frame",
      +              "description": "Physical rack enclosure style governing front door clearance checks.",
      +              "enum": [
      +                "open-frame",
      +                "closed-glass-front",
      +                "closed-vented-front"
      +              ],
      +              "type": "string"
      +            },
      +            "front_door_clearance_mm": {
      +              "default": 45,
      +              "description": "Available clearance in front of Z=0 before hitting the front door in mm.",
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "rail_depth_mm": {
      +              "description": "Distance from front mounting rail face (Z=0) to rear mounting rail face in mm.",
      +              "exclusiveMinimum": 0,
      +              "type": "number"
      +            },
      +            "rear_clearance_mm": {
      +              "default": 40,
      +              "description": "Available clearance behind Z=rail_depth_mm in mm.",
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "standard": {
      +              "description": "EIA-310-D or homelab rack width standard.",
      +              "enum": [
      +                "19inch",
      +                "10inch",
      +                "6inch"
      +              ],
      +              "type": "string"
      +            },
      +            "u_height": {
      +              "description": "Total vertical rack capacity in Rack Units (U / HE).",
      +              "exclusiveMinimum": 0,
      +              "maximum": 9007199254740991,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "standard",
      +            "u_height",
      +            "rail_depth_mm",
      +            "enclosure_type",
      +            "front_door_clearance_mm",
      +            "rear_clearance_mm"
      +          ],
      +          "type": "object"
      +        },
      +        "validation": {
      +          "additionalProperties": false,
      +          "description": "Initial 5-stage validation report for the newly initialized empty rack.",
      +          "properties": {
      +            "error_count": {
      +              "description": "Total number of blocking ERROR diagnostics.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "is_valid": {
      +              "description": "True when zero ERROR-level diagnostic issues exist.",
      +              "type": "boolean"
      +            },
      +            "issues": {
      +              "description": "List of all detected ERROR, WARNING, and INFO diagnostic issues.",
      +              "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"
      +            },
      +            "mechanical_summary": {
      +              "additionalProperties": false,
      +              "description": "Aggregated mechanical mass, center of gravity, thermal BTU/hr, and acoustic dB(A) metrics.",
      +              "properties": {
      +                "airflow_profile": {
      +                  "default": "uniform-passive",
      +                  "description": "Rack-wide thermal airflow regime classification.",
      +                  "enum": [
      +                    "uniform-front-to-rear",
      +                    "uniform-passive",
      +                    "hybrid-active-passive",
      +                    "mixed-conflict"
      +                  ],
      +                  "type": "string"
      +                },
      +                "available_portal_u_positions": {
      +                  "description": "1-indexed U slots that allow front-to-rear cable pass-through (open U or brush panel).",
      +                  "items": {
      +                    "maximum": 9007199254740991,
      +                    "minimum": -9007199254740991,
      +                    "type": "integer"
      +                  },
      +                  "type": "array"
      +                },
      +                "center_of_gravity_y_mm": {
      +                  "description": "Vertical Center of Gravity height from bottom of U1 in millimeters.",
      +                  "type": "number"
      +                },
      +                "combined_noise_db_a": {
      +                  "default": 0,
      +                  "description": "Logarithmic sum of acoustic noise emissions in dB(A) across all mounted devices.",
      +                  "type": "number"
      +                },
      +                "normalized_cog_y": {
      +                  "description": "Normalized vertical Center of Gravity ratio (0.0 = bottom, 1.0 = top; keep <= 0.50).",
      +                  "type": "number"
      +                },
      +                "total_thermal_btu_hr": {
      +                  "default": 0,
      +                  "description": "Total peak thermal dissipation in BTU/hr (1W = 3.41214 BTU/hr).",
      +                  "type": "number"
      +                },
      +                "total_weight_grams": {
      +                  "description": "Total mass of all mounted equipment in grams.",
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "total_weight_grams",
      +                "center_of_gravity_y_mm",
      +                "normalized_cog_y",
      +                "available_portal_u_positions",
      +                "total_thermal_btu_hr",
      +                "combined_noise_db_a",
      +                "airflow_profile"
      +              ],
      +              "type": "object"
      +            },
      +            "power_summary": {
      +              "additionalProperties": false,
      +              "description": "Aggregated electrical and PoE DAG power analysis.",
      +              "properties": {
      +                "power_sources": {
      +                  "description": "Per-PDU and per-UPS electrical load breakdown.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "description": "Load and capacity summary for a mounted PDU or UPS unit.",
      +                    "properties": {
      +                      "capacity_watts": {
      +                        "description": "Maximum rated output capacity of the power source in watts.",
      +                        "type": "number"
      +                      },
      +                      "role": {
      +                        "description": "Electrical source classification (\"pdu\" or \"ups\").",
      +                        "enum": [
      +                          "pdu",
      +                          "ups"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "source_instance_id": {
      +                        "description": "Instance ID of the upstream PDU or UPS unit.",
      +                        "type": "string"
      +                      },
      +                      "total_load_watts": {
      +                        "description": "Cumulative downstream system and PoE load in watts.",
      +                        "type": "number"
      +                      },
      +                      "utilization_percent": {
      +                        "description": "Percentage of rated watt capacity consumed (0..100+).",
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "source_instance_id",
      +                      "role",
      +                      "capacity_watts",
      +                      "total_load_watts",
      +                      "utilization_percent"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "pse_budgets": {
      +                  "description": "Per-switch PoE budget utilization breakdown.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "description": "PoE budget utilization breakdown for a single PSE switch.",
      +                    "properties": {
      +                      "consumed_poe_watts": {
      +                        "description": "Total PoE power drawn by connected Powered Devices (PDs) in watts.",
      +                        "type": "number"
      +                      },
      +                      "downstream_devices": {
      +                        "description": "Instance or endpoint IDs of downstream PoE consumers powered by this switch.",
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "poe_budget_watts": {
      +                        "description": "Maximum rated PoE output power budget of the switch in watts.",
      +                        "type": "number"
      +                      },
      +                      "pse_instance_id": {
      +                        "description": "Instance ID of the PoE Power Sourcing Equipment (PSE) switch.",
      +                        "type": "string"
      +                      },
      +                      "remaining_poe_watts": {
      +                        "description": "Remaining available PoE power budget in watts (negative if overloaded).",
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "pse_instance_id",
      +                      "poe_budget_watts",
      +                      "consumed_poe_watts",
      +                      "remaining_poe_watts",
      +                      "downstream_devices"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "total_poe_watts": {
      +                  "description": "Total PoE power draw across all connected PoE devices and external drops in watts.",
      +                  "type": "number"
      +                },
      +                "total_system_watts": {
      +                  "description": "Total peak system power draw across all mounted equipment in watts.",
      +                  "type": "number"
      +                },
      +                "unpowered_active_instances": {
      +                  "description": "Active device instance IDs missing a valid AC, DC, USB-C, or PoE power input.",
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "total_system_watts",
      +                "total_poe_watts",
      +                "pse_budgets",
      +                "power_sources",
      +                "unpowered_active_instances"
      +              ],
      +              "type": "object"
      +            },
      +            "status": {
      +              "description": "Overall rack validation state (\"VALID\" when error_count is 0).",
      +              "enum": [
      +                "VALID",
      +                "INVALID"
      +              ],
      +              "type": "string"
      +            },
      +            "warning_count": {
      +              "description": "Total number of non-blocking WARNING diagnostics.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "status",
      +            "is_valid",
      +            "error_count",
      +            "warning_count",
      +            "issues",
      +            "power_summary",
      +            "mechanical_summary"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "rack",
      +        "geometry",
      +        "validation"
      +      ],
      +      "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"
      +}
  3. Changed2 schema fields changedv0.4.9
    • removedInput schema / additionalProperties
      Removed value: -false
    • addedInput schema / properties / u_height / maximum
      Added value: +9007199254740991
  4. First observedv0.1.0

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description goes well beyond the destructiveHint annotation by detailing exactly what is destroyed: mounted devices, child sub-modules, cables, and external endpoints. It also discloses the recovery path via the in-memory undo stack and undo_redo, which is valuable behavioral context for a destructive operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core destructive behavior before parameter semantics and usage guidance. It is dense but each clause carries useful information; the main cost is a single very long sentence rather than wasted content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive initialization/reset tool with full schema coverage, annotations, and an output schema, the description covers the consequences, recovery path, parameter relationships, and appropriate usage. An agent has enough context to invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is already strong. The description adds useful relational semantics: project_name feeds exported schematics/BOMs, rail_depth_mm plus rear_clearance_mm bound total +Z depth before wall collision, and front_door_clearance_mm applies only with a closed front door.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: initialize a new rack project and destructively reset the active rack.yaml enclosure. It clearly distinguishes the operation from siblings by naming validate_rack for inspection and modify_equipment for individual device changes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly says when to use the tool: starting a rack design from scratch or changing enclosure dimensions. It also names alternatives for different needs, including validate_rack and modify_equipment, leaving little ambiguity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.