Files
tatlock/src/core/startup.py
T
jpmschweitzerandClaude Opus 4.5 a1b8fe46e8 feat: add The Housekeeper agent for home automation
Implements The Housekeeper, a new expert agent for home automation
following the Librarian pattern. Communicates with core-api service
which wraps Home Assistant REST API.

New agent features:
- CoreAPIClient with 13 home automation methods
- 13 tools: list_areas, list_devices, get_device_state, turn_on,
  turn_off, toggle, list_scenes, activate_scene, list_scripts,
  run_script, list_automations, toggle_automation, get_history
- PydanticAI agent with butler-friendly system prompt
- HouseholdCapability registration for Steward coordination
- delegate_to_housekeeper() wrapper for orchestration

Also includes:
- Dev port changed from 8123 to 8777 (avoids Home Assistant conflict)
- Config: CORE_API_HOST, CORE_API_KEY, CORE_API_TIMEOUT
- 44 unit tests for client and capability

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-15 10:24:35 +01:00

101 lines
2.8 KiB
Python

"""
Application startup module.
Handles initialization of household registry and other startup tasks.
This module should be called during application startup to register
all household members.
"""
from src.agents.biographer import register_biographer
from src.agents.housekeeper import register_housekeeper
from src.agents.librarian import register_librarian
from src.agents.tatlock_core import TATLOCK_CORE_CAPABILITY, tatlock_core_tools
from src.core.household_registry import get_household_registry
from src.core.logging_config import get_logger
logger = get_logger(__name__)
def register_household_members():
"""
Register all household members with the registry.
This function should be called during application startup to make
household capabilities available to the Steward.
Currently registers:
- tatlock_core: Butler's core tools (calculator, datetime, web search)
- librarian: Research and knowledge management (Phase 3)
- biographer: User memory and context management (Phase F)
"""
registry = get_household_registry()
logger.info("household_registration_starting")
# Register Tatlock's core tools
registry.register(
name="tatlock_core",
capability=TATLOCK_CORE_CAPABILITY,
tools=tatlock_core_tools,
agent=None, # No expert agent for core tools
)
logger.info(
"household_member_registered",
name="tatlock_core",
tool_count=len(tatlock_core_tools),
)
# Register The Librarian (Phase 3)
try:
register_librarian()
except Exception as e:
# Don't fail startup if Librarian registration fails
logger.warning(
"librarian_registration_failed",
error=str(e),
)
# Register The Biographer (Phase F)
try:
register_biographer()
except Exception as e:
# Don't fail startup if Biographer registration fails
logger.warning(
"biographer_registration_failed",
error=str(e),
)
# Register The Housekeeper (Home Automation)
try:
register_housekeeper()
except Exception as e:
# Don't fail startup if Housekeeper registration fails
logger.warning(
"housekeeper_registration_failed",
error=str(e),
)
logger.info(
"household_registration_complete",
total_members=len(registry),
)
def initialize_application():
"""
Initialize the application.
Performs all startup tasks:
1. Register household members
2. (Future) Initialize connections
3. (Future) Load configuration
This should be called once during application startup.
"""
logger.info("application_initialization_starting")
# Register household members
register_household_members()
logger.info("application_initialization_complete")