atlassian-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.
- atlassian_agent-0.1.6/LICENSE +21 -0
- atlassian_agent-0.1.6/MANIFEST.in +4 -0
- atlassian_agent-0.1.6/PKG-INFO +162 -0
- atlassian_agent-0.1.6/README.md +140 -0
- atlassian_agent-0.1.6/atlassian_agent/__init__.py +68 -0
- atlassian_agent-0.1.6/atlassian_agent/__main__.py +6 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/A2A_AGENTS.md +8 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/AGENTS.md +12 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/CRON.md +12 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/CRON_LOG.md +5 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/HEARTBEAT.md +28 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/IDENTITY.md +61 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/MCP_AGENTS.md +13 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/MEMORY.md +8 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/USER.md +7 -0
- atlassian_agent-0.1.6/atlassian_agent/agent/icon.png +0 -0
- atlassian_agent-0.1.6/atlassian_agent/agent_data/A2A_AGENTS.md +8 -0
- atlassian_agent-0.1.6/atlassian_agent/agent_data/MCP_AGENTS.md +15 -0
- atlassian_agent-0.1.6/atlassian_agent/agent_data/main_agent.md +20 -0
- atlassian_agent-0.1.6/atlassian_agent/agent_data/mcp_config.json +15 -0
- atlassian_agent-0.1.6/atlassian_agent/agent_server.py +81 -0
- atlassian_agent-0.1.6/atlassian_agent/api/__init__.py +0 -0
- atlassian_agent-0.1.6/atlassian_agent/api/admin_cloud_api.py +1261 -0
- atlassian_agent-0.1.6/atlassian_agent/api/api_access_cloud_api.py +195 -0
- atlassian_agent-0.1.6/atlassian_agent/api/base.py +33 -0
- atlassian_agent-0.1.6/atlassian_agent/api/confluence_cloud_api.py +5163 -0
- atlassian_agent-0.1.6/atlassian_agent/api/confluence_server_api.py +3502 -0
- atlassian_agent-0.1.6/atlassian_agent/api/control_cloud_api.py +477 -0
- atlassian_agent-0.1.6/atlassian_agent/api/dlp_cloud_api.py +171 -0
- atlassian_agent-0.1.6/atlassian_agent/api/jira_cloud_api.py +13736 -0
- atlassian_agent-0.1.6/atlassian_agent/api/jira_server_api.py +9272 -0
- atlassian_agent-0.1.6/atlassian_agent/api/org_cloud_api.py +1261 -0
- atlassian_agent-0.1.6/atlassian_agent/api/user_mgmt_cloud_api.py +213 -0
- atlassian_agent-0.1.6/atlassian_agent/api/user_provisioning_cloud_api.py +541 -0
- atlassian_agent-0.1.6/atlassian_agent/auth.py +37 -0
- atlassian_agent-0.1.6/atlassian_agent/mcp_server.py +139 -0
- atlassian_agent-0.1.6/atlassian_agent/models.py +34 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/capture-tasks-from-meeting-notes/SKILL.md +679 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/capture-tasks-from-meeting-notes/references/action-item-patterns.md +445 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/generate-status-report/SKILL.md +335 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/generate-status-report/references/jql-patterns.md +82 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/generate-status-report/references/report-templates.md +120 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/generate-status-report/scripts/jql_builder.py +210 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/search-company-knowledge/SKILL.md +575 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/spec-to-backlog/SKILL.md +542 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/spec-to-backlog/references/breakdown-examples.md +327 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/spec-to-backlog/references/epic-templates.md +401 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/spec-to-backlog/references/ticket-writing-guide.md +354 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/triage-issue/SKILL.md +700 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/triage-issue/references/bug-report-templates.md +451 -0
- atlassian_agent-0.1.6/atlassian_agent/skills/triage-issue/references/search-patterns.md +261 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/__init__.py +0 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/admin_cloud_tools.py +1157 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/api_access_cloud_tools.py +186 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/confluence_cloud_tools.py +5781 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/confluence_server_tools.py +3156 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/control_cloud_tools.py +484 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/dlp_cloud_tools.py +166 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/jira_cloud_tools.py +18 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/jira_core_tools.py +334 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/jira_issue_tools.py +3904 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/jira_other_tools.py +2166 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/jira_project_tools.py +1738 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/jira_schema_tools.py +3310 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/jira_server_tools.py +7428 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/jira_user_tools.py +1276 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/org_cloud_tools.py +1045 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/user_mgmt_cloud_tools.py +191 -0
- atlassian_agent-0.1.6/atlassian_agent/tools/user_provisioning_cloud_tools.py +605 -0
- atlassian_agent-0.1.6/atlassian_agent.egg-info/PKG-INFO +162 -0
- atlassian_agent-0.1.6/atlassian_agent.egg-info/SOURCES.txt +77 -0
- atlassian_agent-0.1.6/atlassian_agent.egg-info/dependency_links.txt +1 -0
- atlassian_agent-0.1.6/atlassian_agent.egg-info/entry_points.txt +3 -0
- atlassian_agent-0.1.6/atlassian_agent.egg-info/requires.txt +8 -0
- atlassian_agent-0.1.6/atlassian_agent.egg-info/top_level.txt +3 -0
- atlassian_agent-0.1.6/pyproject.toml +43 -0
- atlassian_agent-0.1.6/requirements.txt +2 -0
- atlassian_agent-0.1.6/scripts/generate_atlassian_suite.py +373 -0
- atlassian_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,162 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: atlassian-agent
|
|
3
|
+
Version: 0.1.6
|
|
4
|
+
Summary: Comprehensive AI agent for Jira and Confluence management.
|
|
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
|
+
Requires-Dist: atlassian-python-api
|
|
17
|
+
Provides-Extra: agent
|
|
18
|
+
Requires-Dist: agent-utilities[agent,logfire]>=0.2.12; extra == "agent"
|
|
19
|
+
Provides-Extra: all
|
|
20
|
+
Requires-Dist: agent-utilities[agent,logfire,mcp]>=0.2.12; extra == "all"
|
|
21
|
+
Dynamic: license-file
|
|
22
|
+
|
|
23
|
+
# Atlassian Agent - A2A | AG-UI | MCP
|
|
24
|
+
|
|
25
|
+

|
|
26
|
+

|
|
27
|
+

|
|
28
|
+

|
|
29
|
+

|
|
30
|
+

|
|
31
|
+

|
|
32
|
+

|
|
33
|
+
|
|
34
|
+

|
|
35
|
+

|
|
36
|
+

|
|
37
|
+

|
|
38
|
+
|
|
39
|
+

|
|
40
|
+

|
|
41
|
+

|
|
42
|
+

|
|
43
|
+

|
|
44
|
+

|
|
45
|
+
|
|
46
|
+
*Version: 0.1.6*
|
|
47
|
+
|
|
48
|
+
## Overview
|
|
49
|
+
|
|
50
|
+
**Atlassian Agent MCP Server + A2A Agent**
|
|
51
|
+
|
|
52
|
+
Comprehensive AI agent for Jira and Confluence management.
|
|
53
|
+
|
|
54
|
+
This repository is actively maintained - Contributions are welcome!
|
|
55
|
+
|
|
56
|
+
## MCP
|
|
57
|
+
|
|
58
|
+
### Using as an MCP Server
|
|
59
|
+
|
|
60
|
+
The MCP Server can be run in two modes: `stdio` (for local testing) or `http` (for networked access).
|
|
61
|
+
|
|
62
|
+
#### Environment Variables
|
|
63
|
+
|
|
64
|
+
* `ATLASSIAN_AGENT_URL`: The URL of the target service.
|
|
65
|
+
* `ATLASSIAN_AGENT_TOKEN`: The API token or access token.
|
|
66
|
+
|
|
67
|
+
#### Run in stdio mode (default):
|
|
68
|
+
```bash
|
|
69
|
+
export ATLASSIAN_AGENT_URL="http://localhost:8080"
|
|
70
|
+
export ATLASSIAN_AGENT_TOKEN="your_token"
|
|
71
|
+
atlassian-mcp --transport "stdio"
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
#### Run in HTTP mode:
|
|
75
|
+
```bash
|
|
76
|
+
export ATLASSIAN_AGENT_URL="http://localhost:8080"
|
|
77
|
+
export ATLASSIAN_AGENT_TOKEN="your_token"
|
|
78
|
+
atlassian-mcp --transport "http" --host "0.0.0.0" --port "8000"
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## A2A Agent
|
|
82
|
+
|
|
83
|
+
### Run A2A Server
|
|
84
|
+
```bash
|
|
85
|
+
export ATLASSIAN_AGENT_URL="http://localhost:8080"
|
|
86
|
+
export ATLASSIAN_AGENT_TOKEN="your_token"
|
|
87
|
+
atlassian-agent --provider openai --model-id gpt-4o --api-key sk-...
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Docker
|
|
91
|
+
|
|
92
|
+
### Build
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
docker build -t atlassian-agent .
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### Run MCP Server
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
docker run -d \
|
|
102
|
+
--name atlassian-agent \
|
|
103
|
+
-p 8000:8000 \
|
|
104
|
+
-e TRANSPORT=http \
|
|
105
|
+
-e ATLASSIAN_AGENT_URL="http://your-service:8080" \
|
|
106
|
+
-e ATLASSIAN_AGENT_TOKEN="your_token" \
|
|
107
|
+
knucklessg1/atlassian-agent:latest
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### Deploy with Docker Compose
|
|
111
|
+
|
|
112
|
+
```yaml
|
|
113
|
+
services:
|
|
114
|
+
atlassian-agent:
|
|
115
|
+
image: knucklessg1/atlassian-agent:latest
|
|
116
|
+
environment:
|
|
117
|
+
- HOST=0.0.0.0
|
|
118
|
+
- PORT=8000
|
|
119
|
+
- TRANSPORT=http
|
|
120
|
+
- ATLASSIAN_AGENT_URL=http://your-service:8080
|
|
121
|
+
- ATLASSIAN_AGENT_TOKEN=your_token
|
|
122
|
+
ports:
|
|
123
|
+
- 8000:8000
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
#### Configure `mcp.json` for AI Integration (e.g. Claude Desktop)
|
|
127
|
+
|
|
128
|
+
```json
|
|
129
|
+
{
|
|
130
|
+
"mcpServers": {
|
|
131
|
+
"atlassian": {
|
|
132
|
+
"command": "uv",
|
|
133
|
+
"args": [
|
|
134
|
+
"run",
|
|
135
|
+
"--with",
|
|
136
|
+
"atlassian-agent",
|
|
137
|
+
"atlassian-mcp"
|
|
138
|
+
],
|
|
139
|
+
"env": {
|
|
140
|
+
"ATLASSIAN_AGENT_URL": "http://your-service:8080",
|
|
141
|
+
"ATLASSIAN_AGENT_TOKEN": "your_token"
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
## Install Python Package
|
|
149
|
+
|
|
150
|
+
```bash
|
|
151
|
+
python -m pip install atlassian-agent
|
|
152
|
+
```
|
|
153
|
+
```bash
|
|
154
|
+
uv pip install atlassian-agent
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
## Repository Owners
|
|
158
|
+
|
|
159
|
+
<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" />
|
|
160
|
+
|
|
161
|
+

|
|
162
|
+

|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
# Atlassian 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
|
+
**Atlassian Agent MCP Server + A2A Agent**
|
|
29
|
+
|
|
30
|
+
Comprehensive AI agent for Jira and Confluence management.
|
|
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
|
+
* `ATLASSIAN_AGENT_URL`: The URL of the target service.
|
|
43
|
+
* `ATLASSIAN_AGENT_TOKEN`: The API token or access token.
|
|
44
|
+
|
|
45
|
+
#### Run in stdio mode (default):
|
|
46
|
+
```bash
|
|
47
|
+
export ATLASSIAN_AGENT_URL="http://localhost:8080"
|
|
48
|
+
export ATLASSIAN_AGENT_TOKEN="your_token"
|
|
49
|
+
atlassian-mcp --transport "stdio"
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
#### Run in HTTP mode:
|
|
53
|
+
```bash
|
|
54
|
+
export ATLASSIAN_AGENT_URL="http://localhost:8080"
|
|
55
|
+
export ATLASSIAN_AGENT_TOKEN="your_token"
|
|
56
|
+
atlassian-mcp --transport "http" --host "0.0.0.0" --port "8000"
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## A2A Agent
|
|
60
|
+
|
|
61
|
+
### Run A2A Server
|
|
62
|
+
```bash
|
|
63
|
+
export ATLASSIAN_AGENT_URL="http://localhost:8080"
|
|
64
|
+
export ATLASSIAN_AGENT_TOKEN="your_token"
|
|
65
|
+
atlassian-agent --provider openai --model-id gpt-4o --api-key sk-...
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Docker
|
|
69
|
+
|
|
70
|
+
### Build
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
docker build -t atlassian-agent .
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### Run MCP Server
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
docker run -d \
|
|
80
|
+
--name atlassian-agent \
|
|
81
|
+
-p 8000:8000 \
|
|
82
|
+
-e TRANSPORT=http \
|
|
83
|
+
-e ATLASSIAN_AGENT_URL="http://your-service:8080" \
|
|
84
|
+
-e ATLASSIAN_AGENT_TOKEN="your_token" \
|
|
85
|
+
knucklessg1/atlassian-agent:latest
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Deploy with Docker Compose
|
|
89
|
+
|
|
90
|
+
```yaml
|
|
91
|
+
services:
|
|
92
|
+
atlassian-agent:
|
|
93
|
+
image: knucklessg1/atlassian-agent:latest
|
|
94
|
+
environment:
|
|
95
|
+
- HOST=0.0.0.0
|
|
96
|
+
- PORT=8000
|
|
97
|
+
- TRANSPORT=http
|
|
98
|
+
- ATLASSIAN_AGENT_URL=http://your-service:8080
|
|
99
|
+
- ATLASSIAN_AGENT_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
|
+
"atlassian": {
|
|
110
|
+
"command": "uv",
|
|
111
|
+
"args": [
|
|
112
|
+
"run",
|
|
113
|
+
"--with",
|
|
114
|
+
"atlassian-agent",
|
|
115
|
+
"atlassian-mcp"
|
|
116
|
+
],
|
|
117
|
+
"env": {
|
|
118
|
+
"ATLASSIAN_AGENT_URL": "http://your-service:8080",
|
|
119
|
+
"ATLASSIAN_AGENT_TOKEN": "your_token"
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## Install Python Package
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
python -m pip install atlassian-agent
|
|
130
|
+
```
|
|
131
|
+
```bash
|
|
132
|
+
uv pip install atlassian-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
|
+
"atlassian_agent.atlassian_api",
|
|
15
|
+
]
|
|
16
|
+
|
|
17
|
+
OPTIONAL_MODULES = {
|
|
18
|
+
"atlassian_agent.agent_server": "agent",
|
|
19
|
+
"atlassian_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("atlassian_agent.mcp_server") in [
|
|
57
|
+
m.__name__ for m in globals().values() if hasattr(m, "__name__")
|
|
58
|
+
]
|
|
59
|
+
_AGENT_AVAILABLE = "atlassian_agent.agent_server" in globals()
|
|
60
|
+
|
|
61
|
+
__all__.extend(["_MCP_AVAILABLE", "_AGENT_AVAILABLE"])
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
"""
|
|
65
|
+
atlassian-agent
|
|
66
|
+
|
|
67
|
+
Comprehensive AI agent for Jira and Confluence management.
|
|
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,61 @@
|
|
|
1
|
+
# IDENTITY.md - Atlassian Orchestrator Identity
|
|
2
|
+
|
|
3
|
+
## [supervisor]
|
|
4
|
+
* **Name:** Atlassian Master Orchestrator
|
|
5
|
+
* **Role:** High-level router and coordinator for all Atlassian ecosystem requests.
|
|
6
|
+
* **Emoji:** 🏗️
|
|
7
|
+
|
|
8
|
+
### System Prompt
|
|
9
|
+
You are the Atlassian Master Orchestrator. You maintain a grand vision of the user's Jira and Confluence landscape.
|
|
10
|
+
Your task is to delegate specialized requests to your domain-expert child agents:
|
|
11
|
+
- **Jira Core Specialist (`jira-core`)**: Standard issue management, projects, and fields.
|
|
12
|
+
- **Jira Advanced Specialist (`jira-advanced`)**: Agile (boards/sprints), linking, and worklogs.
|
|
13
|
+
- **Jira Special Ops Specialist (`jira-special`)**: JSM/Service Desk, Forms, Metrics, and Dev info.
|
|
14
|
+
- **Confluence Core Specialist (`confluence-core`)**: Page creation, searching, comments, and labels.
|
|
15
|
+
- **Confluence Advanced Specialist (`confluence-advanced`)**: Analytics and massive attachment management.
|
|
16
|
+
|
|
17
|
+
You must always begin by running `list_skills` to ensure all capabilities are online.
|
|
18
|
+
|
|
19
|
+
## [jira-core]
|
|
20
|
+
* **Name:** Jira Core Specialist
|
|
21
|
+
* **Role:** Expert in standard Jira issue lifecycles and project metadata.
|
|
22
|
+
* **Emoji:** 🎫
|
|
23
|
+
|
|
24
|
+
### System Prompt
|
|
25
|
+
You are the Jira Core Specialist. You excel at creating, searching, and status-transitioning individual issues.
|
|
26
|
+
Use JQL when complex searching is needed.
|
|
27
|
+
|
|
28
|
+
## [jira-advanced]
|
|
29
|
+
* **Name:** Jira Agile Specialist
|
|
30
|
+
* **Role:** Expert in Agile delivery, sprint mechanics, and cross-issue relationships.
|
|
31
|
+
* **Emoji:** 🚀
|
|
32
|
+
|
|
33
|
+
### System Prompt
|
|
34
|
+
You are the Jira Agile Specialist. You manage boards, plan sprints, and link issues (including Epics).
|
|
35
|
+
Your goal is to help projects move fast and maintain visibility across linked tasks.
|
|
36
|
+
|
|
37
|
+
## [jira-special]
|
|
38
|
+
* **Name:** Jira Special Ops
|
|
39
|
+
* **Role:** Expert in JSM Service Desk, Forms, and technical integration metrics.
|
|
40
|
+
* **Emoji:** 🕵️
|
|
41
|
+
|
|
42
|
+
### System Prompt
|
|
43
|
+
You are the Jira Special Ops Specialist. You handle the "extra" parts of Jira: Service Management, Forms, and dev-status metrics.
|
|
44
|
+
Help the user with complex service requests and ProForma forms.
|
|
45
|
+
|
|
46
|
+
## [confluence-core]
|
|
47
|
+
* **Name:** Confluence Knowledge Specialist
|
|
48
|
+
* **Role:** Expert in documentation structure, page content, and labeling.
|
|
49
|
+
* **Emoji:** 📖
|
|
50
|
+
|
|
51
|
+
### System Prompt
|
|
52
|
+
You are the Confluence Knowledge Specialist. You handle the creation and organization of the knowledge base.
|
|
53
|
+
Focus on clear hierarchy and accurate labeling.
|
|
54
|
+
|
|
55
|
+
## [confluence-advanced]
|
|
56
|
+
* **Name:** Confluence Asset Specialist
|
|
57
|
+
* **Role:** Expert in Confluence attachments, binary data, and page analytics.
|
|
58
|
+
* **Emoji:** 🧠
|
|
59
|
+
|
|
60
|
+
### System Prompt
|
|
61
|
+
You are the Confluence Asset Specialist. You help users manage their binary ecosystem (attachments) and understand the impact of their content through analytics.
|
|
@@ -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,15 @@
|
|
|
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
|
+
| Atlassian Specialist | Expert specialist for atlassian domain tasks. | You are a Atlassian specialist. Help users manage and interact with Atlassian functionality using the available tools. | atlassian_general_tools | atlassian | atlassian |
|
|
10
|
+
|
|
11
|
+
## Tool Inventory Table
|
|
12
|
+
|
|
13
|
+
| Tool Name | Description | Tag | Source |
|
|
14
|
+
|-----------|-------------|-----|--------|
|
|
15
|
+
| atlassian_general_tools | General tools for atlassian (offline extraction). | atlassian | atlassian |
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: main-agent
|
|
3
|
+
type: prompt
|
|
4
|
+
description: The primary orchestrator agent for this workspace.
|
|
5
|
+
capabilities:
|
|
6
|
+
- workspace-manager
|
|
7
|
+
- agent-workflows
|
|
8
|
+
---
|
|
9
|
+
# Main Agent
|
|
10
|
+
|
|
11
|
+
You are the primary orchestrator for this workspace. Your goal is to help the user manage their projects and coordinate specialized agents.
|
|
12
|
+
|
|
13
|
+
### Core Principles
|
|
14
|
+
* Be concise and efficient.
|
|
15
|
+
* Use the knowledge graph to discover tools and experts.
|
|
16
|
+
* Verify your work before concluding.
|
|
17
|
+
|
|
18
|
+
Your personality:
|
|
19
|
+
* **Emoji:** 🤖
|
|
20
|
+
* **Vibe:** Professional, efficient, helpful
|