{
  "components": {
    "schemas": {
      "AccountAddress": {
        "additionalProperties": false,
        "properties": {
          "city": {
            "maxLength": 120,
            "title": "City",
            "type": "string"
          },
          "country": {
            "maxLength": 120,
            "title": "Country",
            "type": "string"
          },
          "postal": {
            "maxLength": 120,
            "title": "Postal",
            "type": "string"
          },
          "street": {
            "maxLength": 120,
            "title": "Street",
            "type": "string"
          }
        },
        "required": [
          "street",
          "city",
          "postal",
          "country"
        ],
        "title": "AccountAddress",
        "type": "object"
      },
      "AccountApiKeyCreateRequest": {
        "additionalProperties": false,
        "properties": {
          "label": {
            "maxLength": 60,
            "minLength": 1,
            "title": "Label",
            "type": "string"
          }
        },
        "required": [
          "label"
        ],
        "title": "AccountApiKeyCreateRequest",
        "type": "object"
      },
      "AccountApiKeyView": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "label": {
            "title": "Label",
            "type": "string"
          },
          "prefix": {
            "title": "Prefix",
            "type": "string"
          },
          "revoked": {
            "title": "Revoked",
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "prefix",
          "label",
          "created_at",
          "revoked"
        ],
        "title": "AccountApiKeyView",
        "type": "object"
      },
      "AccountAuthResponse": {
        "additionalProperties": false,
        "properties": {
          "account": {
            "$ref": "#/components/schemas/AccountPublicView"
          },
          "token": {
            "title": "Token",
            "type": "string"
          }
        },
        "required": [
          "token",
          "account"
        ],
        "title": "AccountAuthResponse",
        "type": "object"
      },
      "AccountKeyCreateResponse": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "prefix": {
            "title": "Prefix",
            "type": "string"
          }
        },
        "required": [
          "key",
          "id",
          "prefix",
          "message"
        ],
        "title": "AccountKeyCreateResponse",
        "type": "object"
      },
      "AccountKeyDeleteResponse": {
        "additionalProperties": false,
        "properties": {
          "ok": {
            "title": "Ok",
            "type": "boolean"
          }
        },
        "required": [
          "ok"
        ],
        "title": "AccountKeyDeleteResponse",
        "type": "object"
      },
      "AccountKeyEnsureResponse": {
        "additionalProperties": false,
        "description": "Idempotent \"make sure this account has a key\" result. On the FIRST call\n(no active key) it mints one and returns the full secret exactly once\n(`created=True`). On any later call it reports the existing key's prefix\nwithout ever rotating it (`created=False`, `key=None`) -- so a page refresh\ncan never silently replace a working key.",
        "properties": {
          "created": {
            "title": "Created",
            "type": "boolean"
          },
          "key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Key"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "prefix": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prefix"
          }
        },
        "required": [
          "created",
          "message"
        ],
        "title": "AccountKeyEnsureResponse",
        "type": "object"
      },
      "AccountLoginRequest": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "maxLength": 254,
            "title": "Email",
            "type": "string"
          },
          "password": {
            "minLength": 1,
            "title": "Password",
            "type": "string"
          }
        },
        "required": [
          "email",
          "password"
        ],
        "title": "AccountLoginRequest",
        "type": "object"
      },
      "AccountPasswordUpdateRequest": {
        "additionalProperties": false,
        "properties": {
          "current_password": {
            "minLength": 1,
            "title": "Current Password",
            "type": "string"
          },
          "new_password": {
            "minLength": 10,
            "title": "New Password",
            "type": "string"
          }
        },
        "required": [
          "current_password",
          "new_password"
        ],
        "title": "AccountPasswordUpdateRequest",
        "type": "object"
      },
      "AccountProfileUpdateRequest": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "$ref": "#/components/schemas/AccountAddress"
          },
          "business_name": {
            "maxLength": 160,
            "minLength": 1,
            "title": "Business Name",
            "type": "string"
          },
          "contact_name": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Contact Name"
          },
          "current_password": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Password"
          },
          "email": {
            "maxLength": 254,
            "title": "Email",
            "type": "string"
          },
          "industrial_sector": {
            "enum": [
              "discrete_mfg",
              "automotive",
              "process",
              "pharma",
              "food_bev",
              "energy",
              "other"
            ],
            "title": "Industrial Sector",
            "type": "string"
          }
        },
        "required": [
          "email",
          "business_name",
          "address",
          "industrial_sector"
        ],
        "title": "AccountProfileUpdateRequest",
        "type": "object"
      },
      "AccountPublicView": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "$ref": "#/components/schemas/AccountAddress"
          },
          "api_keys": {
            "items": {
              "$ref": "#/components/schemas/AccountApiKeyView"
            },
            "title": "Api Keys",
            "type": "array"
          },
          "api_keys_notice": {
            "default": "",
            "title": "Api Keys Notice",
            "type": "string"
          },
          "business_name": {
            "title": "Business Name",
            "type": "string"
          },
          "contact_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Contact Name"
          },
          "created_at": {
            "title": "Created At",
            "type": "string"
          },
          "email": {
            "title": "Email",
            "type": "string"
          },
          "entitlements": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Entitlements",
            "type": "array"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "industrial_sector": {
            "enum": [
              "discrete_mfg",
              "automotive",
              "process",
              "pharma",
              "food_bev",
              "energy",
              "other"
            ],
            "title": "Industrial Sector",
            "type": "string"
          }
        },
        "required": [
          "id",
          "email",
          "business_name",
          "address",
          "industrial_sector",
          "created_at"
        ],
        "title": "AccountPublicView",
        "type": "object"
      },
      "AccountRecoveryRequest": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "maxLength": 254,
            "title": "Email",
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "title": "AccountRecoveryRequest",
        "type": "object"
      },
      "AccountRecoveryResetRequest": {
        "additionalProperties": false,
        "properties": {
          "new_password": {
            "minLength": 10,
            "title": "New Password",
            "type": "string"
          },
          "token": {
            "maxLength": 4096,
            "minLength": 1,
            "title": "Token",
            "type": "string"
          }
        },
        "required": [
          "token",
          "new_password"
        ],
        "title": "AccountRecoveryResetRequest",
        "type": "object"
      },
      "AccountRecoveryResponse": {
        "additionalProperties": false,
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          },
          "ok": {
            "title": "Ok",
            "type": "boolean"
          }
        },
        "required": [
          "ok",
          "message"
        ],
        "title": "AccountRecoveryResponse",
        "type": "object"
      },
      "AccountSignupRequest": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "$ref": "#/components/schemas/AccountAddress"
          },
          "business_name": {
            "maxLength": 160,
            "minLength": 1,
            "title": "Business Name",
            "type": "string"
          },
          "contact_name": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Contact Name"
          },
          "email": {
            "maxLength": 254,
            "title": "Email",
            "type": "string"
          },
          "industrial_sector": {
            "enum": [
              "discrete_mfg",
              "automotive",
              "process",
              "pharma",
              "food_bev",
              "energy",
              "other"
            ],
            "title": "Industrial Sector",
            "type": "string"
          },
          "password": {
            "minLength": 10,
            "title": "Password",
            "type": "string"
          }
        },
        "required": [
          "email",
          "business_name",
          "address",
          "industrial_sector",
          "password"
        ],
        "title": "AccountSignupRequest",
        "type": "object"
      },
      "AgentCapabilityManifest": {
        "additionalProperties": false,
        "properties": {
          "capabilities": {
            "items": {
              "type": "string"
            },
            "title": "Capabilities",
            "type": "array"
          },
          "capability": {
            "enum": [
              "shift-report",
              "oee-narrator",
              "alarm-triage",
              "maintenance-copilot",
              "root-cause",
              "architect"
            ],
            "title": "Capability",
            "type": "string"
          },
          "endpoint": {
            "title": "Endpoint",
            "type": "string"
          },
          "local_permissions": {
            "items": {
              "type": "string"
            },
            "title": "Local Permissions",
            "type": "array"
          },
          "min_router_version": {
            "title": "Min Router Version",
            "type": "string"
          },
          "requires": {
            "additionalProperties": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "title": "Requires",
            "type": "object"
          },
          "schedule_support": {
            "title": "Schedule Support",
            "type": "boolean"
          },
          "setup": {
            "additionalProperties": true,
            "title": "Setup",
            "type": "object"
          },
          "supported_runtimes": {
            "items": {
              "type": "string"
            },
            "title": "Supported Runtimes",
            "type": "array"
          },
          "version": {
            "title": "Version",
            "type": "string"
          }
        },
        "required": [
          "capability",
          "version",
          "endpoint",
          "min_router_version",
          "supported_runtimes",
          "requires",
          "setup",
          "local_permissions",
          "schedule_support",
          "capabilities"
        ],
        "title": "AgentCapabilityManifest",
        "type": "object"
      },
      "AgentSetupCapturedRecord": {
        "additionalProperties": true,
        "properties": {
          "current": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current"
          },
          "name": {
            "anyOf": [
              {
                "maxLength": 300,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "path": {
            "anyOf": [
              {
                "maxLength": 300,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Path"
          },
          "payload_sample": {
            "title": "Payload Sample"
          },
          "retained": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retained"
          },
          "source_type": {
            "anyOf": [
              {
                "enum": [
                  "mqtt",
                  "historian",
                  "file",
                  "api",
                  "unknown"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Type"
          },
          "tag": {
            "anyOf": [
              {
                "maxLength": 300,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tag"
          },
          "topic": {
            "anyOf": [
              {
                "maxLength": 300,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Topic"
          },
          "ts": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ts"
          }
        },
        "title": "AgentSetupCapturedRecord",
        "type": "object"
      },
      "AgentSetupRequest": {
        "additionalProperties": false,
        "properties": {
          "captured": {
            "items": {
              "$ref": "#/components/schemas/AgentSetupCapturedRecord"
            },
            "maxItems": 5000,
            "title": "Captured",
            "type": "array"
          },
          "site_profile": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AgentSetupSiteProfile"
              },
              {
                "type": "null"
              }
            ]
          },
          "target_agents": {
            "anyOf": [
              {
                "items": {
                  "enum": [
                    "shift-report",
                    "oee-narrator",
                    "alarm-triage",
                    "maintenance-copilot",
                    "root-cause",
                    "architect"
                  ],
                  "type": "string"
                },
                "maxItems": 5,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Target Agents"
          }
        },
        "title": "AgentSetupRequest",
        "type": "object"
      },
      "AgentSetupResponse": {
        "additionalProperties": false,
        "properties": {
          "config": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Config"
          },
          "health": {
            "enum": [
              "healthy",
              "partial",
              "not-ready"
            ],
            "title": "Health",
            "type": "string"
          },
          "manifests": {
            "items": {
              "$ref": "#/components/schemas/AgentCapabilityManifest"
            },
            "title": "Manifests",
            "type": "array"
          },
          "mapping": {
            "additionalProperties": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            "title": "Mapping",
            "type": "object"
          },
          "namespace_recommendations": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Namespace Recommendations",
            "type": "array"
          },
          "next_steps": {
            "items": {
              "type": "string"
            },
            "title": "Next Steps",
            "type": "array"
          },
          "problems": {
            "items": {
              "type": "string"
            },
            "title": "Problems",
            "type": "array"
          },
          "target_agents": {
            "items": {
              "enum": [
                "shift-report",
                "oee-narrator",
                "alarm-triage",
                "maintenance-copilot",
                "root-cause",
                "architect"
              ],
              "type": "string"
            },
            "title": "Target Agents",
            "type": "array"
          }
        },
        "required": [
          "health",
          "target_agents",
          "manifests",
          "mapping"
        ],
        "title": "AgentSetupResponse",
        "type": "object"
      },
      "AgentSetupSiteProfile": {
        "additionalProperties": true,
        "properties": {
          "line": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Line"
          },
          "plant": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Plant"
          },
          "reporting_window": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reporting Window"
          },
          "shift_label": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Shift Label"
          },
          "site": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Site"
          },
          "timezone": {
            "anyOf": [
              {
                "maxLength": 80,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timezone"
          }
        },
        "title": "AgentSetupSiteProfile",
        "type": "object"
      },
      "AgentsCheckoutRequest": {
        "additionalProperties": false,
        "properties": {
          "agents": {
            "items": {
              "enum": [
                "shift-report",
                "oee-narrator",
                "alarm-triage",
                "maintenance-copilot",
                "root-cause",
                "architect"
              ],
              "type": "string"
            },
            "maxItems": 5,
            "title": "Agents",
            "type": "array"
          },
          "site_name": {
            "maxLength": 120,
            "minLength": 1,
            "title": "Site Name",
            "type": "string"
          }
        },
        "required": [
          "site_name"
        ],
        "title": "AgentsCheckoutRequest",
        "type": "object"
      },
      "AgentsCheckoutResponse": {
        "additionalProperties": false,
        "properties": {
          "checkout_url": {
            "title": "Checkout Url",
            "type": "string"
          },
          "fee_breakdown": {
            "items": {
              "$ref": "#/components/schemas/FeeBreakdownItem"
            },
            "title": "Fee Breakdown",
            "type": "array"
          },
          "total_monthly_usd": {
            "title": "Total Monthly Usd",
            "type": "integer"
          }
        },
        "required": [
          "checkout_url",
          "fee_breakdown",
          "total_monthly_usd"
        ],
        "title": "AgentsCheckoutResponse",
        "type": "object"
      },
      "AgentsMutationRequest": {
        "additionalProperties": false,
        "properties": {
          "agents": {
            "items": {
              "enum": [
                "shift-report",
                "oee-narrator",
                "alarm-triage",
                "maintenance-copilot",
                "root-cause",
                "architect"
              ],
              "type": "string"
            },
            "maxItems": 5,
            "title": "Agents",
            "type": "array"
          },
          "site_name": {
            "maxLength": 120,
            "minLength": 1,
            "title": "Site Name",
            "type": "string"
          }
        },
        "required": [
          "site_name",
          "agents"
        ],
        "title": "AgentsMutationRequest",
        "type": "object"
      },
      "AgentsMutationResponse": {
        "additionalProperties": false,
        "properties": {
          "fee_breakdown": {
            "items": {
              "$ref": "#/components/schemas/FeeBreakdownItem"
            },
            "title": "Fee Breakdown",
            "type": "array"
          },
          "total_monthly_usd": {
            "title": "Total Monthly Usd",
            "type": "integer"
          },
          "updated_agents": {
            "items": {
              "enum": [
                "shift-report",
                "oee-narrator",
                "alarm-triage",
                "maintenance-copilot",
                "root-cause",
                "architect"
              ],
              "type": "string"
            },
            "title": "Updated Agents",
            "type": "array"
          }
        },
        "required": [
          "updated_agents",
          "fee_breakdown",
          "total_monthly_usd"
        ],
        "title": "AgentsMutationResponse",
        "type": "object"
      },
      "AiAmbition": {
        "properties": {
          "target": {
            "enum": [
              "pilot",
              "scale",
              "autonomous"
            ],
            "title": "Target",
            "type": "string"
          },
          "text": {
            "maxLength": 500,
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "text",
          "target"
        ],
        "title": "AiAmbition",
        "type": "object"
      },
      "AlarmCluster": {
        "properties": {
          "chattering": {
            "title": "Chattering",
            "type": "boolean"
          },
          "code": {
            "title": "Code",
            "type": "string"
          },
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "duration_minutes": {
            "title": "Duration Minutes",
            "type": "integer"
          },
          "first_ts": {
            "format": "date-time",
            "title": "First Ts",
            "type": "string"
          },
          "last_ts": {
            "format": "date-time",
            "title": "Last Ts",
            "type": "string"
          },
          "priority": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Priority"
          },
          "score": {
            "title": "Score",
            "type": "number"
          },
          "source": {
            "title": "Source",
            "type": "string"
          },
          "text": {
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "source",
          "code",
          "text",
          "count",
          "first_ts",
          "last_ts",
          "duration_minutes",
          "chattering",
          "score"
        ],
        "title": "AlarmCluster",
        "type": "object"
      },
      "AlarmRecord": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "maxLength": 80,
            "title": "Code",
            "type": "string"
          },
          "priority": {
            "anyOf": [
              {
                "maximum": 5.0,
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Priority"
          },
          "source": {
            "maxLength": 120,
            "title": "Source",
            "type": "string"
          },
          "text": {
            "maxLength": 240,
            "title": "Text",
            "type": "string"
          },
          "ts": {
            "format": "date-time",
            "title": "Ts",
            "type": "string"
          }
        },
        "required": [
          "ts",
          "source",
          "code",
          "text"
        ],
        "title": "AlarmRecord",
        "type": "object"
      },
      "AlarmStats": {
        "properties": {
          "chattering_count": {
            "title": "Chattering Count",
            "type": "integer"
          },
          "clustered": {
            "title": "Clustered",
            "type": "integer"
          },
          "flood_windows": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Flood Windows",
            "type": "array"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "total",
          "clustered",
          "chattering_count",
          "flood_windows"
        ],
        "title": "AlarmStats",
        "type": "object"
      },
      "AlarmTriageRequest": {
        "additionalProperties": false,
        "properties": {
          "alarms": {
            "items": {
              "$ref": "#/components/schemas/AlarmRecord"
            },
            "maxItems": 2000,
            "title": "Alarms",
            "type": "array"
          },
          "config": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Config"
          },
          "events": {
            "items": {
              "$ref": "#/components/schemas/ShiftRawEvent"
            },
            "maxItems": 2000,
            "title": "Events",
            "type": "array"
          },
          "site_profile": {
            "$ref": "#/components/schemas/ShiftSiteProfile"
          }
        },
        "required": [
          "site_profile"
        ],
        "title": "AlarmTriageRequest",
        "type": "object"
      },
      "AlarmTriageResponse": {
        "properties": {
          "clusters": {
            "items": {
              "$ref": "#/components/schemas/AlarmCluster"
            },
            "maxItems": 20,
            "title": "Clusters",
            "type": "array"
          },
          "coverage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ShiftReportCoverage"
              },
              {
                "type": "null"
              }
            ]
          },
          "namespace_recommendations": {
            "items": {
              "$ref": "#/components/schemas/ShiftNamespaceRecommendation"
            },
            "maxItems": 20,
            "title": "Namespace Recommendations",
            "type": "array"
          },
          "report_markdown": {
            "title": "Report Markdown",
            "type": "string"
          },
          "stats": {
            "$ref": "#/components/schemas/AlarmStats"
          }
        },
        "required": [
          "report_markdown",
          "clusters",
          "stats"
        ],
        "title": "AlarmTriageResponse",
        "type": "object"
      },
      "ArchitectRequest": {
        "properties": {
          "design": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Design"
          },
          "history": {
            "items": {
              "$ref": "#/components/schemas/ArchitectTurn"
            },
            "title": "History",
            "type": "array"
          },
          "message": {
            "maxLength": 2000,
            "title": "Message",
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "title": "ArchitectRequest",
        "type": "object"
      },
      "ArchitectResponse": {
        "properties": {
          "design": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Design"
          },
          "quota": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quota"
          },
          "reply": {
            "title": "Reply",
            "type": "string"
          }
        },
        "required": [
          "reply"
        ],
        "title": "ArchitectResponse",
        "type": "object"
      },
      "ArchitectTurn": {
        "properties": {
          "role": {
            "title": "Role",
            "type": "string"
          },
          "text": {
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "role",
          "text"
        ],
        "title": "ArchitectTurn",
        "type": "object"
      },
      "BillingPortalResponse": {
        "additionalProperties": false,
        "properties": {
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "title": "BillingPortalResponse",
        "type": "object"
      },
      "CapabilityExecution": {
        "description": "Where a capability participates; more than one flag may be true.",
        "properties": {
          "browser": {
            "default": false,
            "title": "Browser",
            "type": "boolean"
          },
          "cloud": {
            "default": false,
            "title": "Cloud",
            "type": "boolean"
          },
          "customer_local": {
            "default": false,
            "title": "Customer Local",
            "type": "boolean"
          }
        },
        "title": "CapabilityExecution",
        "type": "object"
      },
      "CartCheckoutItem": {
        "additionalProperties": false,
        "properties": {
          "agents": {
            "anyOf": [
              {
                "items": {
                  "enum": [
                    "shift-report",
                    "oee-narrator",
                    "alarm-triage",
                    "maintenance-copilot",
                    "root-cause",
                    "architect"
                  ],
                  "type": "string"
                },
                "maxItems": 5,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Agents"
          },
          "client_ref": {
            "anyOf": [
              {
                "maxLength": 160,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client Ref"
          },
          "product": {
            "maxLength": 80,
            "minLength": 1,
            "title": "Product",
            "type": "string"
          },
          "site_name": {
            "anyOf": [
              {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Site Name"
          }
        },
        "required": [
          "product"
        ],
        "title": "CartCheckoutItem",
        "type": "object"
      },
      "CartCheckoutRequest": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/CartCheckoutItem"
            },
            "minItems": 1,
            "title": "Items",
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "title": "CartCheckoutRequest",
        "type": "object"
      },
      "CartCheckoutResponse": {
        "additionalProperties": false,
        "properties": {
          "sessions": {
            "items": {
              "$ref": "#/components/schemas/CartCheckoutSession"
            },
            "title": "Sessions",
            "type": "array"
          }
        },
        "required": [
          "sessions"
        ],
        "title": "CartCheckoutResponse",
        "type": "object"
      },
      "CartCheckoutSession": {
        "additionalProperties": false,
        "properties": {
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "title": "CartCheckoutSession",
        "type": "object"
      },
      "ChatRequest": {
        "properties": {
          "history": {
            "items": {
              "$ref": "#/components/schemas/ChatTurn"
            },
            "title": "History",
            "type": "array"
          },
          "message": {
            "title": "Message",
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "title": "ChatRequest",
        "type": "object"
      },
      "ChatResponse": {
        "properties": {
          "quota": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quota"
          },
          "reply": {
            "title": "Reply",
            "type": "string"
          },
          "routing": {
            "$ref": "#/components/schemas/ChatRouting"
          },
          "scope": {
            "default": "preliminary",
            "title": "Scope",
            "type": "string"
          }
        },
        "required": [
          "reply"
        ],
        "title": "ChatResponse",
        "type": "object"
      },
      "ChatRouting": {
        "additionalProperties": false,
        "description": "Additive routing provenance returned with chat replies.",
        "properties": {
          "class": {
            "default": "advisory",
            "title": "Class",
            "type": "string"
          },
          "needs_local_evidence": {
            "default": false,
            "title": "Needs Local Evidence",
            "type": "boolean"
          },
          "source": {
            "default": "dxpert",
            "title": "Source",
            "type": "string"
          }
        },
        "title": "ChatRouting",
        "type": "object"
      },
      "ChatTurn": {
        "properties": {
          "role": {
            "title": "Role",
            "type": "string"
          },
          "text": {
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "role",
          "text"
        ],
        "title": "ChatTurn",
        "type": "object"
      },
      "CheckoutRequest": {
        "additionalProperties": false,
        "properties": {
          "client_ref": {
            "title": "Client Ref",
            "type": "string"
          },
          "site_name": {
            "anyOf": [
              {
                "maxLength": 120,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Site Name"
          }
        },
        "required": [
          "client_ref"
        ],
        "title": "CheckoutRequest",
        "type": "object"
      },
      "CheckoutResponse": {
        "additionalProperties": false,
        "properties": {
          "checkout_url": {
            "title": "Checkout Url",
            "type": "string"
          }
        },
        "required": [
          "checkout_url"
        ],
        "title": "CheckoutResponse",
        "type": "object"
      },
      "CsvToBundleRequest": {
        "additionalProperties": false,
        "properties": {
          "csv_text": {
            "maxLength": 1000000,
            "title": "Csv Text",
            "type": "string"
          },
          "kind": {
            "title": "Kind",
            "type": "string"
          },
          "site_profile": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Site Profile"
          }
        },
        "required": [
          "csv_text",
          "kind"
        ],
        "title": "CsvToBundleRequest",
        "type": "object"
      },
      "DiagnosticResult": {
        "properties": {
          "report_markdown": {
            "title": "Report Markdown",
            "type": "string"
          },
          "scope": {
            "default": "preliminary",
            "title": "Scope",
            "type": "string"
          },
          "scores": {
            "$ref": "#/components/schemas/ScoresModel"
          }
        },
        "required": [
          "scores",
          "report_markdown"
        ],
        "title": "DiagnosticResult",
        "type": "object"
      },
      "FeeBreakdownItem": {
        "additionalProperties": false,
        "properties": {
          "label": {
            "title": "Label",
            "type": "string"
          },
          "monthly_usd": {
            "title": "Monthly Usd",
            "type": "integer"
          }
        },
        "required": [
          "label",
          "monthly_usd"
        ],
        "title": "FeeBreakdownItem",
        "type": "object"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "title": "Detail",
            "type": "array"
          }
        },
        "title": "HTTPValidationError",
        "type": "object"
      },
      "IntakeModel": {
        "additionalProperties": false,
        "description": "The 16-question intake. Field order matches the spec table.",
        "properties": {
          "ai_ambition": {
            "$ref": "#/components/schemas/AiAmbition"
          },
          "common_model": {
            "enum": [
              "none",
              "per_system",
              "partial",
              "unified"
            ],
            "title": "Common Model",
            "type": "string"
          },
          "data_off_floor": {
            "enum": [
              "manual",
              "scada_only",
              "opcua",
              "mqtt_sparkplug",
              "mixed"
            ],
            "title": "Data Off Floor",
            "type": "string"
          },
          "data_ownership": {
            "enum": [
              "tribal",
              "unclear",
              "owned_governed"
            ],
            "title": "Data Ownership",
            "type": "string"
          },
          "data_ready_for_use_case": {
            "enum": [
              "no",
              "partial",
              "yes"
            ],
            "title": "Data Ready For Use Case",
            "type": "string"
          },
          "edge_vs_poll": {
            "enum": [
              "poll",
              "mixed",
              "edge_push"
            ],
            "title": "Edge Vs Poll",
            "type": "string"
          },
          "historian_depth": {
            "enum": [
              "none",
              "local",
              "central_untrusted",
              "central_trusted"
            ],
            "title": "Historian Depth",
            "type": "string"
          },
          "otit_security": {
            "enum": [
              "ad_hoc",
              "partial",
              "governed"
            ],
            "title": "Otit Security",
            "type": "string"
          },
          "personal_stakes": {
            "maxLength": 500,
            "title": "Personal Stakes",
            "type": "string"
          },
          "politically_useful": {
            "maxLength": 500,
            "title": "Politically Useful",
            "type": "string"
          },
          "prior_attempts": {
            "maxLength": 1000,
            "title": "Prior Attempts",
            "type": "string"
          },
          "realtime_visibility": {
            "enum": [
              "none",
              "on_request",
              "partial",
              "single_pane"
            ],
            "title": "Realtime Visibility",
            "type": "string"
          },
          "sector": {
            "enum": [
              "discrete_mfg",
              "automotive",
              "process",
              "pharma",
              "food_bev",
              "energy",
              "other"
            ],
            "title": "Sector",
            "type": "string"
          },
          "site_count": {
            "minimum": 1.0,
            "title": "Site Count",
            "type": "integer"
          },
          "uns_state": {
            "enum": [
              "none",
              "point_to_point",
              "partial",
              "governed_uns"
            ],
            "title": "Uns State",
            "type": "string"
          },
          "who_they_trust": {
            "maxLength": 300,
            "title": "Who They Trust",
            "type": "string"
          }
        },
        "required": [
          "sector",
          "site_count",
          "data_off_floor",
          "common_model",
          "realtime_visibility",
          "historian_depth",
          "edge_vs_poll",
          "uns_state",
          "data_ready_for_use_case",
          "otit_security",
          "data_ownership",
          "ai_ambition",
          "prior_attempts",
          "personal_stakes",
          "who_they_trust",
          "politically_useful"
        ],
        "title": "IntakeModel",
        "type": "object"
      },
      "MaintenanceCopilotRequest": {
        "additionalProperties": false,
        "properties": {
          "asset": {
            "maxLength": 120,
            "title": "Asset",
            "type": "string"
          },
          "config": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Config"
          },
          "history": {
            "items": {
              "$ref": "#/components/schemas/MaintenanceHistoryRecord"
            },
            "maxItems": 500,
            "title": "History",
            "type": "array"
          },
          "messages": {
            "items": {
              "$ref": "#/components/schemas/MaintenanceMessage"
            },
            "maxItems": 20,
            "title": "Messages",
            "type": "array"
          },
          "recent_events": {
            "items": {
              "$ref": "#/components/schemas/ShiftRawEvent"
            },
            "maxItems": 500,
            "title": "Recent Events",
            "type": "array"
          },
          "site_profile": {
            "$ref": "#/components/schemas/ShiftSiteProfile"
          }
        },
        "required": [
          "site_profile",
          "asset",
          "history",
          "messages"
        ],
        "title": "MaintenanceCopilotRequest",
        "type": "object"
      },
      "MaintenanceCopilotResponse": {
        "properties": {
          "coverage": {
            "$ref": "#/components/schemas/MaintenanceCoverage"
          },
          "namespace_recommendations": {
            "items": {
              "$ref": "#/components/schemas/ShiftNamespaceRecommendation"
            },
            "maxItems": 20,
            "title": "Namespace Recommendations",
            "type": "array"
          },
          "recurrences": {
            "items": {
              "$ref": "#/components/schemas/MaintenanceRecurrence"
            },
            "title": "Recurrences",
            "type": "array"
          },
          "reply": {
            "title": "Reply",
            "type": "string"
          }
        },
        "required": [
          "reply",
          "recurrences",
          "coverage"
        ],
        "title": "MaintenanceCopilotResponse",
        "type": "object"
      },
      "MaintenanceCoverage": {
        "properties": {
          "gaps": {
            "items": {
              "type": "string"
            },
            "title": "Gaps",
            "type": "array"
          },
          "history_records": {
            "title": "History Records",
            "type": "integer"
          },
          "messages": {
            "title": "Messages",
            "type": "integer"
          },
          "mode": {
            "const": "structured",
            "title": "Mode",
            "type": "string"
          },
          "recent_events": {
            "title": "Recent Events",
            "type": "integer"
          }
        },
        "required": [
          "mode",
          "history_records",
          "recent_events",
          "messages"
        ],
        "title": "MaintenanceCoverage",
        "type": "object"
      },
      "MaintenanceHistoryRecord": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "maxLength": 400,
            "title": "Description",
            "type": "string"
          },
          "kind": {
            "enum": [
              "work_order",
              "fault",
              "note",
              "inspection"
            ],
            "title": "Kind",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "maxLength": 60,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "ts": {
            "format": "date-time",
            "title": "Ts",
            "type": "string"
          }
        },
        "required": [
          "ts",
          "kind",
          "description"
        ],
        "title": "MaintenanceHistoryRecord",
        "type": "object"
      },
      "MaintenanceMessage": {
        "additionalProperties": false,
        "properties": {
          "content": {
            "maxLength": 2000,
            "title": "Content",
            "type": "string"
          },
          "role": {
            "enum": [
              "user",
              "assistant"
            ],
            "title": "Role",
            "type": "string"
          }
        },
        "required": [
          "role",
          "content"
        ],
        "title": "MaintenanceMessage",
        "type": "object"
      },
      "MaintenanceRecurrence": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "descriptions": {
            "items": {
              "type": "string"
            },
            "title": "Descriptions",
            "type": "array"
          },
          "first_ts": {
            "format": "date-time",
            "title": "First Ts",
            "type": "string"
          },
          "last_ts": {
            "format": "date-time",
            "title": "Last Ts",
            "type": "string"
          },
          "similarity": {
            "title": "Similarity",
            "type": "number"
          },
          "theme": {
            "title": "Theme",
            "type": "string"
          }
        },
        "required": [
          "theme",
          "count",
          "first_ts",
          "last_ts",
          "descriptions",
          "similarity"
        ],
        "title": "MaintenanceRecurrence",
        "type": "object"
      },
      "OeeCellKpis": {
        "properties": {
          "availability": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Availability"
          },
          "downtime_minutes": {
            "title": "Downtime Minutes",
            "type": "integer"
          },
          "good_count": {
            "title": "Good Count",
            "type": "integer"
          },
          "missing": {
            "items": {
              "type": "string"
            },
            "title": "Missing",
            "type": "array"
          },
          "oee": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Oee"
          },
          "performance": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Performance"
          },
          "quality": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Quality"
          },
          "runtime_minutes": {
            "title": "Runtime Minutes",
            "type": "integer"
          },
          "scrap_count": {
            "title": "Scrap Count",
            "type": "integer"
          }
        },
        "required": [
          "availability",
          "performance",
          "quality",
          "oee",
          "good_count",
          "scrap_count",
          "downtime_minutes",
          "runtime_minutes"
        ],
        "title": "OeeCellKpis",
        "type": "object"
      },
      "OeeKpis": {
        "properties": {
          "cells": {
            "additionalProperties": {
              "$ref": "#/components/schemas/OeeCellKpis"
            },
            "title": "Cells",
            "type": "object"
          },
          "total": {
            "$ref": "#/components/schemas/OeeCellKpis"
          }
        },
        "required": [
          "cells",
          "total"
        ],
        "title": "OeeKpis",
        "type": "object"
      },
      "OeeNarratorRequest": {
        "additionalProperties": false,
        "properties": {
          "config": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Config"
          },
          "downtime": {
            "items": {
              "$ref": "#/components/schemas/ShiftDowntimeRecord"
            },
            "maxItems": 500,
            "title": "Downtime",
            "type": "array"
          },
          "events": {
            "items": {
              "$ref": "#/components/schemas/ShiftRawEvent"
            },
            "maxItems": 2000,
            "title": "Events",
            "type": "array"
          },
          "ideal_rate_per_min": {
            "additionalProperties": {
              "type": "number"
            },
            "title": "Ideal Rate Per Min",
            "type": "object"
          },
          "planned_minutes": {
            "exclusiveMinimum": 0.0,
            "title": "Planned Minutes",
            "type": "integer"
          },
          "production": {
            "items": {
              "$ref": "#/components/schemas/ShiftProductionRecord"
            },
            "maxItems": 500,
            "title": "Production",
            "type": "array"
          },
          "quality": {
            "items": {
              "$ref": "#/components/schemas/ShiftQualityRecord"
            },
            "maxItems": 500,
            "title": "Quality",
            "type": "array"
          },
          "question": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Question"
          },
          "site_profile": {
            "$ref": "#/components/schemas/ShiftSiteProfile"
          }
        },
        "required": [
          "site_profile",
          "planned_minutes"
        ],
        "title": "OeeNarratorRequest",
        "type": "object"
      },
      "OeeNarratorResponse": {
        "properties": {
          "coverage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ShiftReportCoverage"
              },
              {
                "type": "null"
              }
            ]
          },
          "kpis": {
            "$ref": "#/components/schemas/OeeKpis"
          },
          "namespace_recommendations": {
            "items": {
              "$ref": "#/components/schemas/ShiftNamespaceRecommendation"
            },
            "maxItems": 20,
            "title": "Namespace Recommendations",
            "type": "array"
          },
          "report_markdown": {
            "title": "Report Markdown",
            "type": "string"
          }
        },
        "required": [
          "report_markdown",
          "kpis"
        ],
        "title": "OeeNarratorResponse",
        "type": "object"
      },
      "RoadmapIntakeDraftRequest": {
        "additionalProperties": false,
        "properties": {
          "answers": {
            "additionalProperties": true,
            "title": "Answers",
            "type": "object"
          }
        },
        "title": "RoadmapIntakeDraftRequest",
        "type": "object"
      },
      "RootCauseCandidate": {
        "properties": {
          "cause": {
            "title": "Cause",
            "type": "string"
          },
          "confidence": {
            "enum": [
              "high",
              "medium",
              "low"
            ],
            "title": "Confidence",
            "type": "string"
          },
          "evidence_ids": {
            "items": {
              "type": "string"
            },
            "title": "Evidence Ids",
            "type": "array"
          },
          "rationale": {
            "title": "Rationale",
            "type": "string"
          },
          "score": {
            "title": "Score",
            "type": "number"
          },
          "source": {
            "title": "Source",
            "type": "string"
          }
        },
        "required": [
          "cause",
          "source",
          "score",
          "confidence",
          "evidence_ids",
          "rationale"
        ],
        "title": "RootCauseCandidate",
        "type": "object"
      },
      "RootCauseCoverage": {
        "properties": {
          "change_points": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Change Points",
            "type": "array"
          },
          "gaps": {
            "items": {
              "type": "string"
            },
            "title": "Gaps",
            "type": "array"
          },
          "mode": {
            "const": "structured",
            "title": "Mode",
            "type": "string"
          },
          "records_baseline": {
            "additionalProperties": {
              "type": "integer"
            },
            "title": "Records Baseline",
            "type": "object"
          },
          "records_in_window": {
            "additionalProperties": {
              "type": "integer"
            },
            "title": "Records In Window",
            "type": "object"
          }
        },
        "required": [
          "mode",
          "records_in_window",
          "records_baseline"
        ],
        "title": "RootCauseCoverage",
        "type": "object"
      },
      "RootCauseEvidenceRow": {
        "properties": {
          "detail": {
            "title": "Detail",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "label": {
            "title": "Label",
            "type": "string"
          },
          "source": {
            "title": "Source",
            "type": "string"
          },
          "ts": {
            "format": "date-time",
            "title": "Ts",
            "type": "string"
          },
          "value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Value"
          }
        },
        "required": [
          "id",
          "source",
          "ts",
          "label",
          "detail"
        ],
        "title": "RootCauseEvidenceRow",
        "type": "object"
      },
      "RootCauseGenealogyRecord": {
        "additionalProperties": false,
        "properties": {
          "cell": {
            "maxLength": 120,
            "title": "Cell",
            "type": "string"
          },
          "lot": {
            "maxLength": 120,
            "title": "Lot",
            "type": "string"
          },
          "material": {
            "maxLength": 120,
            "title": "Material",
            "type": "string"
          },
          "supplier": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Supplier"
          },
          "ts": {
            "format": "date-time",
            "title": "Ts",
            "type": "string"
          }
        },
        "required": [
          "ts",
          "lot",
          "material",
          "cell"
        ],
        "title": "RootCauseGenealogyRecord",
        "type": "object"
      },
      "RootCauseRequest": {
        "additionalProperties": false,
        "properties": {
          "alarms": {
            "items": {
              "$ref": "#/components/schemas/AlarmRecord"
            },
            "maxItems": 2000,
            "title": "Alarms",
            "type": "array"
          },
          "config": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Config"
          },
          "downtime": {
            "items": {
              "$ref": "#/components/schemas/ShiftDowntimeRecord"
            },
            "maxItems": 500,
            "title": "Downtime",
            "type": "array"
          },
          "events": {
            "items": {
              "$ref": "#/components/schemas/ShiftRawEvent"
            },
            "maxItems": 2000,
            "title": "Events",
            "type": "array"
          },
          "genealogy": {
            "items": {
              "$ref": "#/components/schemas/RootCauseGenealogyRecord"
            },
            "maxItems": 200,
            "title": "Genealogy",
            "type": "array"
          },
          "notes": {
            "items": {
              "maxLength": 500,
              "type": "string"
            },
            "maxItems": 20,
            "title": "Notes",
            "type": "array"
          },
          "production": {
            "items": {
              "$ref": "#/components/schemas/ShiftProductionRecord"
            },
            "maxItems": 500,
            "title": "Production",
            "type": "array"
          },
          "quality": {
            "items": {
              "$ref": "#/components/schemas/ShiftQualityRecord"
            },
            "maxItems": 500,
            "title": "Quality",
            "type": "array"
          },
          "question": {
            "maxLength": 300,
            "title": "Question",
            "type": "string"
          },
          "series": {
            "items": {
              "$ref": "#/components/schemas/RootCauseSeries"
            },
            "maxItems": 50,
            "title": "Series",
            "type": "array"
          },
          "site_profile": {
            "$ref": "#/components/schemas/RootCauseSiteProfile"
          }
        },
        "required": [
          "site_profile",
          "question"
        ],
        "title": "RootCauseRequest",
        "type": "object"
      },
      "RootCauseResponse": {
        "properties": {
          "candidates": {
            "items": {
              "$ref": "#/components/schemas/RootCauseCandidate"
            },
            "maxItems": 10,
            "title": "Candidates",
            "type": "array"
          },
          "coverage": {
            "$ref": "#/components/schemas/RootCauseCoverage"
          },
          "evidence": {
            "items": {
              "$ref": "#/components/schemas/RootCauseEvidenceRow"
            },
            "title": "Evidence",
            "type": "array"
          },
          "namespace_recommendations": {
            "items": {
              "$ref": "#/components/schemas/ShiftNamespaceRecommendation"
            },
            "maxItems": 20,
            "title": "Namespace Recommendations",
            "type": "array"
          },
          "report_markdown": {
            "title": "Report Markdown",
            "type": "string"
          }
        },
        "required": [
          "report_markdown",
          "candidates",
          "evidence",
          "coverage"
        ],
        "title": "RootCauseResponse",
        "type": "object"
      },
      "RootCauseSeries": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "maxLength": 120,
            "title": "Name",
            "type": "string"
          },
          "points": {
            "items": {
              "$ref": "#/components/schemas/RootCauseSeriesPoint"
            },
            "maxItems": 500,
            "title": "Points",
            "type": "array"
          },
          "unit": {
            "anyOf": [
              {
                "maxLength": 40,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Unit"
          }
        },
        "required": [
          "name",
          "points"
        ],
        "title": "RootCauseSeries",
        "type": "object"
      },
      "RootCauseSeriesPoint": {
        "additionalProperties": false,
        "properties": {
          "ts": {
            "format": "date-time",
            "title": "Ts",
            "type": "string"
          },
          "value": {
            "title": "Value",
            "type": "number"
          }
        },
        "required": [
          "ts",
          "value"
        ],
        "title": "RootCauseSeriesPoint",
        "type": "object"
      },
      "RootCauseSiteProfile": {
        "additionalProperties": false,
        "properties": {
          "baseline_end": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Baseline End"
          },
          "baseline_start": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Baseline Start"
          },
          "language": {
            "default": "en",
            "enum": [
              "en",
              "fr",
              "de",
              "es"
            ],
            "title": "Language",
            "type": "string"
          },
          "line": {
            "maxLength": 120,
            "title": "Line",
            "type": "string"
          },
          "plant": {
            "maxLength": 120,
            "title": "Plant",
            "type": "string"
          },
          "shift_label": {
            "maxLength": 120,
            "title": "Shift Label",
            "type": "string"
          },
          "window_end": {
            "format": "date-time",
            "title": "Window End",
            "type": "string"
          },
          "window_start": {
            "format": "date-time",
            "title": "Window Start",
            "type": "string"
          }
        },
        "required": [
          "plant",
          "line",
          "shift_label",
          "window_start",
          "window_end"
        ],
        "title": "RootCauseSiteProfile",
        "type": "object"
      },
      "ScoresModel": {
        "properties": {
          "acatech_stage": {
            "title": "Acatech Stage",
            "type": "integer"
          },
          "ai_readiness_gate": {
            "items": {
              "type": "string"
            },
            "title": "Ai Readiness Gate",
            "type": "array"
          },
          "axes": {
            "additionalProperties": {
              "type": "integer"
            },
            "title": "Axes",
            "type": "object"
          },
          "confidence": {
            "title": "Confidence",
            "type": "number"
          }
        },
        "required": [
          "axes",
          "acatech_stage",
          "ai_readiness_gate",
          "confidence"
        ],
        "title": "ScoresModel",
        "type": "object"
      },
      "ShiftDowntimeRecord": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "maxLength": 120,
            "title": "Category",
            "type": "string"
          },
          "cell": {
            "maxLength": 120,
            "title": "Cell",
            "type": "string"
          },
          "end": {
            "format": "date-time",
            "title": "End",
            "type": "string"
          },
          "reason": {
            "maxLength": 240,
            "title": "Reason",
            "type": "string"
          },
          "start": {
            "format": "date-time",
            "title": "Start",
            "type": "string"
          }
        },
        "required": [
          "start",
          "end",
          "cell",
          "reason",
          "category"
        ],
        "title": "ShiftDowntimeRecord",
        "type": "object"
      },
      "ShiftNamespaceRecommendation": {
        "properties": {
          "gap": {
            "title": "Gap",
            "type": "string"
          },
          "recommended_topics": {
            "items": {
              "type": "string"
            },
            "title": "Recommended Topics",
            "type": "array"
          },
          "unlocks": {
            "title": "Unlocks",
            "type": "string"
          }
        },
        "required": [
          "gap",
          "recommended_topics",
          "unlocks"
        ],
        "title": "ShiftNamespaceRecommendation",
        "type": "object"
      },
      "ShiftProductionRecord": {
        "additionalProperties": false,
        "properties": {
          "cell": {
            "maxLength": 120,
            "title": "Cell",
            "type": "string"
          },
          "good_count": {
            "minimum": 0.0,
            "title": "Good Count",
            "type": "integer"
          },
          "scrap_count": {
            "minimum": 0.0,
            "title": "Scrap Count",
            "type": "integer"
          },
          "ts": {
            "format": "date-time",
            "title": "Ts",
            "type": "string"
          }
        },
        "required": [
          "ts",
          "cell",
          "good_count",
          "scrap_count"
        ],
        "title": "ShiftProductionRecord",
        "type": "object"
      },
      "ShiftQualityRecord": {
        "additionalProperties": false,
        "properties": {
          "cell": {
            "maxLength": 120,
            "title": "Cell",
            "type": "string"
          },
          "disposition": {
            "maxLength": 240,
            "title": "Disposition",
            "type": "string"
          },
          "issue": {
            "maxLength": 240,
            "title": "Issue",
            "type": "string"
          },
          "ts": {
            "format": "date-time",
            "title": "Ts",
            "type": "string"
          }
        },
        "required": [
          "ts",
          "cell",
          "issue",
          "disposition"
        ],
        "title": "ShiftQualityRecord",
        "type": "object"
      },
      "ShiftRawEvent": {
        "additionalProperties": false,
        "properties": {
          "payload": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "integer"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              },
              {
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "integer"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payload"
          },
          "topic": {
            "maxLength": 300,
            "title": "Topic",
            "type": "string"
          },
          "ts": {
            "format": "date-time",
            "title": "Ts",
            "type": "string"
          }
        },
        "required": [
          "topic",
          "ts",
          "payload"
        ],
        "title": "ShiftRawEvent",
        "type": "object"
      },
      "ShiftReportCoverage": {
        "properties": {
          "mode": {
            "enum": [
              "structured",
              "discovery",
              "config"
            ],
            "title": "Mode",
            "type": "string"
          },
          "roles_found": {
            "items": {
              "type": "string"
            },
            "title": "Roles Found",
            "type": "array"
          },
          "roles_missing": {
            "items": {
              "type": "string"
            },
            "title": "Roles Missing",
            "type": "array"
          },
          "topics_ignored": {
            "title": "Topics Ignored",
            "type": "integer"
          },
          "topics_used": {
            "title": "Topics Used",
            "type": "integer"
          }
        },
        "required": [
          "mode",
          "roles_found",
          "roles_missing",
          "topics_used",
          "topics_ignored"
        ],
        "title": "ShiftReportCoverage",
        "type": "object"
      },
      "ShiftReportRequest": {
        "additionalProperties": false,
        "properties": {
          "config": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Config"
          },
          "downtime": {
            "items": {
              "$ref": "#/components/schemas/ShiftDowntimeRecord"
            },
            "maxItems": 500,
            "title": "Downtime",
            "type": "array"
          },
          "events": {
            "items": {
              "$ref": "#/components/schemas/ShiftRawEvent"
            },
            "maxItems": 2000,
            "title": "Events",
            "type": "array"
          },
          "notes": {
            "items": {
              "maxLength": 500,
              "type": "string"
            },
            "maxItems": 20,
            "title": "Notes",
            "type": "array"
          },
          "production": {
            "items": {
              "$ref": "#/components/schemas/ShiftProductionRecord"
            },
            "maxItems": 500,
            "title": "Production",
            "type": "array"
          },
          "quality": {
            "items": {
              "$ref": "#/components/schemas/ShiftQualityRecord"
            },
            "maxItems": 500,
            "title": "Quality",
            "type": "array"
          },
          "site_profile": {
            "$ref": "#/components/schemas/ShiftSiteProfile"
          }
        },
        "required": [
          "site_profile"
        ],
        "title": "ShiftReportRequest",
        "type": "object"
      },
      "ShiftReportResponse": {
        "properties": {
          "coverage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ShiftReportCoverage"
              },
              {
                "type": "null"
              }
            ]
          },
          "namespace_recommendations": {
            "items": {
              "$ref": "#/components/schemas/ShiftNamespaceRecommendation"
            },
            "maxItems": 20,
            "title": "Namespace Recommendations",
            "type": "array"
          },
          "report_markdown": {
            "title": "Report Markdown",
            "type": "string"
          },
          "stats": {
            "$ref": "#/components/schemas/ShiftReportStats"
          }
        },
        "required": [
          "report_markdown",
          "stats"
        ],
        "title": "ShiftReportResponse",
        "type": "object"
      },
      "ShiftReportStats": {
        "properties": {
          "downtime_minutes": {
            "title": "Downtime Minutes",
            "type": "integer"
          },
          "downtime_records": {
            "title": "Downtime Records",
            "type": "integer"
          },
          "production_records": {
            "title": "Production Records",
            "type": "integer"
          },
          "quality_records": {
            "title": "Quality Records",
            "type": "integer"
          }
        },
        "required": [
          "production_records",
          "downtime_records",
          "quality_records",
          "downtime_minutes"
        ],
        "title": "ShiftReportStats",
        "type": "object"
      },
      "ShiftSiteProfile": {
        "additionalProperties": false,
        "properties": {
          "language": {
            "default": "en",
            "enum": [
              "en",
              "fr",
              "de",
              "es"
            ],
            "title": "Language",
            "type": "string"
          },
          "line": {
            "maxLength": 120,
            "title": "Line",
            "type": "string"
          },
          "plant": {
            "maxLength": 120,
            "title": "Plant",
            "type": "string"
          },
          "shift_label": {
            "maxLength": 120,
            "title": "Shift Label",
            "type": "string"
          },
          "window_end": {
            "format": "date-time",
            "title": "Window End",
            "type": "string"
          },
          "window_start": {
            "format": "date-time",
            "title": "Window Start",
            "type": "string"
          }
        },
        "required": [
          "plant",
          "line",
          "shift_label",
          "window_start",
          "window_end"
        ],
        "title": "ShiftSiteProfile",
        "type": "object"
      },
      "SystemCapabilitiesManifest": {
        "description": "The response shape served by ``/system-capabilities.json``.",
        "properties": {
          "capabilities": {
            "items": {
              "$ref": "#/components/schemas/SystemCapability"
            },
            "title": "Capabilities",
            "type": "array"
          },
          "schema_version": {
            "default": "1.1",
            "title": "Schema Version",
            "type": "string"
          }
        },
        "required": [
          "capabilities"
        ],
        "title": "SystemCapabilitiesManifest",
        "type": "object"
      },
      "SystemCapability": {
        "properties": {
          "api_endpoint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Api Endpoint"
          },
          "entitlement_product_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Entitlement Product Id"
          },
          "execution": {
            "$ref": "#/components/schemas/CapabilityExecution"
          },
          "history_support": {
            "title": "History Support",
            "type": "boolean"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "inputs_summary": {
            "title": "Inputs Summary",
            "type": "string"
          },
          "local_permissions": {
            "items": {
              "type": "string"
            },
            "title": "Local Permissions",
            "type": "array"
          },
          "outputs_summary": {
            "title": "Outputs Summary",
            "type": "string"
          },
          "scheduling_support": {
            "title": "Scheduling Support",
            "type": "boolean"
          },
          "setup_workflow": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Setup Workflow"
          },
          "supported_sources": {
            "items": {
              "type": "string"
            },
            "title": "Supported Sources",
            "type": "array"
          },
          "trial_eligible": {
            "title": "Trial Eligible",
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "execution",
          "trial_eligible",
          "inputs_summary",
          "outputs_summary",
          "history_support",
          "scheduling_support"
        ],
        "title": "SystemCapability",
        "type": "object"
      },
      "TrialActivateRequest": {
        "additionalProperties": false,
        "properties": {
          "agent": {
            "title": "Agent",
            "type": "string"
          }
        },
        "required": [
          "agent"
        ],
        "title": "TrialActivateRequest",
        "type": "object"
      },
      "ValidationError": {
        "properties": {
          "ctx": {
            "title": "Context",
            "type": "object"
          },
          "input": {
            "title": "Input"
          },
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "title": "Location",
            "type": "array"
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        },
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError",
        "type": "object"
      }
    },
    "securitySchemes": {
      "AgentsToken": {
        "in": "header",
        "name": "X-Agents-Token",
        "type": "apiKey"
      },
      "ApiKey": {
        "in": "header",
        "name": "X-Api-Key",
        "type": "apiKey"
      },
      "BearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "contact": {
      "name": "dxpert.ai",
      "url": "https://dxpert.ai/api.html"
    },
    "description": "Vendor-neutral industrial AI-readiness scoring, UNS namespace generation, and UNS Agents (shift-report, OEE narrator, alarm-triage, maintenance-copilot, root-cause). This schema is the same one published at https://dxpert.ai/openapi.json (regenerated from this app on every site build -- see scripts/generate_openapi.py) so third-party and agent integrations never see a stale contract. See https://dxpert.ai/llms.txt for the plain-language agent guide.",
    "title": "dxpert.ai API",
    "version": "1.2.0",
    "x-agent-catalog": "https://opwhcervi3.execute-api.ca-central-1.amazonaws.com/api/agents/catalog",
    "x-llms-txt": "https://dxpert.ai/llms.txt"
  },
  "openapi": "3.1.0",
  "paths": {
    "/api/account/agents/add": {
      "post": {
        "description": "Adds agents to an existing site subscription through Stripe and updates the account entitlement. Bearer authentication is required; it changes billing and entitlement state but consumes no trial transaction or quota and sends no email here.",
        "operationId": "account_agents_add_api_account_agents_add_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentsMutationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentsMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Agents Add"
      }
    },
    "/api/account/agents/remove": {
      "post": {
        "description": "Removes agents from an existing site subscription through Stripe and updates the account entitlement. Bearer authentication is required; it changes billing and entitlement state but consumes no trial transaction or quota and sends no email here.",
        "operationId": "account_agents_remove_api_account_agents_remove_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentsMutationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentsMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Agents Remove"
      }
    },
    "/api/account/intake/roadmap": {
      "get": {
        "description": "Reads the authenticated account's board-ready roadmap intake draft. Bearer authentication and roadmap entitlement are required; it consumes no trial or quota and has no side effect.",
        "operationId": "account_roadmap_intake_get_api_account_intake_roadmap_get",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Account Roadmap Intake Get Api Account Intake Roadmap Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Roadmap Intake Get"
      },
      "put": {
        "description": "Reads the authenticated account's board-ready roadmap intake draft. Bearer authentication and roadmap entitlement are required; it consumes no trial or quota and has no side effect.",
        "operationId": "account_roadmap_intake_put_api_account_intake_roadmap_put",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RoadmapIntakeDraftRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Account Roadmap Intake Put Api Account Intake Roadmap Put",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Roadmap Intake Put"
      }
    },
    "/api/account/intake/roadmap/submit": {
      "post": {
        "description": "Creates or updates then submits the authenticated account's roadmap intake. Bearer authentication and roadmap entitlement are required; it persists intake state, consumes no trial or quota, and has no direct billing or email side effect.",
        "operationId": "account_roadmap_intake_submit_api_account_intake_roadmap_submit_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Account Roadmap Intake Submit Api Account Intake Roadmap Submit Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Roadmap Intake Submit"
      }
    },
    "/api/account/invoices": {
      "get": {
        "description": "Lists Stripe invoices for the authenticated account. Bearer authentication is required; it consumes no trial/quota and has no billing, email, or state side effect.",
        "operationId": "account_invoices_api_account_invoices_get",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "additionalProperties": true,
                    "type": "object"
                  },
                  "title": "Response Account Invoices Api Account Invoices Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Invoices"
      }
    },
    "/api/account/keys": {
      "post": {
        "description": "Creates an API key for the authenticated account and returns its secret once. Bearer authentication is required; it persists key state without consuming trial or quota or charging billing.",
        "operationId": "account_create_key_api_account_keys_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountApiKeyCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountKeyCreateResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Create Key"
      }
    },
    "/api/account/keys/ensure": {
      "post": {
        "description": "Returns the existing API key prefix or creates the first API key without rotating one. Bearer authentication is required; it may persist key state but consumes no trial or quota and has no billing side effect.",
        "operationId": "account_ensure_key_api_account_keys_ensure_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountKeyEnsureResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Ensure Key"
      }
    },
    "/api/account/keys/{key_id}": {
      "delete": {
        "description": "Revokes one API key owned by the authenticated account. Bearer authentication is required; it changes key state but consumes no trial or quota and has no billing or email side effect.",
        "operationId": "account_delete_key_api_account_keys__key_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "key_id",
            "required": true,
            "schema": {
              "title": "Key Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountKeyDeleteResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Delete Key"
      }
    },
    "/api/account/kit": {
      "get": {
        "description": "Builds a downloadable customer-local kit for the authenticated account's entitled or trial agents. API key or bearer authentication is required; it consumes no agent transaction or quota and does not persist server state. The kit assumes customer-local permissions to read configured sources and write local configuration.",
        "operationId": "account_kit_api_account_kit_get",
        "parameters": [
          {
            "in": "query",
            "name": "runtime",
            "required": false,
            "schema": {
              "default": "generic-http",
              "title": "Runtime",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "402": {
            "description": "Credentials are valid but the requested product or trial scope is not active."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKey": []
          }
        ],
        "summary": "Account Kit"
      }
    },
    "/api/account/login": {
      "post": {
        "description": "Authenticates an existing account and returns a bearer session token. No entitlement, trial, quota, billing, email, or account state change occurs; failed attempts are rate-limited and recorded.",
        "operationId": "account_login_api_account_login_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountLoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountAuthResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [],
        "summary": "Account Login"
      }
    },
    "/api/account/me": {
      "get": {
        "description": "Returns the authenticated account's public profile and entitlements. Bearer authentication is required; it consumes no trial or quota and has no side effect.",
        "operationId": "account_me_api_account_me_get",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountPublicView"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Me"
      }
    },
    "/api/account/password": {
      "post": {
        "description": "Changes the authenticated account password. Bearer authentication is required; it updates credential state but consumes no trial or quota and has no billing or email side effect.",
        "operationId": "account_password_update_api_account_password_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountPasswordUpdateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "boolean"
                  },
                  "title": "Response Account Password Update Api Account Password Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Password Update"
      }
    },
    "/api/account/profile": {
      "put": {
        "description": "Updates the authenticated account's public profile. Bearer authentication is required; it changes account state but consumes no trial or quota and has no billing or email side effect.",
        "operationId": "account_profile_update_api_account_profile_put",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountProfileUpdateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountPublicView"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Profile Update"
      }
    },
    "/api/account/purchases/refresh": {
      "post": {
        "description": "Refreshes the authenticated account's purchases from Stripe. Bearer authentication is required; it may update entitlement state but consumes no trial or quota and does not create a new charge.",
        "operationId": "account_purchases_refresh_api_account_purchases_refresh_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "integer"
                  },
                  "title": "Response Account Purchases Refresh Api Account Purchases Refresh Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Purchases Refresh"
      }
    },
    "/api/account/recovery/password": {
      "post": {
        "description": "Starts password recovery without revealing whether an account exists. No authentication, entitlement, trial, or quota is required; it may send a recovery email and records rate-limit state.",
        "operationId": "account_recover_password_api_account_recovery_password_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountRecoveryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountRecoveryResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [],
        "summary": "Account Recover Password"
      }
    },
    "/api/account/recovery/reset": {
      "post": {
        "description": "Resets a password using a recovery token. No entitlement, trial, quota, billing, or email is involved; it updates account credential state.",
        "operationId": "account_reset_password_api_account_recovery_reset_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountRecoveryResetRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountRecoveryResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Account Reset Password"
      }
    },
    "/api/account/recovery/username": {
      "post": {
        "description": "Explains that the account username is its email address. No authentication, entitlement, trial, quota, billing, email, or state change occurs.",
        "operationId": "account_recover_username_api_account_recovery_username_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountRecoveryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountRecoveryResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Account Recover Username"
      }
    },
    "/api/account/services/{product}/cancel": {
      "post": {
        "description": "Schedules the authenticated customer's subscription to cancel at the end of its current billing period. A bearer session is required; one-time purchases and already-ended subscriptions are rejected.",
        "operationId": "account_service_cancel_api_account_services__product__cancel_post",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "title": "Product",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "site_name",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Site Name"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Account Service Cancel Api Account Services  Product  Cancel Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Service Cancel"
      }
    },
    "/api/account/signup": {
      "post": {
        "description": "Creates an account and returns a bearer session token. No entitlement or trial is granted; signup is rate-limited, persists account state, and attempts to send a welcome email.",
        "operationId": "account_signup_api_account_signup_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountSignupRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountAuthResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [],
        "summary": "Account Signup"
      }
    },
    "/api/account/storefront": {
      "get": {
        "description": "Returns storefront state for the authenticated account. A bearer session or API key is required; it consumes no quota and has no billing or state side effect.",
        "operationId": "account_storefront_api_account_storefront_get",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Account Storefront Api Account Storefront Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKey": []
          }
        ],
        "summary": "Account Storefront"
      }
    },
    "/api/account/usage": {
      "get": {
        "description": "Returns quota and usage status for the authenticated account's active tiers. Bearer authentication is required; it consumes no transaction or quota and has no side effect.",
        "operationId": "account_usage_api_account_usage_get",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Account Usage Api Account Usage Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Account Usage"
      }
    },
    "/api/agents/alarm-triage": {
      "post": {
        "description": "Ranks supplied current or historical alarm data; customer-local capture or historian setup supplies that data. API key/bearer entitlement or legacy agents token is required; the selected Free Trial agent is eligible and successful runs consume quota. No billing, email, or persistent server state is changed.",
        "operationId": "alarm_triage_api_agents_alarm_triage_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-Agents-Token",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Agents-Token"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AlarmTriageRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlarmTriageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "402": {
            "description": "Credentials are valid but the requested product or trial scope is not active."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "AgentsToken": []
          },
          {
            "ApiKey": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Alarm Triage"
      }
    },
    "/api/agents/catalog": {
      "get": {
        "description": "Returns public agent capability and pricing discovery data. No authentication, entitlement, trial, quota, billing, email, or state change is involved.",
        "operationId": "agents_public_catalog_api_agents_catalog_get",
        "parameters": [
          {
            "in": "query",
            "name": "locale",
            "required": false,
            "schema": {
              "default": "en",
              "title": "Locale",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Agents Public Catalog Api Agents Catalog Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Agents Public Catalog"
      }
    },
    "/api/agents/maintenance-copilot": {
      "post": {
        "description": "Answers from supplied maintenance history and recent asset events; it does not directly access customer systems. API key/bearer entitlement or legacy agents token is required; the selected Free Trial agent is eligible and successful runs consume quota. Local kit setup is assumed; no billing, email, or persistent server state is changed.",
        "operationId": "maintenance_copilot_api_agents_maintenance_copilot_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-Agents-Token",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Agents-Token"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MaintenanceCopilotRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MaintenanceCopilotResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "402": {
            "description": "Credentials are valid but the requested product or trial scope is not active."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "AgentsToken": []
          },
          {
            "ApiKey": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Maintenance Copilot"
      }
    },
    "/api/agents/manifest/{agent_slug}": {
      "get": {
        "description": "Returns setup requirements for one agent. An API key is required; the account must own the agent or have it selected for trial (the local router is also available). It consumes no transaction or quota and has no side effect.",
        "operationId": "agent_manifest_api_agents_manifest__agent_slug__get",
        "parameters": [
          {
            "in": "path",
            "name": "agent_slug",
            "required": true,
            "schema": {
              "title": "Agent Slug",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "locale",
            "required": false,
            "schema": {
              "default": "en",
              "title": "Locale",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentCapabilityManifest"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "402": {
            "description": "Credentials are valid but the requested product or trial scope is not active."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "summary": "Agent Manifest"
      }
    },
    "/api/agents/oee-narrator": {
      "post": {
        "description": "Explains OEE from supplied current or historical production data; customer-local capture or historian setup supplies that data. API key/bearer entitlement or legacy agents token is required; the selected Free Trial agent is eligible and successful runs consume quota. No billing, email, or persistent server state is changed.",
        "operationId": "oee_narrator_api_agents_oee_narrator_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-Agents-Token",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Agents-Token"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OeeNarratorRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OeeNarratorResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "402": {
            "description": "Credentials are valid but the requested product or trial scope is not active."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "AgentsToken": []
          },
          {
            "ApiKey": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Oee Narrator"
      }
    },
    "/api/agents/root-cause": {
      "post": {
        "description": "Analyzes supplied incident-window and historical context; it does not directly access customer systems. API key/bearer entitlement or legacy agents token is required; the selected Free Trial agent is eligible and successful runs consume quota. Local kit setup is assumed; no billing, email, or persistent server state is changed.",
        "operationId": "root_cause_api_agents_root_cause_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-Agents-Token",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Agents-Token"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RootCauseRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RootCauseResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "402": {
            "description": "Credentials are valid but the requested product or trial scope is not active."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "AgentsToken": []
          },
          {
            "ApiKey": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Root Cause"
      }
    },
    "/api/agents/setup": {
      "post": {
        "description": "Analyzes local capture, historian, or export metadata to prepare agent mappings; it does not read a customer system directly. An API key and purchased/trial agent scope are required. It consumes no transaction or quota, has no billing/email side effect, and returns local setup guidance.",
        "operationId": "agents_setup_api_agents_setup_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentSetupRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentSetupResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "402": {
            "description": "Credentials are valid but the requested product or trial scope is not active."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "summary": "Agents Setup"
      }
    },
    "/api/agents/shift-report": {
      "post": {
        "description": "Generates a shift handover from supplied current or historical UNS data; it does not query a customer system itself. API key/bearer entitlement or legacy agents token is required; an eligible Free Trial is limited to its chosen agent and a successful run consumes quota. Local setup uses the kit and agent setup endpoint; no billing, email, or persistent server state is changed.",
        "operationId": "shift_report_api_agents_shift_report_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-Agents-Token",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Agents-Token"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ShiftReportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ShiftReportResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "402": {
            "description": "Credentials are valid but the requested product or trial scope is not active."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "AgentsToken": []
          },
          {
            "ApiKey": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Shift Report"
      }
    },
    "/api/architect": {
      "post": {
        "description": "Runs the Namespace Architect design interview against available knowledge. API key or bearer authentication is accepted (with a legacy architect token); the paid entitlement or eligible trial is required and one quota transaction is consumed on success. It has no billing, email, or persistent design-state side effect.",
        "operationId": "architect_api_architect_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-Architect-Token",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Architect-Token"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ArchitectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ArchitectResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "402": {
            "description": "Credentials are valid but the requested product or trial scope is not active."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKey": []
          }
        ],
        "summary": "Architect"
      }
    },
    "/api/billing-portal": {
      "post": {
        "description": "Creates a Stripe Billing Portal URL for the authenticated account. Bearer authentication is required; it consumes no trial/quota and does not itself change billing or entitlement state.",
        "operationId": "billing_portal_api_billing_portal_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BillingPortalResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Billing Portal"
      }
    },
    "/api/billing/mode": {
      "get": {
        "description": "Returns whether the configured Stripe secret is live or test mode. It exposes no key material and requires no authentication.",
        "operationId": "billing_mode_api_billing_mode_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "string"
                  },
                  "title": "Response Billing Mode Api Billing Mode Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "security": [],
        "summary": "Billing Mode"
      }
    },
    "/api/catalog": {
      "get": {
        "description": "Returns the public product catalog, excluding internal test products. No authentication, entitlement, trial, quota, billing, email, or state change is involved.",
        "operationId": "catalog_api_catalog_get",
        "parameters": [
          {
            "in": "query",
            "name": "locale",
            "required": false,
            "schema": {
              "default": "en",
              "title": "Locale",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "include_internal",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Internal",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Catalog Api Catalog Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Catalog"
      }
    },
    "/api/chat": {
      "post": {
        "description": "Answers a chat request using the account's available tier. A bearer session or API key is required; it consumes quota (including the trial/free allowance where applicable) but has no billing, email, or persistent account side effect.",
        "operationId": "chat_api_chat_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChatRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChatResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKey": []
          }
        ],
        "summary": "Chat"
      }
    },
    "/api/checkout/agents": {
      "post": {
        "description": "Creates a Stripe-hosted checkout URL for agents at a named site. Bearer authentication or API key is required; it does not charge immediately, consume trial/quota, send email, or change entitlement state, and refuses a second subscription for the same site.",
        "operationId": "checkout_agents_api_checkout_agents_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentsCheckoutRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentsCheckoutResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          },
          {
            "ApiKey": []
          }
        ],
        "summary": "Checkout Agents"
      }
    },
    "/api/checkout/cart": {
      "post": {
        "description": "Creates Stripe-hosted checkout sessions for an authenticated cart after validating product and entitlement rules. Bearer authentication is required; it does not charge immediately or consume trial/quota, and does not change entitlement state until checkout confirmation.",
        "operationId": "checkout_cart_api_checkout_cart_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CartCheckoutRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CartCheckoutResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Checkout Cart"
      }
    },
    "/api/checkout/confirm": {
      "get": {
        "description": "Confirms a Stripe Checkout Session and applies its result. No bearer/API-key authentication is used; it may persist purchase entitlement state and Stripe may send transactional email, but it consumes no trial or quota.",
        "operationId": "checkout_confirm_api_checkout_confirm_get",
        "parameters": [
          {
            "in": "query",
            "name": "session_id",
            "required": true,
            "schema": {
              "title": "Session Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Checkout Confirm Api Checkout Confirm Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Checkout Confirm"
      }
    },
    "/api/checkout/roadmap": {
      "post": {
        "description": "Creates a Stripe-hosted one-time roadmap checkout URL. Authentication is optional; it does not charge immediately, consume trial/quota, send email, or change entitlements, but prevents a logged-in owner from buying the roadmap again.",
        "operationId": "checkout_roadmap_api_checkout_roadmap_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckoutRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckoutResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Checkout Roadmap"
      }
    },
    "/api/checkout/{product}": {
      "post": {
        "description": "Creates a Stripe-hosted checkout URL for one product after applicable entitlement checks. Authentication is optional; it does not charge immediately, consume trial/quota, send email, or change entitlement state.",
        "operationId": "checkout_product_api_checkout__product__post",
        "parameters": [
          {
            "in": "path",
            "name": "product",
            "required": true,
            "schema": {
              "enum": [
                "api",
                "shift-report",
                "oee-narrator",
                "alarm-triage",
                "maintenance-copilot",
                "root-cause",
                "architect",
                "agents-all",
                "roadmap",
                "roadmap-bundle",
                "topup-50",
                "topup-100",
                "live-test",
                "all-agents-test"
              ],
              "title": "Product",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckoutRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckoutResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Checkout Product"
      }
    },
    "/api/diagnostic": {
      "post": {
        "description": "Runs the preliminary self-reported readiness diagnostic and returns a deterministic verdict. Authentication is optional via API key; it uses no entitlement, trial transaction, billing, email, or persistent state, but is quota/rate limited.",
        "operationId": "diagnostic_api_diagnostic_post",
        "parameters": [
          {
            "in": "query",
            "name": "token",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Token"
            }
          },
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          },
          {
            "in": "header",
            "name": "X-Access-Token",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Access-Token"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IntakeModel"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DiagnosticResult"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "429": {
            "description": "The applicable rate or quota limit has been reached.",
            "headers": {
              "Retry-After": {
                "description": "Seconds until the request may be retried.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {},
          {
            "ApiKey": []
          }
        ],
        "summary": "Diagnostic"
      }
    },
    "/api/tools/csv-to-bundle": {
      "post": {
        "description": "Converts supplied CSV data into an agent bundle. API key authentication is required; it does not consume a trial transaction or quota and does not persist data or charge billing.",
        "operationId": "csv_to_bundle_api_tools_csv_to_bundle_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-Api-Key",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Api-Key"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CsvToBundleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Csv To Bundle Api Tools Csv To Bundle Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "summary": "Csv To Bundle"
      }
    },
    "/api/trial/activate": {
      "post": {
        "description": "Activates the account's one-time Free Trial for a selected agent and returns an API key. Bearer authentication is required; it persists trial and key state but does not consume a trial transaction or charge billing.",
        "operationId": "trial_activate_api_trial_activate_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrialActivateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "title": "Response Trial Activate Api Trial Activate Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, malformed, or invalid credentials."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "summary": "Trial Activate"
      }
    },
    "/health": {
      "get": {
        "description": "Returns service health. No authentication, entitlement, trial, quota, billing, email, or state change is involved.",
        "operationId": "health_health_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "string"
                  },
                  "title": "Response Health Health Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "security": [],
        "summary": "Health"
      }
    },
    "/system-capabilities.json": {
      "get": {
        "description": "Returns the machine-readable map of cloud, browser, and customer-local capabilities. No authentication, entitlement, trial consumption, quota use, or side effect is involved.",
        "operationId": "system_capabilities_manifest_system_capabilities_json_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SystemCapabilitiesManifest"
                }
              }
            },
            "description": "Successful Response"
          }
        },
        "security": [],
        "summary": "System Capabilities Manifest"
      }
    }
  },
  "servers": [
    {
      "description": "Production API",
      "url": "https://opwhcervi3.execute-api.ca-central-1.amazonaws.com"
    }
  ]
}