Bear Stone Smart Home Documentation

Be sure to :star: 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_command payload 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, and summary so every dispatch has traceable origin details.
• entity_ids from either a YAML list or a comma-delimited string.
• diagnostics from either free text or structured mappings/sequences.
• request guardrails so Joanna defaults to investigation/recommendation, not blind resets or power-cycles.
• domain_hint/lane_hint default 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
proxmox_updates_joanna_dispatch	Proxmox Updates Joanna Dispatch	../packages/proxmox.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 alias and id fields 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 :

You can buy me a coffee

Affiliate Disclosure