Revolutio Structural Engineering Hazard Assessment

naftiko: "1.0.0-alpha1"

info:
  label: "Revolutio Structural Engineering Hazard Assessment"
  description: >-
    Workflow capability for comprehensive structural engineering site hazard
    assessment. Enables engineers and construction software to retrieve wind,
    snow, ice, and seismic design parameters for any global site using
    Revolutio's Hazard API, supporting AS/NZS 1170.2, AS 4055, ASCE 7,
    and other international standards.
  tags:
    - Revolutio
    - Structural Engineering
    - Wind Analysis
    - Construction
    - Hazard Assessment
  created: "2026-05-02"
  modified: "2026-05-02"

binds:
  - namespace: env
    keys:
      REVOLUTIO_API_KEY: REVOLUTIO_API_KEY

capability:
  consumes:
    - import: revolutio
      location: ./shared/revolutio-hazard-api.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: revolutio-engineering-api
      description: "Unified REST API for structural engineering site hazard assessment."
      resources:
        - path: /v1/sites/wind
          name: site-wind
          description: "Wind hazard parameters for a construction site"
          operations:
            - method: GET
              name: get-site-wind
              description: "Retrieve wind region, terrain category, and design wind speed for a site"
              call: "revolutio.get-wind-hazard"
              with:
                latitude: "rest.latitude"
                longitude: "rest.longitude"
                h: "rest.h"
                units: "rest.units"
                advancedDetection: "rest.advanced_detection"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/sites/snow
          name: site-snow
          description: "Snow and ice loading parameters for a construction site"
          operations:
            - method: GET
              name: get-site-snow
              description: "Retrieve snow region, elevation class, and ground load for a site"
              call: "revolutio.get-snow-hazard"
              with:
                latitude: "rest.latitude"
                longitude: "rest.longitude"
                h: "rest.h"
                units: "rest.units"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/sites/seismic
          name: site-seismic
          description: "Seismic hazard parameters for a construction site"
          operations:
            - method: GET
              name: get-site-seismic
              description: "Retrieve seismic hazard class and site classification"
              call: "revolutio.get-seismic-hazard"
              with:
                latitude: "rest.latitude"
                longitude: "rest.longitude"
                units: "rest.units"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/sites/assessment
          name: site-assessment
          description: "Comprehensive multi-hazard site assessment"
          operations:
            - method: GET
              name: get-site-assessment
              description: "Get all hazard parameters (wind, snow, ice, seismic) for a complete site assessment"
              call: "revolutio.get-combined-hazard"
              with:
                latitude: "rest.latitude"
                longitude: "rest.longitude"
                h: "rest.h"
                units: "rest.units"
                advancedDetection: "rest.advanced_detection"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9080
      namespace: revolutio-engineering-mcp
      transport: http
      description: "MCP server for AI-assisted structural engineering hazard assessment."
      tools:
        - name: get-site-wind-hazard
          description: "Get wind hazard parameters for a specific geographic location. Returns wind region, terrain category, topographic class, and design wind speed per AS/NZS 1170.2 or ASCE 7."
          hints:
            readOnly: true
            openWorld: true
          call: "revolutio.get-wind-hazard"
          with:
            latitude: "tools.latitude"
            longitude: "tools.longitude"
            h: "tools.structure_height"
            units: "tools.units"
            advancedDetection: "tools.advanced_detection"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-site-snow-hazard
          description: "Get snow and ice loading parameters for a site. Returns snow region, elevation class, snow ground load, and ice region classification."
          hints:
            readOnly: true
            openWorld: true
          call: "revolutio.get-snow-hazard"
          with:
            latitude: "tools.latitude"
            longitude: "tools.longitude"
            h: "tools.structure_height"
            units: "tools.units"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-site-seismic-hazard
          description: "Get seismic hazard parameters for a site. Returns hazard class, site class, and probability factor."
          hints:
            readOnly: true
            openWorld: true
          call: "revolutio.get-seismic-hazard"
          with:
            latitude: "tools.latitude"
            longitude: "tools.longitude"
            units: "tools.units"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-complete-site-assessment
          description: "Get a comprehensive multi-hazard site assessment covering wind, snow, ice, and seismic parameters in a single API call. Ideal for full structural engineering site evaluations."
          hints:
            readOnly: true
            openWorld: true
          call: "revolutio.get-combined-hazard"
          with:
            latitude: "tools.latitude"
            longitude: "tools.longitude"
            h: "tools.structure_height"
            units: "tools.units"
            advancedDetection: "tools.advanced_detection"
          outputParameters:
            - type: object
              mapping: "$."