diff --git a/examples/cards/README.md b/examples/cards/README.md new file mode 100644 index 0000000..550bacb --- /dev/null +++ b/examples/cards/README.md @@ -0,0 +1,11 @@ +# Example Cards + +This directory contains checked-in snapshots of the card templates and saved card instances +currently used in the local Nanobot web UI setup. + +Structure: +- `templates/`: reusable card templates (`manifest.json` + `template.html`) +- `instances/`: example saved cards (`card.json` + `state.json`) + +These files are examples for reference, iteration, and testing. The running web UI loads cards +from `~/.nanobot/cards`, not from this directory. diff --git a/examples/cards/instances/6633c6dc-4772-4e47-a402-1e103026208a/card.json b/examples/cards/instances/6633c6dc-4772-4e47-a402-1e103026208a/card.json new file mode 100644 index 0000000..5fc2d94 --- /dev/null +++ b/examples/cards/instances/6633c6dc-4772-4e47-a402-1e103026208a/card.json @@ -0,0 +1,18 @@ +{ + "id": "6633c6dc-4772-4e47-a402-1e103026208a", + "kind": "text", + "title": "3-Day Agenda", + "content": "", + "question": "", + "choices": [], + "response_value": "", + "slot": "live-calendar-3day", + "lane": "context", + "priority": 50, + "state": "active", + "template_key": "calendar-agenda-live", + "context_summary": "", + "chat_id": "web", + "created_at": "2026-03-11T18:18:25.621797+00:00", + "updated_at": "2026-03-11T18:18:25.621797+00:00" +} diff --git a/examples/cards/instances/6633c6dc-4772-4e47-a402-1e103026208a/state.json b/examples/cards/instances/6633c6dc-4772-4e47-a402-1e103026208a/state.json new file mode 100644 index 0000000..63f9ec0 --- /dev/null +++ b/examples/cards/instances/6633c6dc-4772-4e47-a402-1e103026208a/state.json @@ -0,0 +1,12 @@ +{ + "title": "3-Day Agenda", + "subtitle": "Family Calendar", + "tool_name": "mcp_home_assistant_calendar_get_events", + "calendar_names": [ + "Family Calendar" + ], + "range_days": 3, + "max_events": 8, + "refresh_ms": 900000, + "empty_text": "No events scheduled." +} diff --git a/examples/cards/instances/live-bedroom-co2/card.json b/examples/cards/instances/live-bedroom-co2/card.json new file mode 100644 index 0000000..58a16a1 --- /dev/null +++ b/examples/cards/instances/live-bedroom-co2/card.json @@ -0,0 +1,17 @@ +{ + "id": "live-bedroom-co2", + "kind": "text", + "title": "Bedroom CO2", + "question": "", + "choices": [], + "response_value": "", + "slot": "live-bedroom-co2", + "lane": "context", + "priority": 50, + "state": "active", + "template_key": "sensor-live", + "context_summary": "", + "chat_id": "web", + "created_at": "2026-03-09T22:39:28.502257+00:00", + "updated_at": "2026-03-11T04:12:48.601255+00:00" +} diff --git a/examples/cards/instances/live-bedroom-co2/state.json b/examples/cards/instances/live-bedroom-co2/state.json new file mode 100644 index 0000000..5b3e468 --- /dev/null +++ b/examples/cards/instances/live-bedroom-co2/state.json @@ -0,0 +1,14 @@ +{ + "title": "Bedroom CO2", + "subtitle": "Home Assistant live context", + "tool_name": "mcp_home_assistant_GetLiveContext", + "match_name": "Bedroom-Esp-Sensor CO2", + "device_class": "carbon_dioxide", + "unit": "ppm", + "refresh_ms": 15000, + "value_decimals": 0, + "thresholds": { + "good_max": 900, + "elevated_max": 1200 + } +} diff --git a/examples/cards/instances/live-calendar-today/card.json b/examples/cards/instances/live-calendar-today/card.json new file mode 100644 index 0000000..33e57d2 --- /dev/null +++ b/examples/cards/instances/live-calendar-today/card.json @@ -0,0 +1,17 @@ +{ + "id": "live-calendar-today", + "kind": "text", + "title": "Today's Agenda", + "question": "", + "choices": [], + "response_value": "", + "slot": "live-calendar-today", + "lane": "context", + "priority": 50, + "state": "active", + "template_key": "calendar-agenda-live", + "context_summary": "", + "chat_id": "web", + "created_at": "2026-03-09T23:37:10.542306+00:00", + "updated_at": "2026-03-11T04:12:48.601255+00:00" +} diff --git a/examples/cards/instances/live-calendar-today/state.json b/examples/cards/instances/live-calendar-today/state.json new file mode 100644 index 0000000..42c6074 --- /dev/null +++ b/examples/cards/instances/live-calendar-today/state.json @@ -0,0 +1,12 @@ +{ + "title": "Today's Agenda", + "subtitle": "Family Calendar", + "tool_name": "mcp_home_assistant_calendar_get_events", + "calendar_names": [ + "Family Calendar" + ], + "range_days": 1, + "max_events": 8, + "refresh_ms": 900000, + "empty_text": "No events for today." +} diff --git a/examples/cards/instances/live-litellm-ups-usage/card.json b/examples/cards/instances/live-litellm-ups-usage/card.json new file mode 100644 index 0000000..f89404f --- /dev/null +++ b/examples/cards/instances/live-litellm-ups-usage/card.json @@ -0,0 +1,18 @@ +{ + "id": "live-litellm-ups-usage", + "kind": "text", + "title": "LiteLLM + UPS Usage", + "content": "", + "question": "", + "choices": [], + "response_value": "", + "slot": "live-litellm-ups-usage", + "lane": "context", + "priority": 48, + "state": "active", + "template_key": "litellm-ups-usage-live", + "context_summary": "LiteLLM token usage and UPS energy usage for the last 24 hours and current month.", + "chat_id": "web", + "created_at": "2026-03-11T23:05:00+00:00", + "updated_at": "2026-03-11T23:05:00+00:00" +} diff --git a/examples/cards/instances/live-litellm-ups-usage/state.json b/examples/cards/instances/live-litellm-ups-usage/state.json new file mode 100644 index 0000000..769e526 --- /dev/null +++ b/examples/cards/instances/live-litellm-ups-usage/state.json @@ -0,0 +1,8 @@ +{ + "subtitle": "GLM local usage", + "tool_name_24h": "exec", + "tool_arguments_24h": { + "command": "python3 $HOME/.nanobot/workspace/litellm_ups_price_per_token.py --24h" + }, + "refresh_ms": 900000 +} diff --git a/examples/cards/instances/live-nanobot-git-diff/card.json b/examples/cards/instances/live-nanobot-git-diff/card.json new file mode 100644 index 0000000..a5c0309 --- /dev/null +++ b/examples/cards/instances/live-nanobot-git-diff/card.json @@ -0,0 +1,14 @@ +{ + "id": "live-nanobot-git-diff", + "kind": "text", + "title": "nanobot git diff", + "slot": "git-diff:/home/kacper/nanobot", + "lane": "work", + "priority": 72, + "state": "active", + "template_key": "git-diff-live", + "context_summary": "Live git working tree summary for /home/kacper/nanobot.", + "chat_id": "web", + "created_at": "2026-03-12T14:00:00+00:00", + "updated_at": "2026-03-12T14:00:00+00:00" +} diff --git a/examples/cards/instances/live-nanobot-git-diff/state.json b/examples/cards/instances/live-nanobot-git-diff/state.json new file mode 100644 index 0000000..61ccbaa --- /dev/null +++ b/examples/cards/instances/live-nanobot-git-diff/state.json @@ -0,0 +1,8 @@ +{ + "subtitle": "nanobot", + "tool_name": "exec", + "tool_arguments": { + "command": "python3 $HOME/.nanobot/workspace/git_repo_diff_summary.py --repo /home/kacper/nanobot --max-files 8", + "max_output_chars": 200000 + } +} diff --git a/examples/cards/instances/live-weather-01545/card.json b/examples/cards/instances/live-weather-01545/card.json new file mode 100644 index 0000000..c949ef3 --- /dev/null +++ b/examples/cards/instances/live-weather-01545/card.json @@ -0,0 +1,17 @@ +{ + "id": "live-weather-01545", + "kind": "text", + "title": "Weather 01545", + "question": "", + "choices": [], + "response_value": "", + "slot": "live-weather-01545", + "lane": "context", + "priority": 50, + "state": "active", + "template_key": "weather-live", + "context_summary": "", + "chat_id": "web", + "created_at": "2026-03-09T23:26:30.195376+00:00", + "updated_at": "2026-03-11T04:12:48.601255+00:00" +} diff --git a/examples/cards/instances/live-weather-01545/state.json b/examples/cards/instances/live-weather-01545/state.json new file mode 100644 index 0000000..df80a06 --- /dev/null +++ b/examples/cards/instances/live-weather-01545/state.json @@ -0,0 +1,10 @@ +{ + "title": "Weather 01545", + "subtitle": "OpenWeatherMap live context", + "tool_name": "mcp_home_assistant_GetLiveContext", + "provider_prefix": "OpenWeatherMap", + "temperature_name": "OpenWeatherMap Temperature", + "humidity_name": "OpenWeatherMap Humidity", + "condition_label": "OpenWeatherMap live context", + "refresh_ms": 86400000 +} diff --git a/examples/cards/instances/todo-todo-kacpers-to-do-031fac06-1f50-11f1-b5e6-001e06480aef/card.json b/examples/cards/instances/todo-todo-kacpers-to-do-031fac06-1f50-11f1-b5e6-001e06480aef/card.json new file mode 100644 index 0000000..e9ba1c0 --- /dev/null +++ b/examples/cards/instances/todo-todo-kacpers-to-do-031fac06-1f50-11f1-b5e6-001e06480aef/card.json @@ -0,0 +1,14 @@ +{ + "id": "todo-todo-kacpers-to-do-031fac06-1f50-11f1-b5e6-001e06480aef", + "kind": "text", + "title": "buy socks", + "slot": "todo:todo.kacpers_to_do:031fac06-1f50-11f1-b5e6-001e06480aef", + "lane": "attention", + "priority": 70, + "state": "active", + "template_key": "todo-item-live", + "context_summary": "Todo item from Kacper’s To-Do: buy socks", + "chat_id": "web", + "created_at": "2026-03-14T02:46:33.662524+00:00", + "updated_at": "2026-03-14T21:56:17.153704+00:00" +} diff --git a/examples/cards/instances/todo-todo-kacpers-to-do-031fac06-1f50-11f1-b5e6-001e06480aef/state.json b/examples/cards/instances/todo-todo-kacpers-to-do-031fac06-1f50-11f1-b5e6-001e06480aef/state.json new file mode 100644 index 0000000..e020822 --- /dev/null +++ b/examples/cards/instances/todo-todo-kacpers-to-do-031fac06-1f50-11f1-b5e6-001e06480aef/state.json @@ -0,0 +1,14 @@ +{ + "source_id": "ha-todo-kacpers-to-do", + "entity_id": "todo.kacpers_to_do", + "list_name": "Kacper’s To-Do", + "uid": "031fac06-1f50-11f1-b5e6-001e06480aef", + "summary": "buy socks", + "status": "needs_action", + "completed": false, + "due": null, + "due_datetime": null, + "description": null, + "generated_at": "2026-03-14T21:56:17.117855+00:00", + "can_complete": true +} diff --git a/examples/cards/instances/todo-todo-kacpers-to-do-7994f6d2-1f9d-11f1-b5e6-001e06480aef/card.json b/examples/cards/instances/todo-todo-kacpers-to-do-7994f6d2-1f9d-11f1-b5e6-001e06480aef/card.json new file mode 100644 index 0000000..b6b2485 --- /dev/null +++ b/examples/cards/instances/todo-todo-kacpers-to-do-7994f6d2-1f9d-11f1-b5e6-001e06480aef/card.json @@ -0,0 +1,14 @@ +{ + "id": "todo-todo-kacpers-to-do-7994f6d2-1f9d-11f1-b5e6-001e06480aef", + "kind": "text", + "title": "Do the laundry", + "slot": "todo:todo.kacpers_to_do:7994f6d2-1f9d-11f1-b5e6-001e06480aef", + "lane": "attention", + "priority": 70, + "state": "active", + "template_key": "todo-item-live", + "context_summary": "Todo item from Kacper’s To-Do: Do the laundry", + "chat_id": "web", + "created_at": "2026-03-14T12:01:03.651640+00:00", + "updated_at": "2026-03-14T21:56:17.153704+00:00" +} diff --git a/examples/cards/instances/todo-todo-kacpers-to-do-7994f6d2-1f9d-11f1-b5e6-001e06480aef/state.json b/examples/cards/instances/todo-todo-kacpers-to-do-7994f6d2-1f9d-11f1-b5e6-001e06480aef/state.json new file mode 100644 index 0000000..8d49fd0 --- /dev/null +++ b/examples/cards/instances/todo-todo-kacpers-to-do-7994f6d2-1f9d-11f1-b5e6-001e06480aef/state.json @@ -0,0 +1,14 @@ +{ + "source_id": "ha-todo-kacpers-to-do", + "entity_id": "todo.kacpers_to_do", + "list_name": "Kacper’s To-Do", + "uid": "7994f6d2-1f9d-11f1-b5e6-001e06480aef", + "summary": "Do the laundry", + "status": "needs_action", + "completed": false, + "due": null, + "due_datetime": null, + "description": "Scheduled laundry reminder", + "generated_at": "2026-03-14T21:56:17.117855+00:00", + "can_complete": true +} diff --git a/examples/cards/instances/todo-todo-kacpers-to-do-b9b79f12-1ef3-11f1-b5e6-001e06480aef/card.json b/examples/cards/instances/todo-todo-kacpers-to-do-b9b79f12-1ef3-11f1-b5e6-001e06480aef/card.json new file mode 100644 index 0000000..f559670 --- /dev/null +++ b/examples/cards/instances/todo-todo-kacpers-to-do-b9b79f12-1ef3-11f1-b5e6-001e06480aef/card.json @@ -0,0 +1,14 @@ +{ + "id": "todo-todo-kacpers-to-do-b9b79f12-1ef3-11f1-b5e6-001e06480aef", + "kind": "text", + "title": "Pack for Japan", + "slot": "todo:todo.kacpers_to_do:b9b79f12-1ef3-11f1-b5e6-001e06480aef", + "lane": "attention", + "priority": 70, + "state": "active", + "template_key": "todo-item-live", + "context_summary": "Todo item from Kacper’s To-Do: Pack for Japan", + "chat_id": "web", + "created_at": "2026-03-13T16:03:26.838387+00:00", + "updated_at": "2026-03-14T21:56:17.153704+00:00" +} diff --git a/examples/cards/instances/todo-todo-kacpers-to-do-b9b79f12-1ef3-11f1-b5e6-001e06480aef/state.json b/examples/cards/instances/todo-todo-kacpers-to-do-b9b79f12-1ef3-11f1-b5e6-001e06480aef/state.json new file mode 100644 index 0000000..43dd881 --- /dev/null +++ b/examples/cards/instances/todo-todo-kacpers-to-do-b9b79f12-1ef3-11f1-b5e6-001e06480aef/state.json @@ -0,0 +1,14 @@ +{ + "source_id": "ha-todo-kacpers-to-do", + "entity_id": "todo.kacpers_to_do", + "list_name": "Kacper’s To-Do", + "uid": "b9b79f12-1ef3-11f1-b5e6-001e06480aef", + "summary": "Pack for Japan", + "status": "needs_action", + "completed": false, + "due": null, + "due_datetime": null, + "description": null, + "generated_at": "2026-03-14T21:56:17.117855+00:00", + "can_complete": true +} diff --git a/examples/cards/instances/todo-todo-kacpers-to-do-dc554d5e-1fa6-11f1-b5e6-001e06480aef/card.json b/examples/cards/instances/todo-todo-kacpers-to-do-dc554d5e-1fa6-11f1-b5e6-001e06480aef/card.json new file mode 100644 index 0000000..39f0e10 --- /dev/null +++ b/examples/cards/instances/todo-todo-kacpers-to-do-dc554d5e-1fa6-11f1-b5e6-001e06480aef/card.json @@ -0,0 +1,14 @@ +{ + "id": "todo-todo-kacpers-to-do-dc554d5e-1fa6-11f1-b5e6-001e06480aef", + "kind": "text", + "title": "return the sneakers", + "slot": "todo:todo.kacpers_to_do:dc554d5e-1fa6-11f1-b5e6-001e06480aef", + "lane": "attention", + "priority": 70, + "state": "active", + "template_key": "todo-item-live", + "context_summary": "Todo item from Kacper’s To-Do: return the sneakers", + "chat_id": "web", + "created_at": "2026-03-14T13:08:14.788903+00:00", + "updated_at": "2026-03-14T21:56:17.153704+00:00" +} diff --git a/examples/cards/instances/todo-todo-kacpers-to-do-dc554d5e-1fa6-11f1-b5e6-001e06480aef/state.json b/examples/cards/instances/todo-todo-kacpers-to-do-dc554d5e-1fa6-11f1-b5e6-001e06480aef/state.json new file mode 100644 index 0000000..1873852 --- /dev/null +++ b/examples/cards/instances/todo-todo-kacpers-to-do-dc554d5e-1fa6-11f1-b5e6-001e06480aef/state.json @@ -0,0 +1,14 @@ +{ + "source_id": "ha-todo-kacpers-to-do", + "entity_id": "todo.kacpers_to_do", + "list_name": "Kacper’s To-Do", + "uid": "dc554d5e-1fa6-11f1-b5e6-001e06480aef", + "summary": "return the sneakers", + "status": "needs_action", + "completed": false, + "due": null, + "due_datetime": null, + "description": null, + "generated_at": "2026-03-14T21:56:17.117855+00:00", + "can_complete": true +} diff --git a/examples/cards/templates/calendar-agenda-live/manifest.json b/examples/cards/templates/calendar-agenda-live/manifest.json new file mode 100644 index 0000000..3ef8c97 --- /dev/null +++ b/examples/cards/templates/calendar-agenda-live/manifest.json @@ -0,0 +1,18 @@ +{ + "key": "calendar-agenda-live", + "title": "Live Calendar Agenda", + "notes": "Agenda card for one or more Home Assistant calendars. Fill template_state with subtitle, tool_name (defaults to calendar_get_events), optional calendar_names, range_days up to 7, max_events, refresh_ms, and empty_text. The card title comes from the feed header, not the template body.", + "example_state": { + "subtitle": "Family Calendar", + "tool_name": "mcp_home_assistant_calendar_get_events", + "calendar_names": [ + "Family Calendar" + ], + "range_days": 3, + "max_events": 8, + "refresh_ms": 900000, + "empty_text": "No events scheduled." + }, + "created_at": "2026-03-11T04:12:48.601255+00:00", + "updated_at": "2026-03-11T19:18:04.632189+00:00" +} diff --git a/examples/cards/templates/calendar-agenda-live/template.html b/examples/cards/templates/calendar-agenda-live/template.html new file mode 100644 index 0000000..2a0a86d --- /dev/null +++ b/examples/cards/templates/calendar-agenda-live/template.html @@ -0,0 +1,257 @@ +
+
+
Loading…
+
+ +
--
+
No events scheduled.
+ +
Updated --
+
+ diff --git a/examples/cards/templates/git-diff-live/manifest.json b/examples/cards/templates/git-diff-live/manifest.json new file mode 100644 index 0000000..e1debce --- /dev/null +++ b/examples/cards/templates/git-diff-live/manifest.json @@ -0,0 +1,15 @@ +{ + "key": "git-diff-live", + "title": "Git Repo Diff", + "notes": "Manual-refresh git working tree summary for a specific repo directory. Fill template_state with tool_name `exec`, tool_arguments.command running `$HOME/.nanobot/workspace/git_repo_diff_summary.py`, `tool_arguments.max_output_chars` sized for the repo diff payload, and optional subtitle. Refresh it from the card menu. The card shows branch, changed/untracked counts, insertions/deletions, and the top changed files.", + "example_state": { + "subtitle": "nanobot", + "tool_name": "exec", + "tool_arguments": { + "command": "python3 $HOME/.nanobot/workspace/git_repo_diff_summary.py --repo /home/kacper/nanobot --max-files 8", + "max_output_chars": 200000 + } + }, + "created_at": "2026-03-12T14:00:00+00:00", + "updated_at": "2026-03-14T17:00:00-04:00" +} diff --git a/examples/cards/templates/git-diff-live/template.html b/examples/cards/templates/git-diff-live/template.html new file mode 100644 index 0000000..626db78 --- /dev/null +++ b/examples/cards/templates/git-diff-live/template.html @@ -0,0 +1,869 @@ + +
+
+
+
Loading…
+
--
+
+ Loading… +
+ +
+
+
Changed
+
--
+
--
+
+ +
+
Untracked
+
--
+
--
+
+ +
+
Diff
+
+ +-- + - -- +
+
--
+
+
+ +
+
+ diff --git a/examples/cards/templates/litellm-ups-usage-live/manifest.json b/examples/cards/templates/litellm-ups-usage-live/manifest.json new file mode 100644 index 0000000..460e6b5 --- /dev/null +++ b/examples/cards/templates/litellm-ups-usage-live/manifest.json @@ -0,0 +1,19 @@ +{ + "key": "litellm-ups-usage-live", + "title": "LiteLLM + UPS Usage", + "notes": "Exec-backed live usage card for LiteLLM token activity and UPS energy usage. Fill template_state with subtitle, tool_name_24h/tool_arguments_24h, and optional tool_name_month/tool_arguments_month plus refresh_ms. If the month tool call is omitted, the card renders only the 24-hour section. The card title comes from the feed header, not the template body.", + "example_state": { + "subtitle": "GLM local usage", + "tool_name_24h": "exec", + "tool_arguments_24h": { + "command": "python3 $HOME/.nanobot/workspace/litellm_ups_price_per_token.py --24h" + }, + "tool_name_month": "exec", + "tool_arguments_month": { + "command": "python3 $HOME/.nanobot/workspace/litellm_ups_price_per_token.py --month" + }, + "refresh_ms": 900000 + }, + "created_at": "2026-03-11T23:05:00+00:00", + "updated_at": "2026-03-11T23:19:00+00:00" +} diff --git a/examples/cards/templates/litellm-ups-usage-live/template.html b/examples/cards/templates/litellm-ups-usage-live/template.html new file mode 100644 index 0000000..2087e92 --- /dev/null +++ b/examples/cards/templates/litellm-ups-usage-live/template.html @@ -0,0 +1,282 @@ +
+
+
Loading…
+ Loading… +
+ +
+
+
Last 24h
+
+ -- + tokens +
+
--
+
--
+
+ +
+
This Month
+
+ -- + tokens +
+
--
+
--
+
+
+ +
Updated --
+
+ diff --git a/examples/cards/templates/live-bedroom-co2/manifest.json b/examples/cards/templates/live-bedroom-co2/manifest.json new file mode 100644 index 0000000..5e05468 --- /dev/null +++ b/examples/cards/templates/live-bedroom-co2/manifest.json @@ -0,0 +1,8 @@ +{ + "key": "live-bedroom-co2", + "title": "Live Bedroom CO2", + "notes": "Use for live CO2 telemetry card. Pull data through the Home Assistant GetLiveContext MCP tool and match the Bedroom-Esp-Sensor CO2 entry.", + "created_at": "2026-03-09T00:00:00+00:00", + "updated_at": "2026-03-11T04:12:48.601255+00:00", + "deprecated": true +} diff --git a/examples/cards/templates/live-bedroom-co2/template.html b/examples/cards/templates/live-bedroom-co2/template.html new file mode 100644 index 0000000..3092b1b --- /dev/null +++ b/examples/cards/templates/live-bedroom-co2/template.html @@ -0,0 +1,204 @@ +
+
+

Bedroom CO2

+ Loading... +
+ +
+ -- + ppm +
+ +
+ Updated: -- +
+
+ diff --git a/examples/cards/templates/live-calendar-today/manifest.json b/examples/cards/templates/live-calendar-today/manifest.json new file mode 100644 index 0000000..a05ffcb --- /dev/null +++ b/examples/cards/templates/live-calendar-today/manifest.json @@ -0,0 +1,8 @@ +{ + "key": "live-calendar-today", + "title": "Live Calendar Today", + "notes": "Use for today's calendar summary. Pull events through the Home Assistant calendar_get_events MCP tool, optionally pinning calendar_names in template_state.", + "created_at": "2026-03-09T00:00:00+00:00", + "updated_at": "2026-03-11T04:12:48.601255+00:00", + "deprecated": true +} diff --git a/examples/cards/templates/live-calendar-today/template.html b/examples/cards/templates/live-calendar-today/template.html new file mode 100644 index 0000000..501814b --- /dev/null +++ b/examples/cards/templates/live-calendar-today/template.html @@ -0,0 +1,273 @@ +
+
+
+

Today's Calendar

+
Loading calendars...
+
+ Loading... +
+ +
+ Date: -- +
+ +
+ No events for today. +
+ + + +
+ Updated: -- +
+
+ diff --git a/examples/cards/templates/live-weather-01545/manifest.json b/examples/cards/templates/live-weather-01545/manifest.json new file mode 100644 index 0000000..8005da6 --- /dev/null +++ b/examples/cards/templates/live-weather-01545/manifest.json @@ -0,0 +1,8 @@ +{ + "key": "live-weather-01545", + "title": "Live Weather 01545", + "notes": "Use for daily weather card in zip 01545. Pull data through the Home Assistant GetLiveContext MCP tool and match the OpenWeatherMap sensor entries.", + "created_at": "2026-03-09T00:00:00+00:00", + "updated_at": "2026-03-11T04:12:48.601255+00:00", + "deprecated": true +} diff --git a/examples/cards/templates/live-weather-01545/template.html b/examples/cards/templates/live-weather-01545/template.html new file mode 100644 index 0000000..51c5774 --- /dev/null +++ b/examples/cards/templates/live-weather-01545/template.html @@ -0,0 +1,250 @@ +
+
+
+

Weather 01545

+
Source: Home Assistant (weather.openweathermap)
+
+ Loading... +
+ +
+ -- + °F +
+ +
--
+ +
+
Humidity: --
+
Wind: --
+
Pressure: --
+
Updated: --
+
+
+ diff --git a/examples/cards/templates/sensor-live/manifest.json b/examples/cards/templates/sensor-live/manifest.json new file mode 100644 index 0000000..5a8a396 --- /dev/null +++ b/examples/cards/templates/sensor-live/manifest.json @@ -0,0 +1,20 @@ +{ + "key": "sensor-live", + "title": "Live Sensor", + "notes": "Generic live numeric sensor card. Fill template_state with subtitle, tool_name (defaults to Home Assistant GetLiveContext), match_name or match_names, optional device_class, unit, refresh_ms, value_decimals, and optional thresholds.good_max/elevated_max. The card title comes from the feed header, not the template body.", + "example_state": { + "subtitle": "Home Assistant sensor", + "tool_name": "mcp_home_assistant_GetLiveContext", + "match_name": "Bedroom-Esp-Sensor CO2", + "device_class": "carbon_dioxide", + "unit": "ppm", + "refresh_ms": 15000, + "value_decimals": 0, + "thresholds": { + "good_max": 900, + "elevated_max": 1200 + } + }, + "created_at": "2026-03-11T04:12:48.601255+00:00", + "updated_at": "2026-03-11T19:18:04.632189+00:00" +} diff --git a/examples/cards/templates/sensor-live/template.html b/examples/cards/templates/sensor-live/template.html new file mode 100644 index 0000000..72c4788 --- /dev/null +++ b/examples/cards/templates/sensor-live/template.html @@ -0,0 +1,287 @@ +
+
+
Loading…
+ Loading… +
+ +
+ -- + -- +
+ +
+ Updated -- +
+
+ diff --git a/examples/cards/templates/todo-item-live/manifest.json b/examples/cards/templates/todo-item-live/manifest.json new file mode 100644 index 0000000..f92c97e --- /dev/null +++ b/examples/cards/templates/todo-item-live/manifest.json @@ -0,0 +1,23 @@ +{ + "key": "todo-item-live", + "title": "Todo Item", + "notes": "Source-generated card for a single Home Assistant todo item. Do not use a live fetch URL. A card source script writes one card instance per todo uid and fills template_state with the current item fields plus source_id for refresh. The card completes the task by calling the Home Assistant HassListCompleteItem MCP tool with list_name and the task summary.", + "example_state": { + "source_id": "ha-todo-kacpers-to-do", + "entity_id": "todo.kacpers_to_do", + "list_name": "Kacper's To-Do", + "uid": "55be123e-1ef3-11f1-b5e6-001e06480aef", + "summary": "Get sneakers", + "complete_tool_name": "mcp_home_assistant_HassListCompleteItem", + "complete_item": "Get sneakers", + "status": "needs_action", + "completed": false, + "due": null, + "due_datetime": null, + "description": null, + "generated_at": "2026-03-13T16:03:26+00:00", + "can_complete": true + }, + "created_at": "2026-03-13T00:00:00+00:00", + "updated_at": "2026-03-13T00:00:00+00:00" +} diff --git a/examples/cards/templates/todo-item-live/template.html b/examples/cards/templates/todo-item-live/template.html new file mode 100644 index 0000000..cb4fb99 --- /dev/null +++ b/examples/cards/templates/todo-item-live/template.html @@ -0,0 +1,176 @@ +
+
+
+
Todo
+
Loading...
+
+ +
+ +
+
+ +
+ +
+
+ diff --git a/examples/cards/templates/weather-live/manifest.json b/examples/cards/templates/weather-live/manifest.json new file mode 100644 index 0000000..21ab6b1 --- /dev/null +++ b/examples/cards/templates/weather-live/manifest.json @@ -0,0 +1,16 @@ +{ + "key": "weather-live", + "title": "Live Weather", + "notes": "Live weather summary card. Fill template_state with subtitle, tool_name (defaults to Home Assistant GetLiveContext), provider_prefix or exact sensor names, optional condition_label, and refresh_ms. Wind and pressure render when matching sensors exist in the live context payload.", + "example_state": { + "subtitle": "OpenWeatherMap live context", + "tool_name": "mcp_home_assistant_GetLiveContext", + "provider_prefix": "OpenWeatherMap", + "temperature_name": "OpenWeatherMap Temperature", + "humidity_name": "OpenWeatherMap Humidity", + "condition_label": "OpenWeatherMap live context", + "refresh_ms": 86400000 + }, + "created_at": "2026-03-11T04:12:48.601255+00:00", + "updated_at": "2026-03-11T19:18:04.632189+00:00" +} diff --git a/examples/cards/templates/weather-live/template.html b/examples/cards/templates/weather-live/template.html new file mode 100644 index 0000000..7dc4f6f --- /dev/null +++ b/examples/cards/templates/weather-live/template.html @@ -0,0 +1,293 @@ +
+
+
Loading…
+ Loading… +
+ +
+ -- + °F +
+ +
--
+ +
+
+
Humidity
+
--
+
+
+
Wind
+
--
+
+
+
Pressure
+
--
+
+
+
Updated
+
--
+
+
+
+ diff --git a/frontend/src/hooks/useWebRTC.ts b/frontend/src/hooks/useWebRTC.ts index f0c6e32..ba64922 100644 --- a/frontend/src/hooks/useWebRTC.ts +++ b/frontend/src/hooks/useWebRTC.ts @@ -11,6 +11,8 @@ import type { } from "../types"; const BACKEND_URL = import.meta.env.VITE_BACKEND_URL ?? ""; +const WEBRTC_STUN_URL = import.meta.env.VITE_WEBRTC_STUN_URL?.trim() ?? ""; +const LOCAL_ICE_GATHER_TIMEOUT_MS = 350; let cardIdCounter = 0; let logIdCounter = 0; @@ -235,7 +237,10 @@ function waitForIceComplete(pc: RTCPeerConnection): Promise { } }; pc.addEventListener("icegatheringstatechange", check); - setTimeout(resolve, 5000); + setTimeout(() => { + pc.removeEventListener("icegatheringstatechange", check); + resolve(); + }, LOCAL_ICE_GATHER_TIMEOUT_MS); }); } @@ -277,7 +282,11 @@ async function runConnect( refs.localTracksRef.current = audioTracks; } - const pc = new RTCPeerConnection({ iceServers: [{ urls: "stun:stun.l.google.com:19302" }] }); + // Local-only deployments do not need a public STUN server; host candidates are enough + // and avoiding external ICE gathering removes several seconds from startup latency. + const pc = new RTCPeerConnection( + WEBRTC_STUN_URL ? { iceServers: [{ urls: WEBRTC_STUN_URL }] } : undefined, + ); refs.pcRef.current = pc; const newRemoteStream = new MediaStream(); diff --git a/voice_rtc.py b/voice_rtc.py index ec5a61c..d56c6dd 100644 --- a/voice_rtc.py +++ b/voice_rtc.py @@ -83,6 +83,7 @@ BRAILLE_SPINNER_RE = re.compile(r"[\u2800-\u28ff]") TTS_ALLOWED_ASCII = set( "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789 .,!?;:'\"()[]{}@#%&*+-_/<>|" ) +LOCAL_ICE_GATHER_TIMEOUT_S = 0.35 def _sanitize_tts_text(text: str) -> str: @@ -1346,7 +1347,7 @@ class WebRTCVoiceSession: completed.set() with contextlib.suppress(asyncio.TimeoutError): - await asyncio.wait_for(completed.wait(), timeout=3) + await asyncio.wait_for(completed.wait(), timeout=LOCAL_ICE_GATHER_TIMEOUT_S) async def _warmup_stt(self) -> None: try: