postiz-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.
- postiz_agent-0.2.0/LICENSE +21 -0
- postiz_agent-0.2.0/MANIFEST.in +4 -0
- postiz_agent-0.2.0/PKG-INFO +161 -0
- postiz_agent-0.2.0/README.md +140 -0
- postiz_agent-0.2.0/postiz_agent/__init__.py +68 -0
- postiz_agent-0.2.0/postiz_agent/__main__.py +6 -0
- postiz_agent-0.2.0/postiz_agent/agent/A2A_AGENTS.md +8 -0
- postiz_agent-0.2.0/postiz_agent/agent/AGENTS.md +12 -0
- postiz_agent-0.2.0/postiz_agent/agent/CRON.md +12 -0
- postiz_agent-0.2.0/postiz_agent/agent/CRON_LOG.md +5 -0
- postiz_agent-0.2.0/postiz_agent/agent/HEARTBEAT.md +28 -0
- postiz_agent-0.2.0/postiz_agent/agent/IDENTITY.md +15 -0
- postiz_agent-0.2.0/postiz_agent/agent/MCP_AGENTS.md +13 -0
- postiz_agent-0.2.0/postiz_agent/agent/MEMORY.md +8 -0
- postiz_agent-0.2.0/postiz_agent/agent/USER.md +7 -0
- postiz_agent-0.2.0/postiz_agent/agent/icon.png +0 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/A2A_AGENTS.md +8 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/CRON.md +7 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/CRON_LOG.md +4 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/HEARTBEAT.md +9 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/IDENTITY.md +15 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/MCP_AGENTS.md +25 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/MEMORY.md +6 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/NODE_AGENTS.md +13 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/USER.md +4 -0
- postiz_agent-0.2.0/postiz_agent/agent_data/mcp_config.json +21 -0
- postiz_agent-0.2.0/postiz_agent/agent_server.py +79 -0
- postiz_agent-0.2.0/postiz_agent/auth.py +39 -0
- postiz_agent-0.2.0/postiz_agent/mcp_server.py +311 -0
- postiz_agent-0.2.0/postiz_agent/postiz_api.py +224 -0
- postiz_agent-0.2.0/postiz_agent/postiz_models.py +142 -0
- postiz_agent-0.2.0/postiz_agent.egg-info/PKG-INFO +161 -0
- postiz_agent-0.2.0/postiz_agent.egg-info/SOURCES.txt +38 -0
- postiz_agent-0.2.0/postiz_agent.egg-info/dependency_links.txt +1 -0
- postiz_agent-0.2.0/postiz_agent.egg-info/entry_points.txt +3 -0
- postiz_agent-0.2.0/postiz_agent.egg-info/requires.txt +7 -0
- postiz_agent-0.2.0/postiz_agent.egg-info/top_level.txt +2 -0
- postiz_agent-0.2.0/pyproject.toml +41 -0
- postiz_agent-0.2.0/requirements.txt +5 -0
- postiz_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: postiz-agent
|
|
3
|
+
Version: 0.2.0
|
|
4
|
+
Summary: Agent for interacting with Postiz Public 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
|
+
# Postiz 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
|
+
**Postiz Agent MCP Server + A2A Agent**
|
|
50
|
+
|
|
51
|
+
Agent for interacting with Postiz Public 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
|
+
* `POSTIZ_URL`: The URL of the target service.
|
|
64
|
+
* `POSTIZ_TOKEN`: The API token or access token.
|
|
65
|
+
|
|
66
|
+
#### Run in stdio mode (default):
|
|
67
|
+
```bash
|
|
68
|
+
export POSTIZ_URL="http://localhost:8080"
|
|
69
|
+
export POSTIZ_TOKEN="your_token"
|
|
70
|
+
postiz-mcp --transport "stdio"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
#### Run in HTTP mode:
|
|
74
|
+
```bash
|
|
75
|
+
export POSTIZ_URL="http://localhost:8080"
|
|
76
|
+
export POSTIZ_TOKEN="your_token"
|
|
77
|
+
postiz-mcp --transport "http" --host "0.0.0.0" --port "8000"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## A2A Agent
|
|
81
|
+
|
|
82
|
+
### Run A2A Server
|
|
83
|
+
```bash
|
|
84
|
+
export POSTIZ_URL="http://localhost:8080"
|
|
85
|
+
export POSTIZ_TOKEN="your_token"
|
|
86
|
+
postiz-agent --provider openai --model-id gpt-4o --api-key sk-...
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Docker
|
|
90
|
+
|
|
91
|
+
### Build
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
docker build -t postiz-agent .
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### Run MCP Server
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
docker run -d \
|
|
101
|
+
--name postiz-agent \
|
|
102
|
+
-p 8000:8000 \
|
|
103
|
+
-e TRANSPORT=http \
|
|
104
|
+
-e POSTIZ_URL="http://your-service:8080" \
|
|
105
|
+
-e POSTIZ_TOKEN="your_token" \
|
|
106
|
+
knucklessg1/postiz-agent:latest
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Deploy with Docker Compose
|
|
110
|
+
|
|
111
|
+
```yaml
|
|
112
|
+
services:
|
|
113
|
+
postiz-agent:
|
|
114
|
+
image: knucklessg1/postiz-agent:latest
|
|
115
|
+
environment:
|
|
116
|
+
- HOST=0.0.0.0
|
|
117
|
+
- PORT=8000
|
|
118
|
+
- TRANSPORT=http
|
|
119
|
+
- POSTIZ_URL=http://your-service:8080
|
|
120
|
+
- POSTIZ_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
|
+
"postiz": {
|
|
131
|
+
"command": "uv",
|
|
132
|
+
"args": [
|
|
133
|
+
"run",
|
|
134
|
+
"--with",
|
|
135
|
+
"postiz-agent",
|
|
136
|
+
"postiz-mcp"
|
|
137
|
+
],
|
|
138
|
+
"env": {
|
|
139
|
+
"POSTIZ_URL": "http://your-service:8080",
|
|
140
|
+
"POSTIZ_TOKEN": "your_token"
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
## Install Python Package
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
python -m pip install postiz-agent
|
|
151
|
+
```
|
|
152
|
+
```bash
|
|
153
|
+
uv pip install postiz-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
|
+
# Postiz 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
|
+
**Postiz Agent MCP Server + A2A Agent**
|
|
29
|
+
|
|
30
|
+
Agent for interacting with Postiz Public 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
|
+
* `POSTIZ_URL`: The URL of the target service.
|
|
43
|
+
* `POSTIZ_TOKEN`: The API token or access token.
|
|
44
|
+
|
|
45
|
+
#### Run in stdio mode (default):
|
|
46
|
+
```bash
|
|
47
|
+
export POSTIZ_URL="http://localhost:8080"
|
|
48
|
+
export POSTIZ_TOKEN="your_token"
|
|
49
|
+
postiz-mcp --transport "stdio"
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
#### Run in HTTP mode:
|
|
53
|
+
```bash
|
|
54
|
+
export POSTIZ_URL="http://localhost:8080"
|
|
55
|
+
export POSTIZ_TOKEN="your_token"
|
|
56
|
+
postiz-mcp --transport "http" --host "0.0.0.0" --port "8000"
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## A2A Agent
|
|
60
|
+
|
|
61
|
+
### Run A2A Server
|
|
62
|
+
```bash
|
|
63
|
+
export POSTIZ_URL="http://localhost:8080"
|
|
64
|
+
export POSTIZ_TOKEN="your_token"
|
|
65
|
+
postiz-agent --provider openai --model-id gpt-4o --api-key sk-...
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Docker
|
|
69
|
+
|
|
70
|
+
### Build
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
docker build -t postiz-agent .
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### Run MCP Server
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
docker run -d \
|
|
80
|
+
--name postiz-agent \
|
|
81
|
+
-p 8000:8000 \
|
|
82
|
+
-e TRANSPORT=http \
|
|
83
|
+
-e POSTIZ_URL="http://your-service:8080" \
|
|
84
|
+
-e POSTIZ_TOKEN="your_token" \
|
|
85
|
+
knucklessg1/postiz-agent:latest
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Deploy with Docker Compose
|
|
89
|
+
|
|
90
|
+
```yaml
|
|
91
|
+
services:
|
|
92
|
+
postiz-agent:
|
|
93
|
+
image: knucklessg1/postiz-agent:latest
|
|
94
|
+
environment:
|
|
95
|
+
- HOST=0.0.0.0
|
|
96
|
+
- PORT=8000
|
|
97
|
+
- TRANSPORT=http
|
|
98
|
+
- POSTIZ_URL=http://your-service:8080
|
|
99
|
+
- POSTIZ_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
|
+
"postiz": {
|
|
110
|
+
"command": "uv",
|
|
111
|
+
"args": [
|
|
112
|
+
"run",
|
|
113
|
+
"--with",
|
|
114
|
+
"postiz-agent",
|
|
115
|
+
"postiz-mcp"
|
|
116
|
+
],
|
|
117
|
+
"env": {
|
|
118
|
+
"POSTIZ_URL": "http://your-service:8080",
|
|
119
|
+
"POSTIZ_TOKEN": "your_token"
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## Install Python Package
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
python -m pip install postiz-agent
|
|
130
|
+
```
|
|
131
|
+
```bash
|
|
132
|
+
uv pip install postiz-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
|
+
"postiz_agent.postiz_api",
|
|
15
|
+
]
|
|
16
|
+
|
|
17
|
+
OPTIONAL_MODULES = {
|
|
18
|
+
"postiz_agent.agent_server": "agent",
|
|
19
|
+
"postiz_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("postiz_agent.mcp_server") in [
|
|
57
|
+
m.__name__ for m in globals().values() if hasattr(m, "__name__")
|
|
58
|
+
]
|
|
59
|
+
_AGENT_AVAILABLE = "postiz_agent.agent_server" in globals()
|
|
60
|
+
|
|
61
|
+
__all__.extend(["_MCP_AVAILABLE", "_AGENT_AVAILABLE"])
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
"""
|
|
65
|
+
postiz-agent
|
|
66
|
+
|
|
67
|
+
Agent for interacting with Postiz Public 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 - Postiz Agent Agent Identity
|
|
2
|
+
|
|
3
|
+
## [default]
|
|
4
|
+
* **Name:** Postiz Agent Agent
|
|
5
|
+
* **Role:** Agent for interacting with Postiz Public API
|
|
6
|
+
* **Emoji:** 🤖
|
|
7
|
+
|
|
8
|
+
### System Prompt
|
|
9
|
+
You are the Postiz 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 `postiz-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 `postiz-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,25 @@
|
|
|
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
|
+
| Postiz Analytics Specialist | Expert specialist for analytics domain tasks. | You are a Postiz Analytics specialist. Help users manage and interact with Analytics functionality using the available tools. | postiz_analytics_toolset | analytics | postiz |
|
|
10
|
+
| Postiz Integrations Specialist | Expert specialist for integrations domain tasks. | You are a Postiz Integrations specialist. Help users manage and interact with Integrations functionality using the available tools. | postiz_integrations_toolset | integrations | postiz |
|
|
11
|
+
| Postiz Notifications Specialist | Expert specialist for notifications domain tasks. | You are a Postiz Notifications specialist. Help users manage and interact with Notifications functionality using the available tools. | postiz_notifications_toolset | notifications | postiz |
|
|
12
|
+
| Postiz Posts Specialist | Expert specialist for posts domain tasks. | You are a Postiz Posts specialist. Help users manage and interact with Posts functionality using the available tools. | postiz_posts_toolset | posts | postiz |
|
|
13
|
+
| Postiz Uploads Specialist | Expert specialist for uploads domain tasks. | You are a Postiz Uploads specialist. Help users manage and interact with Uploads functionality using the available tools. | postiz_uploads_toolset | uploads | postiz |
|
|
14
|
+
| Postiz Video Specialist | Expert specialist for video domain tasks. | You are a Postiz Video specialist. Help users manage and interact with Video functionality using the available tools. | postiz_video_toolset | video | postiz |
|
|
15
|
+
|
|
16
|
+
## Tool Inventory Table
|
|
17
|
+
|
|
18
|
+
| Tool Name | Description | Tag | Source |
|
|
19
|
+
|-----------|-------------|-----|--------|
|
|
20
|
+
| postiz_analytics_toolset | Static hint toolset for analytics based on config env. | analytics | postiz |
|
|
21
|
+
| postiz_integrations_toolset | Static hint toolset for integrations based on config env. | integrations | postiz |
|
|
22
|
+
| postiz_notifications_toolset | Static hint toolset for notifications based on config env. | notifications | postiz |
|
|
23
|
+
| postiz_posts_toolset | Static hint toolset for posts based on config env. | posts | postiz |
|
|
24
|
+
| postiz_uploads_toolset | Static hint toolset for uploads based on config env. | uploads | postiz |
|
|
25
|
+
| postiz_video_toolset | Static hint toolset for video based on config env. | video | postiz |
|
|
@@ -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
|
+
|-----------|-------------|-----|--------|
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
{
|
|
2
|
+
"mcpServers": {
|
|
3
|
+
"postiz": {
|
|
4
|
+
"command": "postiz-mcp",
|
|
5
|
+
"args": [
|
|
6
|
+
"--transport",
|
|
7
|
+
"stdio"
|
|
8
|
+
],
|
|
9
|
+
"env": {
|
|
10
|
+
"POSTIZ_URL": "${POSTIZ_URL:-http://localhost:8080}",
|
|
11
|
+
"POSTIZ_TOKEN": "${POSTIZ_TOKEN}",
|
|
12
|
+
"ANALYTICSTOOL": "${ ANALYTICSTOOL:-True }",
|
|
13
|
+
"INTEGRATIONSTOOL": "${ INTEGRATIONSTOOL:-True }",
|
|
14
|
+
"NOTIFICATIONSTOOL": "${ NOTIFICATIONSTOOL:-True }",
|
|
15
|
+
"POSTSTOOL": "${ POSTSTOOL:-True }",
|
|
16
|
+
"UPLOADSTOOL": "${ UPLOADSTOOL:-True }",
|
|
17
|
+
"VIDEOTOOL": "${ VIDEOTOOL:-True }"
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
}
|