feat: proactive weather ability

[melodygui]

What does this Ability do?

Provides on-demand weather queries with a concise voice-friendly forecast summary, and runs a background daemon that silently monitors conditions every 10 minutes and proactively interrupts the conversation if severe weather is detected. Also writes local_weather.md to persistent storage so the Personality stays passively aware of local weather conditions throughout the session.

Suggested Trigger Words

• what's the weather
• how's the weather
• weather
• will it rain
• do I need an umbrella

Type

• New community Ability
• Improvement to existing Ability
• Bug fix
• Documentation update

External APIs

• No external APIs
• Uses external API(s): Open-Meteo (weather data, free, no API key required), Nominatim/OpenStreetMap (geocoding, free, no API key required)

Testing

• Tested in OpenHome Live Editor
• All exit paths tested (said "stop", "exit", etc.)
• Error scenarios tested (API down, bad input, etc.)

Checklist

• Files are in community/my-ability-name/
• main.py follows SDK pattern (extends MatchingCapability, has register_capability + call)
• README.md included with description, suggested triggers, and setup
• resume_normal_flow() called on every exit path
• No print() — using editor_logging_handler
• No hardcoded API keys — using placeholders
• No blocked imports (redis, user_config)
• No asyncio.sleep() or asyncio.create_task() — using session_tasks
• Error handling on all external calls
• Tested in OpenHome Live Editor

Anything else?

This ability uses the new background.py daemon infrastructure introduced in the March 2026 SDK update. It is an Interactive Combined ability: main.py handles the reactive weather query flow and background.py runs as a persistent daemon for the entire session.

[github-actions]

🔀 Branch Merge Check

PR direction: weather-alerts → dev

✅ Passed — weather-alerts → dev is a valid merge direction

[github-actions]

✅ Community PR Path Check — Passed

All changed files are inside the community/ folder. Looks good!

[github-actions]

✅ Ability Validation Passed

📋 Validating: community/proactive-weather
  ✅ All checks passed!

[github-actions]

🔍 Lint Results

✅ __init__.py — Empty as expected

Files linted: community/proactive-weather/background.py community/proactive-weather/main.py

✅ Flake8 — Passed

✅ All checks passed!

[uzair401]

Hi @melodygui , I’ve applied several fixes and improvements to improve stability, SDK compliance, and voice UX.

In main.py, I added a voice format guard to prevent markdown in spoken output, wrapped blocking HTTP calls in asyncio.to_thread(), and introduced a proper city save confirmation flow along with support for updating the saved city via natural phrases. KV handling was improved with a create-or-update pattern and helper functions for cleaner access, along with a one-time city override so user queries don’t overwrite saved preferences. I also removed duplicate and redundant calls and ensured flow cleanup is handled correctly.

In background.py, I fixed a critical bug with saved value access that was causing crashes, removed unnecessary technical details from alerts, added a voice format guard, and fixed JSON handling to prevent corruption.

Approved for community.

As part of our process, abilities go through a 30-day evaluation period where we monitor performance, identify any issues, and make necessary improvements. Once everything meets our quality standards, we proceed with publishing to the marketplace with full credit to the original author.

We truly appreciate your effort and encourage you to continue developing and submitting more abilities.