You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8.4 KiB
8.4 KiB
Bear Stone Smart Home Documentation
Be sure to ⭐ my configuration repo so you can keep up to date on any daily progress!
Reusable scripts that other automations call for notifications, lighting, safety responses, and Joanna/BearClaw AGENT engineer handoffs. Pass variables in; let the script do the heavy lifting.
Quick navigation
- You are here:
config/script/(scripts library) - Repo overview | Config index | Automations | Scenes | Blog: Speech engine video
Featured files to browse
| File | Why it matters |
|---|---|
| notify_engine.yaml | Single entrypoint for rich push notifications. |
| notify_live_activity.yaml | Shared helper for tagged live activity/live update pushes and clear commands. |
| send_to_logbook.yaml | Generic logbook.log helper for Activity feed entries (Issue #1550). |
| joanna_dispatch.yaml | Shared AGENT engineer dispatch contract that routes HA-detected issues into Joanna/BearClaw remediation. |
| speech_engine.yaml | TTS/announcement orchestration with templated speech; speech processing can bypass LLM rewriting for exact messages and also routes garage/office Echo announcements. |
| monthly_color_scene.yaml | Seasonal lighting scenes used across automations. |
| interior_off.yaml | One-call "all interior lights off" helper. |
Joanna + BearClaw AGENT engineer handoff
script.joanna_dispatch is the shared handoff contract from Home Assistant automations into Joanna/BearClaw when Home Assistant detects something worth investigating or fixing.
Why we use it:
- Keeps one message schema for remediation context (
trigger_context,source,summary,entity_ids,diagnostics,request, plus optional routing hints). - Avoids repeating direct
rest_command.bearclaw_commandpayload formatting in multiple packages. - Lets Home Assistant stay focused on detection, timing, and routing while Joanna acts as the AGENT engineer for infrastructure triage and recommended remediation.
- Makes resolution-trigger automations easier to review, update, and audit.
What the helper normalizes before the BearClaw intake call:
trigger_context,source, andsummaryso every dispatch has traceable origin details.entity_idsfrom either a YAML list or a comma-delimited string.diagnosticsfrom either free text or structured mappings/sequences.requestguardrails so Joanna defaults to investigation/recommendation, not blind resets or power-cycles.domain_hint/lane_hintdefault to BearClaw ops routing so HA infrastructure text does not drift into another domain parser.
Current automations that kick off automated resolutions (via script.joanna_dispatch):
| Automation ID | Alias | File |
|---|---|---|
mqtt_open_repair_on_failure |
MQTT - Open Repair On Failure | ../packages/mqtt_status.yaml |
onenote_indexer_daily_delete_maintenance |
OneNote Indexer - Daily Delete Maintenance Request | ../packages/onenote_indexer.yaml |
onenote_indexer_failure_open_repair |
OneNote Indexer - Open Repair On Failure | ../packages/onenote_indexer.yaml |
infra_backup_nightly_verification |
Infrastructure - Backup Nightly Verification | ../packages/infrastructure.yaml |
infra_monthly_log_hygiene_review |
Infrastructure - Monthly HA Log Hygiene Review | ../packages/infrastructure.yaml |
infra_nebula_sync_health_dispatch |
Infrastructure - Nebula Sync Health Dispatch | ../packages/infrastructure.yaml |
infra_pihole_iot_dns_drift_dispatch |
Infrastructure - Pi-hole IoT DNS Drift Dispatch | ../packages/infrastructure.yaml |
docker_state_sync_repairs_dynamic |
Docker State Sync - Repairs (Dynamic) | ../packages/docker_infrastructure.yaml |
docker_group_reconcile_weekly_joanna_review |
Docker Group Reconcile - Weekly Joanna Review | ../packages/docker_infrastructure.yaml |
docker_host_disk_pressure_monitor |
Docker Host Disk Pressure Monitor | ../packages/infrastructure.yaml |
tugtainer_dispatch_joanna_for_available_updates |
Tugtainer - Dispatch Joanna For Available Updates | ../packages/tugtainer_updates.yaml |
tugtainer_dispatch_joanna_for_home_assistant_core_digest |
Tugtainer - Dispatch Joanna For Home Assistant Core Digest | ../packages/tugtainer_updates.yaml |
unifi_ap_no_clients_repair_combined |
Unifi AP Create Repair Issue after 5m of 0 Clients | ../packages/wireless.yaml |
proxmox_runtime_repairs |
Proxmox Runtime Repair Issues | ../packages/proxmox.yaml |
proxmox_disk_pressure_repairs |
Proxmox Disk Pressure Repair Issues | ../packages/proxmox.yaml |
synology_dsm_open_repair_and_dispatch |
Synology DSM - Open Repair And Dispatch | ../packages/synology_dsm.yaml |
processmonitor_disk_use_joanna_review |
Self Heal Disk Use Joanna Review | ../packages/processmonitor.yaml |
1ce3cb43-0e27-4c53-acdd-d672396f3559 |
Disk Use Alarm | ../packages/processmonitor.yaml |
Tips
- Keep scripts generic, route data via
data:/variables:, and reuse everywhere. - If you copy a script, rename any
aliasandidfields to avoid duplicates.
All of my configuration files are tested against the most stable version of home-assistant.
Still have questions on my Config?
Message me on X :
