langfuse-agent 0.1.6__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.
- langfuse_agent-0.1.6/LICENSE +21 -0
- langfuse_agent-0.1.6/MANIFEST.in +4 -0
- langfuse_agent-0.1.6/PKG-INFO +161 -0
- langfuse_agent-0.1.6/README.md +140 -0
- langfuse_agent-0.1.6/langfuse_agent/__init__.py +68 -0
- langfuse_agent-0.1.6/langfuse_agent/__main__.py +6 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/A2A_AGENTS.md +8 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/AGENTS.md +12 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/CRON.md +12 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/CRON_LOG.md +5 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/HEARTBEAT.md +28 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/IDENTITY.md +15 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/MCP_AGENTS.md +13 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/MEMORY.md +8 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/USER.md +7 -0
- langfuse_agent-0.1.6/langfuse_agent/agent/icon.png +0 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/A2A_AGENTS.md +8 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/CRON.md +7 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/CRON_LOG.md +4 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/HEARTBEAT.md +9 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/IDENTITY.md +15 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/MCP_AGENTS.md +126 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/MEMORY.md +6 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/NODE_AGENTS.md +13 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/USER.md +4 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_data/mcp_config.json +41 -0
- langfuse_agent-0.1.6/langfuse_agent/agent_server.py +79 -0
- langfuse_agent-0.1.6/langfuse_agent/auth.py +14 -0
- langfuse_agent-0.1.6/langfuse_agent/langfuse_api.py +975 -0
- langfuse_agent-0.1.6/langfuse_agent/langfuse_models.py +16 -0
- langfuse_agent-0.1.6/langfuse_agent/mcp_server.py +1144 -0
- langfuse_agent-0.1.6/langfuse_agent.egg-info/PKG-INFO +161 -0
- langfuse_agent-0.1.6/langfuse_agent.egg-info/SOURCES.txt +38 -0
- langfuse_agent-0.1.6/langfuse_agent.egg-info/dependency_links.txt +1 -0
- langfuse_agent-0.1.6/langfuse_agent.egg-info/entry_points.txt +3 -0
- langfuse_agent-0.1.6/langfuse_agent.egg-info/requires.txt +7 -0
- langfuse_agent-0.1.6/langfuse_agent.egg-info/top_level.txt +2 -0
- langfuse_agent-0.1.6/pyproject.toml +41 -0
- langfuse_agent-0.1.6/requirements.txt +5 -0
- langfuse_agent-0.1.6/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: langfuse-agent
|
|
3
|
+
Version: 0.1.6
|
|
4
|
+
Summary: Agent for interacting with Langfuse Observability 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
|
+
# Langfuse 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.1.6*
|
|
46
|
+
|
|
47
|
+
## Overview
|
|
48
|
+
|
|
49
|
+
**Langfuse Agent MCP Server + A2A Agent**
|
|
50
|
+
|
|
51
|
+
Agent for interacting with Langfuse Observability 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
|
+
* `LANGFUSE_URL`: The URL of the target service.
|
|
64
|
+
* `LANGFUSE_TOKEN`: The API token or access token.
|
|
65
|
+
|
|
66
|
+
#### Run in stdio mode (default):
|
|
67
|
+
```bash
|
|
68
|
+
export LANGFUSE_URL="http://localhost:8080"
|
|
69
|
+
export LANGFUSE_TOKEN="your_token"
|
|
70
|
+
langfuse-mcp --transport "stdio"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
#### Run in HTTP mode:
|
|
74
|
+
```bash
|
|
75
|
+
export LANGFUSE_URL="http://localhost:8080"
|
|
76
|
+
export LANGFUSE_TOKEN="your_token"
|
|
77
|
+
langfuse-mcp --transport "http" --host "0.0.0.0" --port "8000"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## A2A Agent
|
|
81
|
+
|
|
82
|
+
### Run A2A Server
|
|
83
|
+
```bash
|
|
84
|
+
export LANGFUSE_URL="http://localhost:8080"
|
|
85
|
+
export LANGFUSE_TOKEN="your_token"
|
|
86
|
+
langfuse-agent --provider openai --model-id gpt-4o --api-key sk-...
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Docker
|
|
90
|
+
|
|
91
|
+
### Build
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
docker build -t langfuse-agent .
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### Run MCP Server
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
docker run -d \
|
|
101
|
+
--name langfuse-agent \
|
|
102
|
+
-p 8000:8000 \
|
|
103
|
+
-e TRANSPORT=http \
|
|
104
|
+
-e LANGFUSE_URL="http://your-service:8080" \
|
|
105
|
+
-e LANGFUSE_TOKEN="your_token" \
|
|
106
|
+
knucklessg1/langfuse-agent:latest
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Deploy with Docker Compose
|
|
110
|
+
|
|
111
|
+
```yaml
|
|
112
|
+
services:
|
|
113
|
+
langfuse-agent:
|
|
114
|
+
image: knucklessg1/langfuse-agent:latest
|
|
115
|
+
environment:
|
|
116
|
+
- HOST=0.0.0.0
|
|
117
|
+
- PORT=8000
|
|
118
|
+
- TRANSPORT=http
|
|
119
|
+
- LANGFUSE_URL=http://your-service:8080
|
|
120
|
+
- LANGFUSE_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
|
+
"langfuse": {
|
|
131
|
+
"command": "uv",
|
|
132
|
+
"args": [
|
|
133
|
+
"run",
|
|
134
|
+
"--with",
|
|
135
|
+
"langfuse-agent",
|
|
136
|
+
"langfuse-mcp"
|
|
137
|
+
],
|
|
138
|
+
"env": {
|
|
139
|
+
"LANGFUSE_URL": "http://your-service:8080",
|
|
140
|
+
"LANGFUSE_TOKEN": "your_token"
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
## Install Python Package
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
python -m pip install langfuse-agent
|
|
151
|
+
```
|
|
152
|
+
```bash
|
|
153
|
+
uv pip install langfuse-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
|
+
# Langfuse 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.1.6*
|
|
25
|
+
|
|
26
|
+
## Overview
|
|
27
|
+
|
|
28
|
+
**Langfuse Agent MCP Server + A2A Agent**
|
|
29
|
+
|
|
30
|
+
Agent for interacting with Langfuse Observability 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
|
+
* `LANGFUSE_URL`: The URL of the target service.
|
|
43
|
+
* `LANGFUSE_TOKEN`: The API token or access token.
|
|
44
|
+
|
|
45
|
+
#### Run in stdio mode (default):
|
|
46
|
+
```bash
|
|
47
|
+
export LANGFUSE_URL="http://localhost:8080"
|
|
48
|
+
export LANGFUSE_TOKEN="your_token"
|
|
49
|
+
langfuse-mcp --transport "stdio"
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
#### Run in HTTP mode:
|
|
53
|
+
```bash
|
|
54
|
+
export LANGFUSE_URL="http://localhost:8080"
|
|
55
|
+
export LANGFUSE_TOKEN="your_token"
|
|
56
|
+
langfuse-mcp --transport "http" --host "0.0.0.0" --port "8000"
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## A2A Agent
|
|
60
|
+
|
|
61
|
+
### Run A2A Server
|
|
62
|
+
```bash
|
|
63
|
+
export LANGFUSE_URL="http://localhost:8080"
|
|
64
|
+
export LANGFUSE_TOKEN="your_token"
|
|
65
|
+
langfuse-agent --provider openai --model-id gpt-4o --api-key sk-...
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Docker
|
|
69
|
+
|
|
70
|
+
### Build
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
docker build -t langfuse-agent .
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### Run MCP Server
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
docker run -d \
|
|
80
|
+
--name langfuse-agent \
|
|
81
|
+
-p 8000:8000 \
|
|
82
|
+
-e TRANSPORT=http \
|
|
83
|
+
-e LANGFUSE_URL="http://your-service:8080" \
|
|
84
|
+
-e LANGFUSE_TOKEN="your_token" \
|
|
85
|
+
knucklessg1/langfuse-agent:latest
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Deploy with Docker Compose
|
|
89
|
+
|
|
90
|
+
```yaml
|
|
91
|
+
services:
|
|
92
|
+
langfuse-agent:
|
|
93
|
+
image: knucklessg1/langfuse-agent:latest
|
|
94
|
+
environment:
|
|
95
|
+
- HOST=0.0.0.0
|
|
96
|
+
- PORT=8000
|
|
97
|
+
- TRANSPORT=http
|
|
98
|
+
- LANGFUSE_URL=http://your-service:8080
|
|
99
|
+
- LANGFUSE_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
|
+
"langfuse": {
|
|
110
|
+
"command": "uv",
|
|
111
|
+
"args": [
|
|
112
|
+
"run",
|
|
113
|
+
"--with",
|
|
114
|
+
"langfuse-agent",
|
|
115
|
+
"langfuse-mcp"
|
|
116
|
+
],
|
|
117
|
+
"env": {
|
|
118
|
+
"LANGFUSE_URL": "http://your-service:8080",
|
|
119
|
+
"LANGFUSE_TOKEN": "your_token"
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## Install Python Package
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
python -m pip install langfuse-agent
|
|
130
|
+
```
|
|
131
|
+
```bash
|
|
132
|
+
uv pip install langfuse-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
|
+
"langfuse_agent.langfuse_api",
|
|
15
|
+
]
|
|
16
|
+
|
|
17
|
+
OPTIONAL_MODULES = {
|
|
18
|
+
"langfuse_agent.agent_server": "agent",
|
|
19
|
+
"langfuse_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("langfuse_agent.mcp_server") in [
|
|
57
|
+
m.__name__ for m in globals().values() if hasattr(m, "__name__")
|
|
58
|
+
]
|
|
59
|
+
_AGENT_AVAILABLE = "langfuse_agent.agent_server" in globals()
|
|
60
|
+
|
|
61
|
+
__all__.extend(["_MCP_AVAILABLE", "_AGENT_AVAILABLE"])
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
"""
|
|
65
|
+
langfuse-agent
|
|
66
|
+
|
|
67
|
+
Agent for interacting with Langfuse Observability 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 - Langfuse Agent Agent Identity
|
|
2
|
+
|
|
3
|
+
## [default]
|
|
4
|
+
* **Name:** Langfuse Agent Agent
|
|
5
|
+
* **Role:** Agent for interacting with Langfuse Observability API
|
|
6
|
+
* **Emoji:** 🤖
|
|
7
|
+
|
|
8
|
+
### System Prompt
|
|
9
|
+
You are the Langfuse 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 `langfuse-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 `langfuse-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.
|