home-assistant-agent 0.2.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- home_assistant_agent-0.2.0/LICENSE +21 -0
- home_assistant_agent-0.2.0/MANIFEST.in +4 -0
- home_assistant_agent-0.2.0/PKG-INFO +161 -0
- home_assistant_agent-0.2.0/README.md +140 -0
- home_assistant_agent-0.2.0/home_assistant_agent/__init__.py +68 -0
- home_assistant_agent-0.2.0/home_assistant_agent/__main__.py +6 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/A2A_AGENTS.md +8 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/AGENTS.md +12 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/CRON.md +12 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/CRON_LOG.md +5 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/HEARTBEAT.md +28 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/IDENTITY.md +15 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/MCP_AGENTS.md +13 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/MEMORY.md +8 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/USER.md +7 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent/icon.png +0 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/A2A_AGENTS.md +8 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/CRON.md +7 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/CRON_LOG.md +4 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/HEARTBEAT.md +9 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/IDENTITY.md +15 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/MCP_AGENTS.md +54 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/MEMORY.md +6 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/NODE_AGENTS.md +13 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/USER.md +4 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_data/mcp_config.json +15 -0
- home_assistant_agent-0.2.0/home_assistant_agent/agent_server.py +81 -0
- home_assistant_agent-0.2.0/home_assistant_agent/auth.py +40 -0
- home_assistant_agent-0.2.0/home_assistant_agent/home_assistant_api.py +398 -0
- home_assistant_agent-0.2.0/home_assistant_agent/home_assistant_models.py +115 -0
- home_assistant_agent-0.2.0/home_assistant_agent/mcp_server.py +405 -0
- home_assistant_agent-0.2.0/home_assistant_agent.egg-info/PKG-INFO +161 -0
- home_assistant_agent-0.2.0/home_assistant_agent.egg-info/SOURCES.txt +38 -0
- home_assistant_agent-0.2.0/home_assistant_agent.egg-info/dependency_links.txt +1 -0
- home_assistant_agent-0.2.0/home_assistant_agent.egg-info/entry_points.txt +3 -0
- home_assistant_agent-0.2.0/home_assistant_agent.egg-info/requires.txt +7 -0
- home_assistant_agent-0.2.0/home_assistant_agent.egg-info/top_level.txt +2 -0
- home_assistant_agent-0.2.0/pyproject.toml +41 -0
- home_assistant_agent-0.2.0/requirements.txt +5 -0
- home_assistant_agent-0.2.0/setup.cfg +4 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Audel Rouhi
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: home-assistant-agent
|
|
3
|
+
Version: 0.2.0
|
|
4
|
+
Summary: Agent for interacting with Home Assistant REST API
|
|
5
|
+
Author-email: Audel Rouhi <knucklessg1@gmail.com>
|
|
6
|
+
License: MIT
|
|
7
|
+
Classifier: Development Status :: 4 - Beta
|
|
8
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
9
|
+
Classifier: Environment :: Console
|
|
10
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
11
|
+
Classifier: Programming Language :: Python :: 3
|
|
12
|
+
Requires-Python: >=3.10
|
|
13
|
+
Description-Content-Type: text/markdown
|
|
14
|
+
License-File: LICENSE
|
|
15
|
+
Requires-Dist: agent-utilities[mcp]>=0.2.12
|
|
16
|
+
Provides-Extra: agent
|
|
17
|
+
Requires-Dist: agent-utilities[agent,logfire]>=0.2.12; extra == "agent"
|
|
18
|
+
Provides-Extra: all
|
|
19
|
+
Requires-Dist: agent-utilities[agent,logfire,mcp]>=0.2.12; extra == "all"
|
|
20
|
+
Dynamic: license-file
|
|
21
|
+
|
|
22
|
+
# Home Assistant Agent - A2A | AG-UI | MCP
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
*Version: 0.2.0*
|
|
46
|
+
|
|
47
|
+
## Overview
|
|
48
|
+
|
|
49
|
+
**Home Assistant Agent MCP Server + A2A Agent**
|
|
50
|
+
|
|
51
|
+
Agent for interacting with Home Assistant REST API
|
|
52
|
+
|
|
53
|
+
This repository is actively maintained - Contributions are welcome!
|
|
54
|
+
|
|
55
|
+
## MCP
|
|
56
|
+
|
|
57
|
+
### Using as an MCP Server
|
|
58
|
+
|
|
59
|
+
The MCP Server can be run in two modes: `stdio` (for local testing) or `http` (for networked access).
|
|
60
|
+
|
|
61
|
+
#### Environment Variables
|
|
62
|
+
|
|
63
|
+
* `HOME_ASSISTANT_URL`: The URL of the target service.
|
|
64
|
+
* `HOME_ASSISTANT_TOKEN`: The API token or access token.
|
|
65
|
+
|
|
66
|
+
#### Run in stdio mode (default):
|
|
67
|
+
```bash
|
|
68
|
+
export HOME_ASSISTANT_URL="http://localhost:8080"
|
|
69
|
+
export HOME_ASSISTANT_TOKEN="your_token"
|
|
70
|
+
home-assistant-mcp --transport "stdio"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
#### Run in HTTP mode:
|
|
74
|
+
```bash
|
|
75
|
+
export HOME_ASSISTANT_URL="http://localhost:8080"
|
|
76
|
+
export HOME_ASSISTANT_TOKEN="your_token"
|
|
77
|
+
home-assistant-mcp --transport "http" --host "0.0.0.0" --port "8000"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## A2A Agent
|
|
81
|
+
|
|
82
|
+
### Run A2A Server
|
|
83
|
+
```bash
|
|
84
|
+
export HOME_ASSISTANT_URL="http://localhost:8080"
|
|
85
|
+
export HOME_ASSISTANT_TOKEN="your_token"
|
|
86
|
+
home-assistant-agent --provider openai --model-id gpt-4o --api-key sk-...
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Docker
|
|
90
|
+
|
|
91
|
+
### Build
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
docker build -t home-assistant-agent .
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### Run MCP Server
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
docker run -d \
|
|
101
|
+
--name home-assistant-agent \
|
|
102
|
+
-p 8000:8000 \
|
|
103
|
+
-e TRANSPORT=http \
|
|
104
|
+
-e HOME_ASSISTANT_URL="http://your-service:8080" \
|
|
105
|
+
-e HOME_ASSISTANT_TOKEN="your_token" \
|
|
106
|
+
knucklessg1/home-assistant-agent:latest
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Deploy with Docker Compose
|
|
110
|
+
|
|
111
|
+
```yaml
|
|
112
|
+
services:
|
|
113
|
+
home-assistant-agent:
|
|
114
|
+
image: knucklessg1/home-assistant-agent:latest
|
|
115
|
+
environment:
|
|
116
|
+
- HOST=0.0.0.0
|
|
117
|
+
- PORT=8000
|
|
118
|
+
- TRANSPORT=http
|
|
119
|
+
- HOME_ASSISTANT_URL=http://your-service:8080
|
|
120
|
+
- HOME_ASSISTANT_TOKEN=your_token
|
|
121
|
+
ports:
|
|
122
|
+
- 8000:8000
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
#### Configure `mcp.json` for AI Integration (e.g. Claude Desktop)
|
|
126
|
+
|
|
127
|
+
```json
|
|
128
|
+
{
|
|
129
|
+
"mcpServers": {
|
|
130
|
+
"home-assistant": {
|
|
131
|
+
"command": "uv",
|
|
132
|
+
"args": [
|
|
133
|
+
"run",
|
|
134
|
+
"--with",
|
|
135
|
+
"home-assistant-agent",
|
|
136
|
+
"home-assistant-mcp"
|
|
137
|
+
],
|
|
138
|
+
"env": {
|
|
139
|
+
"HOME_ASSISTANT_URL": "http://your-service:8080",
|
|
140
|
+
"HOME_ASSISTANT_TOKEN": "your_token"
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
## Install Python Package
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
python -m pip install home-assistant-agent
|
|
151
|
+
```
|
|
152
|
+
```bash
|
|
153
|
+
uv pip install home-assistant-agent
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## Repository Owners
|
|
157
|
+
|
|
158
|
+
<img width="100%" height="180em" src="https://github-readme-stats.vercel.app/api?username=Knucklessg1&show_icons=true&hide_border=true&&count_private=true&include_all_commits=true" />
|
|
159
|
+
|
|
160
|
+
|
|
161
|
+
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
# Home Assistant Agent - A2A | AG-UI | MCP
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
*Version: 0.2.0*
|
|
25
|
+
|
|
26
|
+
## Overview
|
|
27
|
+
|
|
28
|
+
**Home Assistant Agent MCP Server + A2A Agent**
|
|
29
|
+
|
|
30
|
+
Agent for interacting with Home Assistant REST API
|
|
31
|
+
|
|
32
|
+
This repository is actively maintained - Contributions are welcome!
|
|
33
|
+
|
|
34
|
+
## MCP
|
|
35
|
+
|
|
36
|
+
### Using as an MCP Server
|
|
37
|
+
|
|
38
|
+
The MCP Server can be run in two modes: `stdio` (for local testing) or `http` (for networked access).
|
|
39
|
+
|
|
40
|
+
#### Environment Variables
|
|
41
|
+
|
|
42
|
+
* `HOME_ASSISTANT_URL`: The URL of the target service.
|
|
43
|
+
* `HOME_ASSISTANT_TOKEN`: The API token or access token.
|
|
44
|
+
|
|
45
|
+
#### Run in stdio mode (default):
|
|
46
|
+
```bash
|
|
47
|
+
export HOME_ASSISTANT_URL="http://localhost:8080"
|
|
48
|
+
export HOME_ASSISTANT_TOKEN="your_token"
|
|
49
|
+
home-assistant-mcp --transport "stdio"
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
#### Run in HTTP mode:
|
|
53
|
+
```bash
|
|
54
|
+
export HOME_ASSISTANT_URL="http://localhost:8080"
|
|
55
|
+
export HOME_ASSISTANT_TOKEN="your_token"
|
|
56
|
+
home-assistant-mcp --transport "http" --host "0.0.0.0" --port "8000"
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## A2A Agent
|
|
60
|
+
|
|
61
|
+
### Run A2A Server
|
|
62
|
+
```bash
|
|
63
|
+
export HOME_ASSISTANT_URL="http://localhost:8080"
|
|
64
|
+
export HOME_ASSISTANT_TOKEN="your_token"
|
|
65
|
+
home-assistant-agent --provider openai --model-id gpt-4o --api-key sk-...
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Docker
|
|
69
|
+
|
|
70
|
+
### Build
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
docker build -t home-assistant-agent .
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### Run MCP Server
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
docker run -d \
|
|
80
|
+
--name home-assistant-agent \
|
|
81
|
+
-p 8000:8000 \
|
|
82
|
+
-e TRANSPORT=http \
|
|
83
|
+
-e HOME_ASSISTANT_URL="http://your-service:8080" \
|
|
84
|
+
-e HOME_ASSISTANT_TOKEN="your_token" \
|
|
85
|
+
knucklessg1/home-assistant-agent:latest
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Deploy with Docker Compose
|
|
89
|
+
|
|
90
|
+
```yaml
|
|
91
|
+
services:
|
|
92
|
+
home-assistant-agent:
|
|
93
|
+
image: knucklessg1/home-assistant-agent:latest
|
|
94
|
+
environment:
|
|
95
|
+
- HOST=0.0.0.0
|
|
96
|
+
- PORT=8000
|
|
97
|
+
- TRANSPORT=http
|
|
98
|
+
- HOME_ASSISTANT_URL=http://your-service:8080
|
|
99
|
+
- HOME_ASSISTANT_TOKEN=your_token
|
|
100
|
+
ports:
|
|
101
|
+
- 8000:8000
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
#### Configure `mcp.json` for AI Integration (e.g. Claude Desktop)
|
|
105
|
+
|
|
106
|
+
```json
|
|
107
|
+
{
|
|
108
|
+
"mcpServers": {
|
|
109
|
+
"home-assistant": {
|
|
110
|
+
"command": "uv",
|
|
111
|
+
"args": [
|
|
112
|
+
"run",
|
|
113
|
+
"--with",
|
|
114
|
+
"home-assistant-agent",
|
|
115
|
+
"home-assistant-mcp"
|
|
116
|
+
],
|
|
117
|
+
"env": {
|
|
118
|
+
"HOME_ASSISTANT_URL": "http://your-service:8080",
|
|
119
|
+
"HOME_ASSISTANT_TOKEN": "your_token"
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## Install Python Package
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
python -m pip install home-assistant-agent
|
|
130
|
+
```
|
|
131
|
+
```bash
|
|
132
|
+
uv pip install home-assistant-agent
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
## Repository Owners
|
|
136
|
+
|
|
137
|
+
<img width="100%" height="180em" src="https://github-readme-stats.vercel.app/api?username=Knucklessg1&show_icons=true&hide_border=true&&count_private=true&include_all_commits=true" />
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
#!/usr/bin/env python
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
import importlib
|
|
5
|
+
import inspect
|
|
6
|
+
import warnings
|
|
7
|
+
from typing import List
|
|
8
|
+
|
|
9
|
+
warnings.filterwarnings("ignore", message=".*urllib3.*or chardet.*")
|
|
10
|
+
|
|
11
|
+
__all__: List[str] = []
|
|
12
|
+
|
|
13
|
+
CORE_MODULES = [
|
|
14
|
+
"home_assistant_agent.home_api",
|
|
15
|
+
]
|
|
16
|
+
|
|
17
|
+
OPTIONAL_MODULES = {
|
|
18
|
+
"home_assistant_agent.agent_server": "agent",
|
|
19
|
+
"home_assistant_agent.mcp_server": "mcp",
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def _import_module_safely(module_name: str):
|
|
24
|
+
"""Try to import a module and return it, or None if not available."""
|
|
25
|
+
try:
|
|
26
|
+
return importlib.import_module(module_name)
|
|
27
|
+
except ImportError:
|
|
28
|
+
return None
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def _expose_members(module):
|
|
32
|
+
"""Expose public classes and functions from a module into globals and __all__."""
|
|
33
|
+
for name, obj in inspect.getmembers(module):
|
|
34
|
+
if (inspect.isclass(obj) or inspect.isfunction(obj)) and not name.startswith(
|
|
35
|
+
"_"
|
|
36
|
+
):
|
|
37
|
+
globals()[name] = obj
|
|
38
|
+
__all__.append(name)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
for module_name in CORE_MODULES:
|
|
42
|
+
try:
|
|
43
|
+
module = importlib.import_module(module_name)
|
|
44
|
+
_expose_members(module)
|
|
45
|
+
except ImportError:
|
|
46
|
+
pass
|
|
47
|
+
|
|
48
|
+
for module_name, extra_name in OPTIONAL_MODULES.items():
|
|
49
|
+
module = _import_module_safely(module_name)
|
|
50
|
+
if module is not None:
|
|
51
|
+
_expose_members(module)
|
|
52
|
+
globals()[f"_{extra_name.upper()}_AVAILABLE"] = True
|
|
53
|
+
else:
|
|
54
|
+
globals()[f"_{extra_name.upper()}_AVAILABLE"] = False
|
|
55
|
+
|
|
56
|
+
_MCP_AVAILABLE = OPTIONAL_MODULES.get("home_assistant_agent.mcp_server") in [
|
|
57
|
+
m.__name__ for m in globals().values() if hasattr(m, "__name__")
|
|
58
|
+
]
|
|
59
|
+
_AGENT_AVAILABLE = "home_assistant_agent.agent_server" in globals()
|
|
60
|
+
|
|
61
|
+
__all__.extend(["_MCP_AVAILABLE", "_AGENT_AVAILABLE"])
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
"""
|
|
65
|
+
home-assistant-agent
|
|
66
|
+
|
|
67
|
+
Agent for interacting with Home Assistant REST API
|
|
68
|
+
"""
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# A2A_AGENTS.md - Known A2A Peer Agents
|
|
2
|
+
|
|
3
|
+
This file is the local registry of other A2A agents this agent can discover and call.
|
|
4
|
+
|
|
5
|
+
## Registered A2A Peers
|
|
6
|
+
|
|
7
|
+
| Name | Endpoint URL | Description | Capabilities | Auth | Notes / Last Connected |
|
|
8
|
+
|------|--------------|-------------|--------------|------|------------------------|
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# AGENTS.md - Known A2A Peer Agents
|
|
2
|
+
Last updated: 2026-03-29
|
|
3
|
+
|
|
4
|
+
This file is the local registry of other A2A agents this agent can discover and call.
|
|
5
|
+
|
|
6
|
+
## Registered A2A Peers
|
|
7
|
+
|
|
8
|
+
| Name | Endpoint URL | Description | Capabilities | Auth | Notes / Last Connected |
|
|
9
|
+
|-----------------|---------------------------------|--------------------------------------|----------------------------------|-----------|------------------------|
|
|
10
|
+
| SearchMaster | http://search-agent:9000/a2a | Advanced web researcher | web_search, summarize, browse | none | 2026-03-29 |
|
|
11
|
+
|
|
12
|
+
*Add new rows manually or let the agent call `register_a2a_peer(...)`.*
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# CRON.md - Persistent Scheduled Tasks
|
|
2
|
+
Last updated: 2026-03-29
|
|
3
|
+
|
|
4
|
+
## Active Tasks
|
|
5
|
+
|
|
6
|
+
| ID | Name | Interval (min) | Prompt | Last run | Next approx |
|
|
7
|
+
|-------------|-------------------|----------------|-------------------------------------|-------------------|-------------|
|
|
8
|
+
| heartbeat | Heartbeat | 30 | @HEARTBEAT.md | — | — |
|
|
9
|
+
| log-cleanup | Log Cleanup | 720 | __internal:cleanup_cron_log | — | — |
|
|
10
|
+
|
|
11
|
+
*Edit this table to add/remove tasks. The agent reloads it periodically.*
|
|
12
|
+
*Use `@filename.md` in the Prompt column to load a multi-line prompt from a workspace file.*
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Heartbeat — Periodic Self-Check
|
|
2
|
+
|
|
3
|
+
You are running a scheduled heartbeat. Perform these checks and report results concisely.
|
|
4
|
+
|
|
5
|
+
## Checks
|
|
6
|
+
|
|
7
|
+
1. **Tool Availability** — Call `list_tools` or equivalent to verify your MCP tools are reachable. Report any connection failures.
|
|
8
|
+
2. **Memory Review** — Read `MEMORY.md` and check for any pending follow-up tasks or action items. List any that are overdue.
|
|
9
|
+
3. **Cron Log** — Read `CRON_LOG.md` and check for recent errors (❌). Summarize any failures from the last 24 hours.
|
|
10
|
+
4. **Peer Agents** — Read `AGENTS.md` and note if any registered peers need attention.
|
|
11
|
+
5. **Domain-Specific Checks**:
|
|
12
|
+
- **Service Health**: Check service health status and scan recent logs for critical errors using available tools.
|
|
13
|
+
6. **Self-Diagnostics** — Report your current model, available tool count, and any anomalies.
|
|
14
|
+
|
|
15
|
+
## Response Format
|
|
16
|
+
|
|
17
|
+
If everything is healthy:
|
|
18
|
+
```
|
|
19
|
+
HEARTBEAT_OK — All systems nominal. [tool_count] tools available. No pending actions.
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
If issues found:
|
|
23
|
+
```
|
|
24
|
+
HEARTBEAT_ALERT — [summary of issues found]
|
|
25
|
+
- Issue 1: ...
|
|
26
|
+
- Issue 2: ...
|
|
27
|
+
- Action needed: ...
|
|
28
|
+
```
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# IDENTITY.md - Home Assistant Agent Agent Identity
|
|
2
|
+
|
|
3
|
+
## [default]
|
|
4
|
+
* **Name:** Home Assistant Agent Agent
|
|
5
|
+
* **Role:** Agent for interacting with Home Assistant REST API
|
|
6
|
+
* **Emoji:** 🤖
|
|
7
|
+
|
|
8
|
+
### System Prompt
|
|
9
|
+
You are the Home Assistant Agent Agent.
|
|
10
|
+
You must always first run `list_skills` to show all skills.
|
|
11
|
+
Then, use the `mcp-client` universal skill and check the reference documentation for `home-assistant-agent.md` to discover the exact tags and tools available for your capabilities.
|
|
12
|
+
|
|
13
|
+
### Capabilities
|
|
14
|
+
- **MCP Operations**: Leverage the `mcp-client` skill to interact with the target MCP server. Refer to `home-assistant-agent.md` for specific tool capabilities.
|
|
15
|
+
- **Custom Agent**: Handle custom tasks or general tasks.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# MCP_AGENTS.md - Dynamic Agent Registry
|
|
2
|
+
|
|
3
|
+
This file tracks the generated agents from MCP servers. You can manually modify the 'Tools' list to customize agent expertise.
|
|
4
|
+
|
|
5
|
+
## Agent Mapping Table
|
|
6
|
+
|
|
7
|
+
| Name | Description | System Prompt | Tools | Tag | Source MCP |
|
|
8
|
+
|------|-------------|---------------|-------|-----|------------|
|
|
9
|
+
|
|
10
|
+
## Tool Inventory Table
|
|
11
|
+
|
|
12
|
+
| Tool Name | Description | Tag | Source |
|
|
13
|
+
|-----------|-------------|-----|--------|
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# MEMORY.md - Long-term Memory
|
|
2
|
+
Last updated: 2026-03-29
|
|
3
|
+
|
|
4
|
+
This file stores important decisions, user preferences, and historical outcomes.
|
|
5
|
+
The agent should read this if the user asks "remember when" or similar.
|
|
6
|
+
|
|
7
|
+
## Log of Important Events
|
|
8
|
+
- [2026-03-29] Workspace initialized with advanced agent features.
|
|
File without changes
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# A2A_AGENTS.md - Known A2A Peer Agents
|
|
2
|
+
|
|
3
|
+
This file is the local registry of other A2A agents this agent can discover and call.
|
|
4
|
+
|
|
5
|
+
## Registered A2A Peers
|
|
6
|
+
|
|
7
|
+
| Name | Endpoint URL | Description | Capabilities | Auth | Notes / Last Connected |
|
|
8
|
+
|------|--------------|-------------|--------------|------|------------------------|
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# CRON.md - Persistent Scheduled Tasks
|
|
2
|
+
|
|
3
|
+
## Active Tasks
|
|
4
|
+
|
|
5
|
+
| ID | Name | Interval (min) | Prompt | Last run | Next approx |
|
|
6
|
+
|----|------|----------------|--------|----------|-------------|
|
|
7
|
+
| log-cleanup | Log Cleanup | 720 | __internal:cleanup_cron_log | — | — |
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Heartbeat — Periodic Self-Check
|
|
2
|
+
|
|
3
|
+
You are running a self-diagnostic heartbeat.
|
|
4
|
+
Please verify that:
|
|
5
|
+
1. Your core skills and MCP tools are responsive.
|
|
6
|
+
2. The user's recent instructions are still being followed.
|
|
7
|
+
3. Your long-term memory (MEMORY.md) is updated if necessary.
|
|
8
|
+
|
|
9
|
+
No specific user input is required unless you detect an issue.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# IDENTITY.md - Who I Am, Core Personality, & Boundaries
|
|
2
|
+
|
|
3
|
+
## [default]
|
|
4
|
+
* **Name:** AI Agent
|
|
5
|
+
* **Role:** A versatile AI agent capable of research, task delegation, and workspace management.
|
|
6
|
+
* **Emoji:** 🤖
|
|
7
|
+
* **Vibe:** Professional, efficient, helpful
|
|
8
|
+
|
|
9
|
+
### System Prompt
|
|
10
|
+
You are a highly capable AI Agent.
|
|
11
|
+
You have access to various tools and MCP servers to assist the user.
|
|
12
|
+
Your responsibilities:
|
|
13
|
+
1. Analyze the user's request.
|
|
14
|
+
2. Use available tools and skills to gather information or perform actions.
|
|
15
|
+
Synthesize findings into clear, well-structured responses.
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# MCP_AGENTS.md - Dynamic Agent Registry
|
|
2
|
+
|
|
3
|
+
This file tracks the generated agents from MCP servers. You can manually modify the 'Tools' list to customize agent expertise.
|
|
4
|
+
|
|
5
|
+
## Agent Mapping Table
|
|
6
|
+
|
|
7
|
+
| Name | Description | System Prompt | Tools | Tag | Source MCP |
|
|
8
|
+
|------|-------------|---------------|-------|-----|------------|
|
|
9
|
+
| Home Config Specialist | Expert specialist for config domain tasks. | You are a Home Config specialist. Help users manage and interact with Config functionality using the available tools. | ha-status, ha-config, ha-components, ha-check-config | config | home |
|
|
10
|
+
| Home States Specialist | Expert specialist for states domain tasks. | You are a Home States specialist. Help users manage and interact with States functionality using the available tools. | ha-list-states, ha-get-state, ha-update-state, ha-delete-state | states | home |
|
|
11
|
+
| Home Services Specialist | Expert specialist for services domain tasks. | You are a Home Services specialist. Help users manage and interact with Services functionality using the available tools. | ha-list-services, ha-call-service | services | home |
|
|
12
|
+
| Home Events Specialist | Expert specialist for events domain tasks. | You are a Home Events specialist. Help users manage and interact with Events functionality using the available tools. | ha-list-events, ha-fire-event, ha-subscribe-events | events | home |
|
|
13
|
+
| Home History Specialist | Expert specialist for history domain tasks. | You are a Home History specialist. Help users manage and interact with History functionality using the available tools. | ha-get-history | history | home |
|
|
14
|
+
| Home Logbook Specialist | Expert specialist for logbook domain tasks. | You are a Home Logbook specialist. Help users manage and interact with Logbook functionality using the available tools. | ha-get-logbook, ha-get-error-log | logbook | home |
|
|
15
|
+
| Home Calendar Specialist | Expert specialist for calendar domain tasks. | You are a Home Calendar specialist. Help users manage and interact with Calendar functionality using the available tools. | ha-list-calendars, ha-get-calendar-events | calendar | home |
|
|
16
|
+
| Home Panels Specialist | Expert specialist for panels domain tasks. | You are a Home Panels specialist. Help users manage and interact with Panels functionality using the available tools. | ha-get-panels | panels | home |
|
|
17
|
+
| Home Voice Specialist | Expert specialist for voice domain tasks. | You are a Home Voice specialist. Help users manage and interact with Voice functionality using the available tools. | ha-list-exposed-entities, ha-expose-entities | voice | home |
|
|
18
|
+
| Home Entities Specialist | Expert specialist for entities domain tasks. | You are a Home Entities specialist. Help users manage and interact with Entities functionality using the available tools. | ha-get-entity-registry-display, ha-extract-from-target, ha-get-triggers-for-target, ha-get-conditions-for-target, ha-get-services-for-target | entities | home |
|
|
19
|
+
| Home System Specialist | Expert specialist for system domain tasks. | You are a Home System specialist. Help users manage and interact with System functionality using the available tools. | ha-render-template, ha-ping, ha-handle-intent, ha-validate-config | system | home |
|
|
20
|
+
|
|
21
|
+
## Tool Inventory Table
|
|
22
|
+
|
|
23
|
+
| Tool Name | Description | Tag | Source |
|
|
24
|
+
|-----------|-------------|-----|--------|
|
|
25
|
+
| ha-status | Check if Home Assistant API is up and running. | config | home |
|
|
26
|
+
| ha-config | Get Home Assistant configuration. | config | home |
|
|
27
|
+
| ha-components | List currently loaded components. | config | home |
|
|
28
|
+
| ha-check-config | Trigger a check of configuration.yaml. | config | home |
|
|
29
|
+
| ha-list-states | Return a list of all entity states. | states | home |
|
|
30
|
+
| ha-get-state | Return the state of a specific entity. | states | home |
|
|
31
|
+
| ha-update-state | Updates or creates a state for an entity (internal representation). | states | home |
|
|
32
|
+
| ha-delete-state | Deletes an entity state. | states | home |
|
|
33
|
+
| ha-list-services | List all available services. | services | home |
|
|
34
|
+
| ha-call-service | Call a service (e.g., turn a light on). | services | home |
|
|
35
|
+
| ha-list-events | List all event types and listener counts. | events | home |
|
|
36
|
+
| ha-fire-event | Fire an event on the Home Assistant event bus. | events | home |
|
|
37
|
+
| ha-subscribe-events | Subscribe to events (one-shot check). | events | home |
|
|
38
|
+
| ha-get-history | Get history of one or more entities. | history | home |
|
|
39
|
+
| ha-get-logbook | Get logbook entries. | logbook | home |
|
|
40
|
+
| ha-get-error-log | Retrieve all errors logged during the current session. | logbook | home |
|
|
41
|
+
| ha-list-calendars | List calendar entities. | calendar | home |
|
|
42
|
+
| ha-get-calendar-events | Get events for a calendar. | calendar | home |
|
|
43
|
+
| ha-get-panels | Get registered panels in Home Assistant. | panels | home |
|
|
44
|
+
| ha-list-exposed-entities | List exposure status of entities across all assistants. | voice | home |
|
|
45
|
+
| ha-expose-entities | Expose or unexpose entities to voice assistants. | voice | home |
|
|
46
|
+
| ha-get-entity-registry-display | Get lightweight, optimized list of entity registry entries for UI display. | entities | home |
|
|
47
|
+
| ha-extract-from-target | Extract entities, devices, and areas from one or multiple targets. | entities | home |
|
|
48
|
+
| ha-get-triggers-for-target | Get applicable triggers for entities of a given target. | entities | home |
|
|
49
|
+
| ha-get-conditions-for-target | Get applicable conditions for entities of a given target. | entities | home |
|
|
50
|
+
| ha-get-services-for-target | Get applicable services for entities of a given target. | entities | home |
|
|
51
|
+
| ha-render-template | Render a Home Assistant template. | system | home |
|
|
52
|
+
| ha-ping | Ping the Home Assistant WebSocket API. | system | home |
|
|
53
|
+
| ha-handle-intent | Handle an intent in Home Assistant. | system | home |
|
|
54
|
+
| ha-validate-config | Validate triggers, conditions, and action configurations. | system | home |
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# NODE_AGENTS.md - Dynamic Agent Registry
|
|
2
|
+
|
|
3
|
+
This file tracks the generated agents from MCP servers, Universal Skills, and Skill Graphs.
|
|
4
|
+
|
|
5
|
+
## Agent Mapping Table
|
|
6
|
+
|
|
7
|
+
| Name | Description | System Prompt | Tools | Tag / ID | Source MCP / Skill |
|
|
8
|
+
|------|-------------|---------------|-------|----------|--------------------|
|
|
9
|
+
|
|
10
|
+
## Tool Inventory Table
|
|
11
|
+
|
|
12
|
+
| Tool Name | Description | Tag | Source |
|
|
13
|
+
|-----------|-------------|-----|--------|
|