Skip to main content

​
resq_mcp.drone.models

Drone feed domain models for the ResQ MCP server.

​
annotations

​
datetime

​
Literal

​
BaseModel

​
Field

​
Coordinates

​
SectorAnalysis Objects

class SectorAnalysis(BaseModel)
Complete analysis result from a sector surveillance scan. Contains all detection data, evidence links, and recommended actions from a drone sector scan. Used for incident reporting and blockchain evidence submission. Attributes:
  • sector_id - Identifier of the scanned sector.
  • timestamp - UTC timestamp of the analysis (auto-generated).
  • status - Overall status (e.g., “clear”, “CRITICAL_ALERT”).
  • detected_object - Primary object or hazard detected.
  • disaster_type - Classified disaster type if applicable.
  • confidence - Detection confidence score (0.0 to 1.0).
  • description - Detailed analysis description.
  • coordinates - Geographic coordinates of the detection.
  • video_proof_url - NeoFS/IPFS URL for video evidence.
  • recommended_action - Suggested next action (e.g., “IMMEDIATE_REPORT_TO_BLOCKCHAIN”).

​
sector_id

​
timestamp

​
status

​
detected_object

​
disaster_type

​
confidence

​
description

​
coordinates

​
video_proof_url

​
SectorStatusSummary Objects

class SectorStatusSummary(BaseModel)
Condensed status summary for network-wide sector monitoring. Lightweight representation used in network status dashboards and overview displays. Excludes detailed evidence and coordinates. Attributes:
  • status - Current sector status indicator.
  • detected_object - Primary detected object or “None”.
  • confidence - Overall confidence score for the status.

​
status

​
detected_object

​
confidence

​
NetworkStatus Objects

class NetworkStatus(BaseModel)
Aggregate status of the entire drone surveillance network. Provides a network-wide view of all monitored sectors and critical alert counts for operator dashboards and system health monitoring. Attributes:
  • timestamp - UTC timestamp of the status snapshot (auto-generated).
  • total_sectors - Total number of monitored sectors.
  • sectors - Mapping of sector IDs to their status summaries.
  • critical_alerts - Count of sectors with critical alerts active.

​
timestamp

​
total_sectors

​
sectors

​
critical_alerts

​
SwarmStatus Objects

class SwarmStatus(BaseModel)
Real-time operational status of the drone swarm. Aggregates health metrics across all drones in the fleet including battery levels, connectivity status, and deployment state. Attributes:
  • timestamp - UTC timestamp of the status snapshot (auto-generated).
  • total_drones - Total number of drones in the fleet.
  • active_drones - Number of drones currently deployed and operational.
  • average_battery - Fleet-wide average battery percentage (0-100).
  • network_status - Overall network health (e.g., “operational”, “degraded”).
  • last_sync - UTC timestamp of last successful sync with ground station.

​
timestamp

​
total_drones

​
active_drones

​
average_battery

​
network_status

​
last_sync

​
DeploymentRequest Objects

class DeploymentRequest(BaseModel)
Request for immediate drone deployment to a specific sector. Used by operators or automated systems to request drone dispatch to sectors requiring surveillance or emergency response. Attributes:
  • sector_id - Target sector identifier for deployment.
  • priority - Deployment urgency level (low/medium/high/critical). Higher priority requests preempt lower priority missions.

​
sector_id

​
priority

​
DeploymentStatus Objects

class DeploymentStatus(BaseModel)
Response status for a drone deployment request. Provides confirmation and tracking information for a deployment request including assigned drone and estimated arrival time. Attributes:
  • status - Deployment state (e.g., “deployed”, “en_route”, “completed”).
  • sector_id - Target sector identifier.
  • priority - Assigned priority level.
  • drone_id - Identifier of the assigned drone unit.
  • eta_seconds - Estimated time to arrival in seconds.
  • timestamp - UTC timestamp of the status update (auto-generated).

​
status

​
sector_id

​
priority

​
drone_id

​
eta_seconds

​
timestamp