openapi.json

{
 "openapi": "3.1.0",
 "info": {
  "title": "Noonshift",
  "version": "0.1.0"
 },
 "paths": {
  "/health": {
   "get": {
    "summary": "Health",
    "operationId": "health_health_get",
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {}
       }
      }
     }
    }
   }
  },
  "/sessions": {
   "post": {
    "summary": "Create Session",
    "description": "Driver answers \"When do you leave?\". Updates the session on that connector, or plugs a new one in.",
    "operationId": "create_session_sessions_post",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/SessionIn"
       }
      }
     },
     "required": true
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/SessionOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/sessions/{sid}/urgency": {
   "post": {
    "summary": "Urgency",
    "description": "business.md \u00a74b. now: deadline = now, full power (the ASAP path). soon: deadline = leave_at, the LP picks the\ncleanest slots inside the window (< 15 min away = now). priority: deadline unchanged, floor 90 % pro-rata and the\nshortfall weight doubled. Every band marks the session urgent, so price() returns exactly R.",
    "operationId": "urgency_sessions__sid__urgency_post",
    "parameters": [
     {
      "name": "sid",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer",
       "title": "Sid"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/UrgencyIn"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/SessionOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/sessions/{sid}/boost": {
   "post": {
    "summary": "Boost",
    "description": "Alias for urgency \"now\" (WattWise's \"Charge now\" button).",
    "operationId": "boost_sessions__sid__boost_post",
    "parameters": [
     {
      "name": "sid",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer",
       "title": "Sid"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/SessionOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/sessions/{sid}/unplug": {
   "post": {
    "summary": "Unplug",
    "description": "The driver unplugs (early or not): the session ends with an honest receipt and the plan re-solves without it.",
    "operationId": "unplug_sessions__sid__unplug_post",
    "parameters": [
     {
      "name": "sid",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer",
       "title": "Sid"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/LiveOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/sessions/{sid}/live": {
   "get": {
    "summary": "Live",
    "operationId": "live_sessions__sid__live_get",
    "parameters": [
     {
      "name": "sid",
      "in": "path",
      "required": true,
      "schema": {
       "type": "integer",
       "title": "Sid"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/LiveOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/sites/{site_id}/plan": {
   "get": {
    "summary": "Site Plan",
    "operationId": "site_plan_sites__site_id__plan_get",
    "parameters": [
     {
      "name": "site_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "title": "Site Id"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PlanMsg"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/sites/{site_id}/impact": {
   "get": {
    "summary": "Site Impact",
    "operationId": "site_impact_sites__site_id__impact_get",
    "parameters": [
     {
      "name": "site_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "title": "Site Id"
      }
     },
     {
      "name": "from",
      "in": "query",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string",
         "format": "date-time"
        },
        {
         "type": "null"
        }
       ],
       "title": "From"
      }
     },
     {
      "name": "to",
      "in": "query",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string",
         "format": "date-time"
        },
        {
         "type": "null"
        }
       ],
       "title": "To"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/ImpactOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/sites/{site_id}/impact.csv": {
   "get": {
    "summary": "Site Impact Csv",
    "description": "The audit-ready ledger (solutions.md \u00a712): LCFS takes the kWh column today; an hourly-EAC registry takes the rest.",
    "operationId": "site_impact_csv_sites__site_id__impact_csv_get",
    "parameters": [
     {
      "name": "site_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "title": "Site Id"
      }
     },
     {
      "name": "from",
      "in": "query",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string",
         "format": "date-time"
        },
        {
         "type": "null"
        }
       ],
       "title": "From"
      }
     },
     {
      "name": "to",
      "in": "query",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string",
         "format": "date-time"
        },
        {
         "type": "null"
        }
       ],
       "title": "To"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "text/plain": {
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/sites/{site_id}/status": {
   "get": {
    "summary": "Site Status",
    "operationId": "site_status_sites__site_id__status_get",
    "parameters": [
     {
      "name": "site_id",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "title": "Site Id"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/StatusOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/price": {
   "get": {
    "summary": "Price Preview",
    "description": "What a ready-by would cost before plugging in. No session yet, so the discount is today's site saving rate so far\n(sum of measured session savings over delivered kWh) applied to this need: an estimate, settled on the receipt.",
    "operationId": "price_preview_price_get",
    "parameters": [
     {
      "name": "departure_at",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "format": "date-time",
       "title": "Departure At"
      }
     },
     {
      "name": "kwh_needed",
      "in": "query",
      "required": false,
      "schema": {
       "type": "number",
       "default": 8.0,
       "title": "Kwh Needed"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/PricePreview"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/grid/signal": {
   "get": {
    "summary": "Grid Signal",
    "description": "Today's grid signal and tariff by hour, for the driver app's 'why this hour' graph.",
    "operationId": "grid_signal_grid_signal_get",
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "items": {
          "$ref": "#/components/schemas/SignalHour"
         },
         "type": "array",
         "title": "Response Grid Signal Grid Signal Get"
        }
       }
      }
     }
    }
   }
  },
  "/grid/flex-forecast": {
   "get": {
    "summary": "Flex Forecast",
    "description": "Stub: headroom under the feed not claimed by the current plan, per hour of the rest of today.",
    "operationId": "flex_forecast_grid_flex_forecast_get",
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "items": {
          "$ref": "#/components/schemas/FlexHour"
         },
         "type": "array",
         "title": "Response Flex Forecast Grid Flex Forecast Get"
        }
       }
      }
     }
    }
   }
  },
  "/openadr/events": {
   "post": {
    "summary": "Openadr Event",
    "description": "Stub: accept a DR event as a feed reduction over [start, end) and re-solve.",
    "operationId": "openadr_event_openadr_events_post",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/DrEvent"
       }
      }
     },
     "required": true
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {}
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/assist": {
   "post": {
    "summary": "Assist Ask",
    "description": "The operator assistant: explains and suggests from live state + repo docs; never acts. Falls back to templates\nwithout a key; 429 with Retry-After when the model or the per-IP limit (10/min) says so.",
    "operationId": "assist_ask_assist_post",
    "parameters": [
     {
      "name": "authorization",
      "in": "header",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "title": "Authorization"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/AssistIn"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/AssistOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/assist/suggestions": {
   "get": {
    "summary": "Assist Suggestions",
    "operationId": "assist_suggestions_assist_suggestions_get",
    "parameters": [
     {
      "name": "authorization",
      "in": "header",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "title": "Authorization"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "array",
         "items": {
          "type": "string"
         },
         "title": "Response Assist Suggestions Assist Suggestions Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/demo/early_unplug": {
   "post": {
    "summary": "Demo Early Unplug",
    "description": "Tom: told us 17:00, leaves now. Picks the charging car with the latest deadline and least energy.",
    "operationId": "demo_early_unplug_demo_early_unplug_post",
    "parameters": [
     {
      "name": "authorization",
      "in": "header",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "title": "Authorization"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/DemoOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/demo/boost": {
   "post": {
    "summary": "Demo Boost",
    "description": "Sofia: 10:30 site visit. Picks the least-charged car, moves its deadline to now+1h with Boost.",
    "operationId": "demo_boost_demo_boost_post",
    "parameters": [
     {
      "name": "authorization",
      "in": "header",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "title": "Authorization"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/DemoOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/demo/oversubscribe": {
   "post": {
    "summary": "Demo Oversubscribe",
    "description": "+20 late arrivals, 2 h deadlines, on the spare connectors. More demand than the feed can serve.",
    "operationId": "demo_oversubscribe_demo_oversubscribe_post",
    "parameters": [
     {
      "name": "authorization",
      "in": "header",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "title": "Authorization"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/DemoOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/demo/signal_outage": {
   "post": {
    "summary": "Demo Signal Outage",
    "description": "Knock rungs out of the fail-safe ladder (default: the live signal) or restore all.",
    "operationId": "demo_signal_outage_demo_signal_outage_post",
    "parameters": [
     {
      "name": "authorization",
      "in": "header",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "title": "Authorization"
      }
     }
    ],
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/OutageIn",
        "default": {
         "rungs": [
          "live"
         ],
         "restore": false
        }
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/DemoOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/demo/jump": {
   "post": {
    "summary": "Demo Jump",
    "description": "Fast-forward the sim clock to HH:MM today. The control loop plays every minute in between (plans, meters,\nevents all still happen), just without waiting; nothing is skipped, so the ledger stays honest.",
    "operationId": "demo_jump_demo_jump_post",
    "parameters": [
     {
      "name": "authorization",
      "in": "header",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "title": "Authorization"
      }
     }
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/JumpIn"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/DemoOut"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "AssistAction": {
    "properties": {
     "label": {
      "type": "string",
      "title": "Label"
     },
     "path": {
      "type": "string",
      "title": "Path"
     }
    },
    "type": "object",
    "required": [
     "label",
     "path"
    ],
    "title": "AssistAction"
   },
   "AssistIn": {
    "properties": {
     "question": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "title": "Question"
     },
     "history": {
      "items": {
       "$ref": "#/components/schemas/Turn"
      },
      "type": "array",
      "title": "History",
      "default": []
     },
     "page": {
      "type": "string",
      "maxLength": 200,
      "title": "Page",
      "default": ""
     }
    },
    "type": "object",
    "required": [
     "question"
    ],
    "title": "AssistIn"
   },
   "AssistOut": {
    "properties": {
     "answer": {
      "type": "string",
      "title": "Answer"
     },
     "sources": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "title": "Sources",
      "default": []
     },
     "suggested_actions": {
      "items": {
       "$ref": "#/components/schemas/AssistAction"
      },
      "type": "array",
      "title": "Suggested Actions",
      "default": []
     },
     "fallback": {
      "type": "boolean",
      "title": "Fallback",
      "default": false
     },
     "degraded": {
      "type": "boolean",
      "title": "Degraded",
      "default": false
     },
     "usage": {
      "anyOf": [
       {
        "additionalProperties": true,
        "type": "object"
       },
       {
        "type": "null"
       }
      ],
      "title": "Usage"
     }
    },
    "type": "object",
    "required": [
     "answer"
    ],
    "title": "AssistOut"
   },
   "ConnectorPlan": {
    "properties": {
     "connector_id": {
      "type": "string",
      "title": "Connector Id"
     },
     "session_id": {
      "type": "integer",
      "title": "Session Id"
     },
     "kw": {
      "items": {
       "type": "number"
      },
      "type": "array",
      "title": "Kw"
     }
    },
    "type": "object",
    "required": [
     "connector_id",
     "session_id",
     "kw"
    ],
    "title": "ConnectorPlan"
   },
   "DemoOut": {
    "properties": {
     "changed": {
      "type": "string",
      "title": "Changed"
     },
     "detail": {
      "additionalProperties": true,
      "type": "object",
      "title": "Detail"
     }
    },
    "type": "object",
    "required": [
     "changed",
     "detail"
    ],
    "title": "DemoOut"
   },
   "DrEvent": {
    "properties": {
     "start": {
      "type": "string",
      "format": "date-time",
      "title": "Start"
     },
     "end": {
      "type": "string",
      "format": "date-time",
      "title": "End"
     },
     "reduce_kw": {
      "type": "number",
      "title": "Reduce Kw"
     }
    },
    "type": "object",
    "required": [
     "start",
     "end",
     "reduce_kw"
    ],
    "title": "DrEvent"
   },
   "FlexHour": {
    "properties": {
     "hour": {
      "type": "integer",
      "title": "Hour"
     },
     "shiftable_kw": {
      "type": "number",
      "title": "Shiftable Kw"
     }
    },
    "type": "object",
    "required": [
     "hour",
     "shiftable_kw"
    ],
    "title": "FlexHour"
   },
   "HTTPValidationError": {
    "properties": {
     "detail": {
      "items": {
       "$ref": "#/components/schemas/ValidationError"
      },
      "type": "array",
      "title": "Detail"
     }
    },
    "type": "object",
    "title": "HTTPValidationError"
   },
   "ImpactOut": {
    "properties": {
     "from": {
      "type": "string",
      "format": "date-time",
      "title": "From"
     },
     "to": {
      "type": "string",
      "format": "date-time",
      "title": "To"
     },
     "sessions": {
      "type": "integer",
      "title": "Sessions"
     },
     "kwh": {
      "type": "number",
      "title": "Kwh"
     },
     "saved_usd": {
      "type": "number",
      "title": "Saved Usd"
     },
     "saved_kgco2": {
      "type": "number",
      "title": "Saved Kgco2"
     },
     "peak_kw": {
      "type": "number",
      "title": "Peak Kw",
      "default": 0.0
     },
     "baseline_peak_kw": {
      "type": "number",
      "title": "Baseline Peak Kw",
      "default": 0.0
     },
     "renewable_share": {
      "type": "number",
      "title": "Renewable Share",
      "default": 0.0
     },
     "health_usd": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ],
      "title": "Health Usd"
     },
     "note": {
      "type": "string",
      "title": "Note",
      "default": "estimate vs charge-immediately baseline"
     }
    },
    "type": "object",
    "required": [
     "from",
     "to",
     "sessions",
     "kwh",
     "saved_usd",
     "saved_kgco2"
    ],
    "title": "ImpactOut"
   },
   "JumpIn": {
    "properties": {
     "hour": {
      "type": "integer",
      "maximum": 23.0,
      "minimum": 0.0,
      "title": "Hour"
     },
     "minute": {
      "type": "integer",
      "maximum": 59.0,
      "minimum": 0.0,
      "title": "Minute",
      "default": 0
     }
    },
    "type": "object",
    "required": [
     "hour"
    ],
    "title": "JumpIn"
   },
   "LiveOut": {
    "properties": {
     "session_id": {
      "type": "integer",
      "title": "Session Id"
     },
     "status": {
      "type": "string",
      "enum": [
       "pending",
       "charging",
       "done",
       "ended"
      ],
      "title": "Status"
     },
     "kw_now": {
      "type": "number",
      "title": "Kw Now"
     },
     "grid_percentile": {
      "type": "number",
      "title": "Grid Percentile"
     },
     "kwh_delivered": {
      "type": "number",
      "title": "Kwh Delivered"
     },
     "kwh_needed": {
      "type": "number",
      "title": "Kwh Needed"
     },
     "saved_usd": {
      "type": "number",
      "title": "Saved Usd"
     },
     "saved_kgco2": {
      "type": "number",
      "title": "Saved Kgco2"
     }
    },
    "type": "object",
    "required": [
     "session_id",
     "status",
     "kw_now",
     "grid_percentile",
     "kwh_delivered",
     "kwh_needed",
     "saved_usd",
     "saved_kgco2"
    ],
    "title": "LiveOut"
   },
   "OutageIn": {
    "properties": {
     "rungs": {
      "items": {
       "type": "string",
       "enum": [
        "live",
        "cached",
        "tariff",
        "deadline"
       ]
      },
      "type": "array",
      "title": "Rungs",
      "default": [
       "live"
      ]
     },
     "restore": {
      "type": "boolean",
      "title": "Restore",
      "default": false
     }
    },
    "type": "object",
    "title": "OutageIn"
   },
   "PlanMsg": {
    "properties": {
     "type": {
      "type": "string",
      "const": "plan",
      "title": "Type",
      "default": "plan"
     },
     "site_id": {
      "type": "string",
      "title": "Site Id"
     },
     "solved_at": {
      "type": "string",
      "format": "date-time",
      "title": "Solved At"
     },
     "mode": {
      "type": "string",
      "enum": [
       "live",
       "cached",
       "tariff",
       "deadline",
       "full"
      ],
      "title": "Mode"
     },
     "reason": {
      "type": "string",
      "title": "Reason"
     },
     "horizon_start": {
      "type": "string",
      "format": "date-time",
      "title": "Horizon Start"
     },
     "slot_minutes": {
      "type": "integer",
      "title": "Slot Minutes",
      "default": 5
     },
     "connectors": {
      "items": {
       "$ref": "#/components/schemas/ConnectorPlan"
      },
      "type": "array",
      "title": "Connectors"
     },
     "site_kw": {
      "items": {
       "type": "number"
      },
      "type": "array",
      "title": "Site Kw"
     }
    },
    "type": "object",
    "required": [
     "site_id",
     "solved_at",
     "mode",
     "reason",
     "horizon_start",
     "connectors",
     "site_kw"
    ],
    "title": "PlanMsg"
   },
   "PlanWindow": {
    "properties": {
     "start": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       },
       {
        "type": "null"
       }
      ],
      "title": "Start"
     },
     "end": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       },
       {
        "type": "null"
       }
      ],
      "title": "End"
     },
     "ready_by": {
      "type": "string",
      "format": "date-time",
      "title": "Ready By"
     }
    },
    "type": "object",
    "required": [
     "start",
     "end",
     "ready_by"
    ],
    "title": "PlanWindow"
   },
   "Price": {
    "properties": {
     "tier": {
      "type": "string",
      "enum": [
       "green",
       "standard",
       "boost"
      ],
      "title": "Tier"
     },
     "usd_per_kwh": {
      "type": "number",
      "title": "Usd Per Kwh"
     }
    },
    "type": "object",
    "required": [
     "tier",
     "usd_per_kwh"
    ],
    "title": "Price"
   },
   "PricePreview": {
    "properties": {
     "slack_hours": {
      "type": "number",
      "title": "Slack Hours"
     },
     "price": {
      "$ref": "#/components/schemas/Price"
     },
     "tiers": {
      "items": {
       "$ref": "#/components/schemas/PriceTier"
      },
      "type": "array",
      "title": "Tiers"
     }
    },
    "type": "object",
    "required": [
     "slack_hours",
     "price",
     "tiers"
    ],
    "title": "PricePreview",
    "description": "What the driver would pay for a given ready-by, before plugging in. Slack = dwell minus charge time."
   },
   "PriceTier": {
    "properties": {
     "tier": {
      "type": "string",
      "enum": [
       "green",
       "standard",
       "boost"
      ],
      "title": "Tier"
     },
     "min_slack_hours": {
      "type": "number",
      "title": "Min Slack Hours"
     },
     "usd_per_kwh": {
      "type": "number",
      "title": "Usd Per Kwh"
     }
    },
    "type": "object",
    "required": [
     "tier",
     "min_slack_hours",
     "usd_per_kwh"
    ],
    "title": "PriceTier"
   },
   "SessionIn": {
    "properties": {
     "connector_id": {
      "type": "string",
      "title": "Connector Id"
     },
     "departure_at": {
      "type": "string",
      "format": "date-time",
      "title": "Departure At"
     },
     "kwh_needed": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ],
      "title": "Kwh Needed"
     },
     "vehicle": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/Vehicle"
       },
       {
        "type": "null"
       }
      ]
     },
     "soc_now": {
      "anyOf": [
       {
        "type": "number",
        "maximum": 1.0,
        "minimum": 0.0
       },
       {
        "type": "null"
       }
      ],
      "title": "Soc Now"
     },
     "target_soc": {
      "type": "number",
      "maximum": 1.0,
      "exclusiveMinimum": 0.0,
      "title": "Target Soc",
      "default": 1.0
     }
    },
    "type": "object",
    "required": [
     "connector_id",
     "departure_at"
    ],
    "title": "SessionIn"
   },
   "SessionOut": {
    "properties": {
     "session_id": {
      "type": "integer",
      "title": "Session Id"
     },
     "connector_id": {
      "type": "string",
      "title": "Connector Id"
     },
     "status": {
      "type": "string",
      "enum": [
       "pending",
       "charging",
       "done",
       "ended"
      ],
      "title": "Status"
     },
     "plan": {
      "$ref": "#/components/schemas/PlanWindow"
     },
     "eta": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       },
       {
        "type": "null"
       }
      ],
      "title": "Eta"
     },
     "price": {
      "$ref": "#/components/schemas/Price"
     },
     "boost": {
      "type": "boolean",
      "title": "Boost"
     },
     "urgency": {
      "anyOf": [
       {
        "type": "string",
        "enum": [
         "now",
         "soon",
         "priority"
        ]
       },
       {
        "type": "null"
       }
      ],
      "title": "Urgency"
     },
     "kwh_needed": {
      "type": "number",
      "title": "Kwh Needed",
      "default": 0.0
     },
     "need_confidence": {
      "anyOf": [
       {
        "type": "string",
        "enum": [
         "declared",
         "history",
         "site"
        ]
       },
       {
        "type": "null"
       }
      ],
      "title": "Need Confidence"
     },
     "max_kw": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ],
      "title": "Max Kw"
     }
    },
    "type": "object",
    "required": [
     "session_id",
     "connector_id",
     "status",
     "plan",
     "eta",
     "price",
     "boost"
    ],
    "title": "SessionOut"
   },
   "SignalHour": {
    "properties": {
     "hour": {
      "type": "integer",
      "title": "Hour"
     },
     "gco2_per_kwh": {
      "type": "number",
      "title": "Gco2 Per Kwh"
     },
     "usd_per_kwh": {
      "type": "number",
      "title": "Usd Per Kwh"
     },
     "kind": {
      "type": "string",
      "enum": [
       "marginal",
       "average"
      ],
      "title": "Kind"
     }
    },
    "type": "object",
    "required": [
     "hour",
     "gco2_per_kwh",
     "usd_per_kwh",
     "kind"
    ],
    "title": "SignalHour"
   },
   "StatusOut": {
    "properties": {
     "mode": {
      "type": "string",
      "enum": [
       "live",
       "cached",
       "tariff",
       "deadline",
       "full"
      ],
      "title": "Mode"
     },
     "last_solve_at": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       },
       {
        "type": "null"
       }
      ],
      "title": "Last Solve At"
     },
     "connectors_active": {
      "type": "integer",
      "title": "Connectors Active"
     },
     "feed_kw": {
      "type": "number",
      "title": "Feed Kw",
      "default": 0.0
     },
     "block_kw": {
      "type": "number",
      "title": "Block Kw",
      "default": 0.0
     },
     "sim_time": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       },
       {
        "type": "null"
       }
      ],
      "title": "Sim Time"
     },
     "safe_share_kw": {
      "type": "number",
      "title": "Safe Share Kw",
      "default": 0.0
     },
     "waiting": {
      "type": "integer",
      "title": "Waiting",
      "default": 0
     },
     "connectors_asap": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "title": "Connectors Asap",
      "default": []
     },
     "n_connectors": {
      "type": "integer",
      "title": "N Connectors",
      "default": 0
     },
     "p_max_kw": {
      "type": "number",
      "title": "P Max Kw",
      "default": 0.0
     },
     "contracted_peak_kw": {
      "type": "number",
      "title": "Contracted Peak Kw",
      "default": 0.0
     },
     "package": {
      "type": "string",
      "enum": [
       "capacity",
       "clean-hours",
       "pilot"
      ],
      "title": "Package",
      "default": "pilot"
     },
     "employee_rate_usd_per_kwh": {
      "type": "number",
      "title": "Employee Rate Usd Per Kwh",
      "default": 0.0
     },
     "driver_share": {
      "type": "number",
      "title": "Driver Share",
      "default": 0.5
     },
     "noonshift_share": {
      "type": "number",
      "title": "Noonshift Share",
      "default": 0.2
     },
     "signal_kind": {
      "anyOf": [
       {
        "type": "string",
        "enum": [
         "marginal",
         "average"
        ]
       },
       {
        "type": "null"
       }
      ],
      "title": "Signal Kind"
     },
     "signal_source": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Signal Source"
     },
     "tariff_name": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Tariff Name"
     },
     "ladder": {
      "additionalProperties": {
       "type": "boolean"
      },
      "type": "object",
      "title": "Ladder",
      "default": {}
     }
    },
    "type": "object",
    "required": [
     "mode",
     "last_solve_at",
     "connectors_active"
    ],
    "title": "StatusOut"
   },
   "Turn": {
    "properties": {
     "role": {
      "type": "string",
      "enum": [
       "user",
       "assistant"
      ],
      "title": "Role"
     },
     "content": {
      "type": "string",
      "maxLength": 4000,
      "title": "Content"
     }
    },
    "type": "object",
    "required": [
     "role",
     "content"
    ],
    "title": "Turn"
   },
   "UrgencyIn": {
    "properties": {
     "level": {
      "type": "string",
      "enum": [
       "now",
       "soon",
       "priority"
      ],
      "title": "Level"
     },
     "leave_at": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       },
       {
        "type": "null"
       }
      ],
      "title": "Leave At"
     }
    },
    "type": "object",
    "required": [
     "level"
    ],
    "title": "UrgencyIn"
   },
   "ValidationError": {
    "properties": {
     "loc": {
      "items": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "integer"
        }
       ]
      },
      "type": "array",
      "title": "Location"
     },
     "msg": {
      "type": "string",
      "title": "Message"
     },
     "type": {
      "type": "string",
      "title": "Error Type"
     }
    },
    "type": "object",
    "required": [
     "loc",
     "msg",
     "type"
    ],
    "title": "ValidationError"
   },
   "Vehicle": {
    "properties": {
     "model": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Model"
     },
     "battery_kwh": {
      "anyOf": [
       {
        "type": "number",
        "exclusiveMinimum": 0.0
       },
       {
        "type": "null"
       }
      ],
      "title": "Battery Kwh"
     },
     "max_kw": {
      "anyOf": [
       {
        "type": "number",
        "exclusiveMinimum": 0.0
       },
       {
        "type": "null"
       }
      ],
      "title": "Max Kw"
     }
    },
    "type": "object",
    "title": "Vehicle",
    "description": "What the driver tells us about the car. All optional: the brain plans with the bay's limit when it knows nothing."
   }
  }
 }
}