Download backend/intelligence_api.py from m4az19/saef-api: direct link, hf CLI and curl.
- Browser
- Download file 3.41 kB
-
https://huggingface.co/spaces/m4az19/saef-api/resolve/main/backend/intelligence_api.py
- Command line
-
hf download hf://spaces/m4az19/saef-api/backend/intelligence_api.py
-
curl -L -o intelligence_api.py https://huggingface.co/spaces/m4az19/saef-api/resolve/main/backend/intelligence_api.py
3.41 kB
| """Local operator APIs. External ingestion uses the existing device-key boundary.""" | |
| import os | |
| import secrets | |
| from typing import Literal, Optional | |
| from fastapi import APIRouter, Header, HTTPException | |
| from pydantic import BaseModel, Field | |
| from . import pipeline, intelligence, observations, store, locations | |
| router=APIRouter(prefix='/api') | |
| Wadi=str | |
| Mode=Literal['real','demo'] | |
| def place_search(q:str=''): | |
| return locations.search(q) | |
| def save_area(req:locations.AreaRequest): | |
| return locations.save(req) | |
| def device_auth(key): | |
| configured=os.environ.get('SATFORGE_DEVICE_KEY') | |
| if not configured:raise HTTPException(503,'Configure SATFORGE_DEVICE_KEY before accepting observations') | |
| if not secrets.compare_digest(key or '',configured):raise HTTPException(401,'Invalid device key') | |
| def briefing(wadi:Wadi='shawka',mode:Mode='real'): | |
| return pipeline.briefing(wadi,mode) | |
| class RunRequest(BaseModel): | |
| wadi:Wadi='shawka' | |
| mode:Mode='real' | |
| refresh_external:bool=False | |
| def run(req:RunRequest): | |
| from .app import job | |
| return job('Monitoring cycle',pipeline.process,req.wadi,req.mode,req.refresh_external) | |
| def settings():return intelligence.settings().model_dump() | |
| def settings_update(req:intelligence.PipelineSettings): | |
| store.put('config',req.model_dump(),'pipeline');pipeline.wake() | |
| store.event('Research monitoring settings updated','SYSTEM') | |
| return req.model_dump() | |
| def prediction(id:str):return store.get('predictions',id) | |
| def asset(id:str):return store.get('assets',id) | |
| class ReplayRequest(BaseModel): | |
| wadi:Wadi='shawka' | |
| profile:Literal['dry','watch','storm']='storm' | |
| def replay(req:ReplayRequest): | |
| from .app import job | |
| return job('Synthetic pipeline replay',pipeline.replay,req.wadi,req.profile) | |
| class Acknowledgement(BaseModel): | |
| operator:str=Field(default='Local operator',min_length=1,max_length=120) | |
| note:str=Field(default='',max_length=1000) | |
| def acknowledge(id:str,req:Acknowledgement): | |
| return intelligence.acknowledge(id,req.operator,req.note) | |
| def alerts(wadi:Wadi='shawka',mode:Mode='real'): | |
| locations.get_area(wadi) | |
| return [a for a in store.all_records('alerts') if a['wadi']==wadi and a['mode']==mode] | |
| def ingest(req:observations.Observation,x_device_key:Optional[str]=Header(None)): | |
| device_auth(x_device_key) | |
| result=observations.ingest(req) | |
| if not result['duplicate']: | |
| store.event('Environmental observation ingested',req.category,observation_id=result['id']) | |
| pipeline.wake() | |
| return result | |
| def ledger(wadi:Wadi='shawka',mode:Mode='real',limit:int=100): | |
| if not 1<=limit<=500:raise HTTPException(422,'Limit must be between 1 and 500') | |
| return [{**o,'current_quality':observations.quality(o)} for o in store.all_records('observations') | |
| if intelligence.in_area(o,wadi) and (o['category']=='simulation')==(mode=='demo')][:limit] | |