12 KiB

Raw Blame History

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.

You are here: config/script/ (scripts library)
Repo overview | Config index | Automations | Scenes |

Featured files to browse

File	Why it matters
	Single entrypoint for rich push notifications.
	Shared helper for tagged live activity/live update pushes and clear commands.
	Generic `logbook.log` helper for Activity feed entries (Issue #1550).
	Shared AGENT engineer dispatch contract that routes HA-detected issues into Joanna/BearClaw remediation.
	TTS/announcement orchestration with templated speech; speech processing can bypass LLM rewriting for exact messages and also routes garage/office Echo announcements.
	Seasonal lighting dispatcher that follows `sensor.holiday_lighting_scene`.
	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
`onenote_indexer_daily_delete_maintenance`	OneNote Indexer - Daily Delete Maintenance Request
`onenote_indexer_failure_open_repair`	OneNote Indexer - Open Repair On Failure
`infra_backup_nightly_verification`	Infrastructure - Backup Nightly Verification
`infra_monthly_log_hygiene_review`	Infrastructure - Monthly HA Log Hygiene Review
`infra_nebula_sync_health_dispatch`	Infrastructure - Nebula Sync Health Dispatch
`infra_pihole_iot_dns_drift_dispatch`	Infrastructure - Pi-hole IoT DNS Drift Dispatch
`infra_website_down_repair_and_dispatch`	Infrastructure - Website Down Repair And Dispatch
`docker_state_sync_repairs_dynamic`	Docker State Sync - Repairs (Dynamic)
`docker_group_reconcile_weekly_joanna_review`	Docker Group Reconcile - Weekly Joanna Review
`docker_host_disk_pressure_monitor`	Docker Host Disk Pressure Monitor
`proxmox_updates_joanna_dispatch`	Proxmox Updates Joanna Dispatch
`tugtainer_dispatch_joanna_for_available_updates`	Tugtainer - Dispatch Joanna For Available Updates
`tugtainer_dispatch_joanna_for_home_assistant_core_digest`	Tugtainer - Dispatch Joanna For Home Assistant Core Digest
`unifi_ap_no_clients_repair_combined`	Unifi AP Create Repair Issue after 5m of 0 Clients
`proxmox_runtime_repairs`	Proxmox Runtime Repair Issues
`proxmox_disk_pressure_repairs`	Proxmox Disk Pressure Repair Issues
`synology_dsm_open_repair_and_dispatch`	Synology DSM - Open Repair And Dispatch
`processmonitor_disk_use_joanna_review`	Self Heal Disk Use Joanna Review
`1ce3cb43-0e27-4c53-acdd-d672396f3559`	Disk Use Alarm

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

12 KiB Raw Blame History