"""Dedicated read-inventory process: never starts cron, gateway, rooms, MCP or PTY.""" from pathlib import Path import os, json from datetime import datetime, timezone from fastapi import Request from fastapi.responses import JSONResponse from plugins.dashboard_auth.basic import BasicAuthProvider, hash_password from hermes_cli.dashboard_auth.registry import register_global_provider from hermes_cli import web_server import uvicorn def secret(name): p=Path('/run/secrets')/name if not p.is_file() or p.stat().st_size>4096: raise RuntimeError('Runtime credential unavailable') value=p.read_text().strip() if not value or '\n' in value or '\r' in value: raise RuntimeError('Runtime credential unavailable') return value def snapshot_provenance(): try: path=Path(os.environ['HERMES_HOME'])/'snapshot-manifest.json' if path.is_symlink() or not path.is_file() or path.stat().st_size>4096: raise ValueError() data=json.loads(path.read_text()) if set(data)!={'schemaVersion','source','capturedAt'} or data['schemaVersion']!=1 or data['source']!='snapshot': raise ValueError() captured=data['capturedAt'] if not isinstance(captured,str) or not captured.endswith('Z'): raise ValueError() at=datetime.fromisoformat(captured.replace('Z','+00:00')) age=(datetime.now(timezone.utc)-at).total_seconds() if age<0: raise ValueError() return {'source':'snapshot','capturedAt':captured,'ageSeconds':int(age), 'freshness':'fresh' if age<=3600 else 'stale','liveProcess':'unknown'} except (OSError, ValueError, TypeError, KeyError): raise RuntimeError('Valid snapshot manifest required') from None def build_app(): snapshot_provenance() # Never execute installed status: it probes PIDs, gateway HTTP and platform health. web_server.app.router.routes[:] = [route for route in web_server.app.router.routes if getattr(route,'path',None)!='/api/status'] @web_server.app.get('/api/status') async def snapshot_status(): from hermes_cli.web_server import get_version_info return {'version':get_version_info().base_version,'gateway_running':False, 'gateway_state':None,'active_agents':0,'overall':'unknown', 'liveGatewayState':'unknown','liveActiveAgents':None} # Place before installed catch-all UI route. web_server.app.router.routes.insert(0, web_server.app.router.routes.pop()) projected=Path(os.environ['HERMES_HOME'])/'inventory.json' if os.environ.get('HERMES_REQUIRE_PROJECTED_INVENTORY')=='1' and not projected.is_file(): raise RuntimeError('Projected inventory required') if projected.exists(): # Immutable exporter projection, not installed config/session/cron readers. if projected.is_symlink() or projected.stat().st_size>32*1024*1024: raise RuntimeError('Invalid projected inventory') inventory=json.loads(projected.read_text()) if set(inventory)!={'schemaVersion','profile','sessions'} or inventory['schemaVersion']!=1 or not isinstance(inventory['sessions'],list): raise RuntimeError('Invalid projected inventory') profile=inventory['profile'] import re if not isinstance(profile,str) or not re.fullmatch('[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}',profile): raise RuntimeError('Invalid projected inventory') replaced={'/api/profiles','/api/sessions','/api/analytics/usage','/api/cron/jobs','/api/model/info'} web_server.app.router.routes[:]=[r for r in web_server.app.router.routes if getattr(r,'path',None) not in replaced] async def projected_read(request:Request): from fastapi import HTTPException path=request.url.path requested=request.query_params.get('profile',profile) if requested!=profile: raise HTTPException(status_code=404) if path=='/api/profiles': return {'profiles':[{'name':profile,'is_default':profile=='default','gateway_running':False}]} if path=='/api/model/info': return {'model':'unknown','provider':'unknown','effective_context_length':0} if path=='/api/cron/jobs': return [] # Cron commands deliberately not captured. try: limit=int(request.query_params.get('limit','20'));offset=int(request.query_params.get('offset','0')) days=int(request.query_params.get('days','30')) if not 1<=limit<=100 or not 0<=offset<=10000 or not 1<=days<=365: raise ValueError() except ValueError: raise HTTPException(status_code=400) rows=inventory['sessions'] if path=='/api/sessions': return {'total':len(rows),'sessions':[{k:r[k] for k in ['id','profile','source','is_active']} for r in list(reversed(rows))[offset:offset+limit]],'storage':{}} captured=datetime.fromisoformat(snapshot_provenance()['capturedAt'].replace('Z','+00:00')).timestamp() filtered=[r for r in rows if captured-days*86400<=r['startedAt']<=captured] return {'period_days':days,'totals':{'total_input':sum(r['inputTokens'] for r in filtered), 'total_output':sum(r['outputTokens'] for r in filtered),'total_sessions':len(filtered), 'total_estimated_cost':sum(r['estimatedCost'] for r in filtered)}} for path in replaced: web_server.app.add_api_route(path,projected_read,methods=['GET']) web_server.app.router.routes.insert(0,web_server.app.router.routes.pop()) register_global_provider(BasicAuthProvider(username=secret('hermes_username'),password_hash=hash_password(secret('hermes_password')),secret=secret('hermes_signing_key').encode(),ttl_seconds=300)) web_server.app.state.auth_required=True web_server.app.state.bound_host='0.0.0.0' # Enforce an outer exact route/method allowlist. Installed public health/status stay # internal; protected inventory still uses installed provider middleware. allowed={'/api/health','/api/profiles','/api/status','/api/analytics/usage','/api/sessions','/api/cron/jobs','/api/model/info'} @web_server.app.middleware('http') async def readonly_gate(request:Request,call_next): path=request.url.path if not ((request.method=='GET' and path in allowed) or (request.method=='POST' and path=='/auth/password-login')): return JSONResponse({'detail':'Unavailable'},status_code=404) response=await call_next(request) if request.method!='GET' or response.status_code!=200: return response try: provenance=snapshot_provenance() except RuntimeError: return JSONResponse({'detail':'Snapshot unavailable'},status_code=503) body=b''.join([chunk async for chunk in response.body_iterator]) data=json.loads(body) def annotate(row): return {**row,'provenance':provenance} if isinstance(data,list): data=[annotate(row) for row in data] else: data=annotate(data) if path=='/api/profiles': data['profiles']=[{**annotate(row),'gateway_running':False,'liveGatewayState':'unknown'} for row in data['profiles']] if path=='/api/status': # Legacy required scalars are conservative placeholders, NOT measurements. data.update(gateway_running=False,active_agents=0,overall='unknown',gateway_state=None, liveGatewayState='unknown',liveActiveAgents=None) return JSONResponse(data,headers={'Cache-Control':'no-store'}) class NoSockets: async def __call__(self, scope, receive, send): if scope['type']=='websocket': await send({'type':'websocket.close','code':1008}) return await web_server.app(scope,receive,send) return NoSockets() if __name__=='__main__': # No upstream lifespan: no eager schema reconciliation or hosted-room recovery. # Data is an operator-prepared independent snapshot, NEVER the gateway's volume. uvicorn.run(build_app(),host='0.0.0.0',port=9119,lifespan='off',access_log=False,log_level='warning')