name: Eaton Smart Breaker Capability
description: |
  Naftiko capability surface for the Eaton Smart Breaker API. Covers commissioning, monitoring, controlling, and reporting on Eaton AbleEdge Smart Breakers and (through the EV-Only subset) Green Motion EV Smart Breaker Chargers.
version: 0.1.0
provider: eaton
sourceApi: openapi/smart-breaker-openapi.yml
tags:
  - Smart Breaker
  - Energy
  - AbleEdge
  - Device Control

capabilities:
  - id: list-devices
    name: List Devices
    summary: Enumerate breakers and chargers across the tenant, optionally filtered by location or hardware type.
    operation:
      method: GET
      path: /api/v1/devices
    inputs:
      - name: locationId
        type: string
        required: false
      - name: hardwareType
        type: string
        enum: [emcb, ev-emcb]
        required: false
    outputs:
      - type: array
        items: Device

  - id: get-device
    name: Get Device
    summary: Retrieve a single device's metadata (SKU, serial, firmware).
    operation:
      method: GET
      path: /api/v1/devices/{deviceId}

  - id: get-device-state
    name: Get Device State
    summary: Read live position (open/closed/tripped) and connectivity.
    operation:
      method: GET
      path: /api/v1/devices/{deviceId}/state

  - id: send-device-command
    name: Send Device Command
    summary: Open, close, or cycle a single breaker or EV charger.
    operation:
      method: POST
      path: /api/v1/devices/{deviceId}/commands
    inputs:
      - name: command
        type: string
        enum: [open, close, cycle]
        required: true

  - id: batch-device-command
    name: Send Batch Device Command
    summary: Apply the same command to many devices in one request (e.g. mass shed for DR event).
    operation:
      method: POST
      path: /api/v1/deviceBatchCommands

  - id: get-energy-telemetry
    name: Get Energy Telemetry
    summary: Pull current, voltage, frequency, active power, and energy readings over a window at a given interval.
    operation:
      method: GET
      path: /api/v1/devices/{deviceId}/energy

  - id: list-device-events
    name: List Device Events
    summary: Pull trip, overcurrent, undervoltage, overvoltage, and connectivity events for a device.
    operation:
      method: GET
      path: /api/v1/devices/{deviceId}/events

  - id: list-charging-sessions
    name: List EV Charging Sessions
    summary: List historical and active EV charging sessions for an ev-emcb device.
    operation:
      method: GET
      path: /api/v1/ev/{deviceId}/sessions