Add Home Security AI Agent with iOS-Compatible Mobile API

[nfaggian]

Summary

This PR adds a comprehensive home security AI agent that monitors smart locks, cameras, and sensors, with a REST API and a complete native iOS app.

Features

Home Security Agent

Uses Gemma 2 9B model by default via local Ollama for AI interactions.

• Smart Lock Management: View status, lock/unlock doors remotely with confirmation for unlock operations
• Camera Monitoring: View camera status, capture snapshots, review motion detection events
• Sensor Monitoring: Track motion, door/window, smoke, and water leak sensors with battery level monitoring
• Security System Control: Arm/disarm with multiple modes (away, home, night)
• AI Chat Interface: Natural language interaction for security queries
• Activity Logging: Track all security events with timestamps

Mobile API (FastAPI)

• RESTful endpoints for all device operations
• Quick action endpoints for common routines
• Push notification registration and settings management
• Full Swagger/OpenAPI documentation at /docs

iOS App (NEW)

A complete native SwiftUI iOS application:

Screens:

• Dashboard: Security score gauge, quick actions (goodnight/leaving/arriving), status overview
• Locks: View all locks with battery indicators, lock/unlock with confirmation dialogs
• Cameras: Camera grid with online/offline status, motion events timeline with confidence scores
• AI Chat: Natural language assistant with conversation history and smart suggestions
• Settings: Server config, arm/disarm controls, activity log, sensors view

Technical:

• SwiftUI with MVVM architecture
• Async/await networking
• iOS 17.0+ support
• Full Xcode project included

Project Structure

├── src/
│   ├── agents/
│   │   └── home_security_agent/    # AI agent with Gemma model
│   │       ├── agent.py
│   │       └── tools/device_tools.py
│   └── mobile_api/                 # FastAPI backend
│       ├── app.py
│       └── models.py
├── ios/
│   └── HomeSecurityApp/            # SwiftUI iOS app
│       ├── Views/
│       │   ├── DashboardView.swift
│       │   ├── LocksView.swift
│       │   ├── CamerasView.swift
│       │   ├── ChatView.swift
│       │   └── SettingsView.swift
│       ├── Models/Models.swift
│       └── Services/APIService.swift
└── tests/
    ├── test_home_security_agent.py
    └── test_mobile_api.py

Usage

# Pull Gemma model
ollama pull gemma2:9b

# Start the backend
make mobile-api

# Open iOS app in Xcode
open ios/HomeSecurityApp/HomeSecurityApp.xcodeproj

Testing

52 tests covering all agent tools and API endpoints:

make test

Requirements

• Python 3.10+
• Ollama with Gemma model
• iOS 17.0+ / Xcode 15.0+ (for iOS app)