plane-agent 2.3.9__tar.gz → 2.3.11__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.
- {plane_agent-2.3.9/plane_agent.egg-info → plane_agent-2.3.11}/PKG-INFO +3 -9
- {plane_agent-2.3.9 → plane_agent-2.3.11}/README.md +0 -2
- plane_agent-2.3.11/plane_agent/__init__.py +11 -0
- plane_agent-2.3.11/plane_agent/__main__.py +4 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/connector_sources.py +20 -78
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/kg_ingest.py +4 -3
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/mcp_server.py +1 -62
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/certification.json +6 -6
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/mappings/source.yaml +1 -1
- {plane_agent-2.3.9 → plane_agent-2.3.11/plane_agent.egg-info}/PKG-INFO +3 -9
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent.egg-info/SOURCES.txt +0 -8
- plane_agent-2.3.11/plane_agent.egg-info/entry_points.txt +8 -0
- plane_agent-2.3.11/plane_agent.egg-info/requires.txt +8 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent.egg-info/top_level.txt +0 -1
- {plane_agent-2.3.9 → plane_agent-2.3.11}/pyproject.toml +14 -17
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_coverage_gap_fillers.py +7 -54
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_cq_paths.py +2 -2
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_ingest_sources.py +4 -4
- plane_agent-2.3.11/tests/test_init.py +15 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_kg_ingest.py +9 -0
- plane_agent-2.3.9/MANIFEST.in +0 -1
- plane_agent-2.3.9/plane_agent/__init__.py +0 -1
- plane_agent-2.3.9/plane_agent/__main__.py +0 -4
- plane_agent-2.3.9/plane_agent/connectors/__init__.py +0 -0
- plane_agent-2.3.9/plane_agent/prompts/__init__.py +0 -0
- plane_agent-2.3.9/plane_agent/skills/__init__.py +0 -0
- plane_agent-2.3.9/plane_agent.egg-info/entry_points.txt +0 -17
- plane_agent-2.3.9/plane_agent.egg-info/requires.txt +0 -14
- plane_agent-2.3.9/requirements.txt +0 -1
- plane_agent-2.3.9/scripts/security_sanitizer.py +0 -318
- plane_agent-2.3.9/scripts/verify_api_integration.py +0 -279
- plane_agent-2.3.9/tests/test_default_content_surfaces.py +0 -43
- plane_agent-2.3.9/tests/test_init.py +0 -26
- {plane_agent-2.3.9 → plane_agent-2.3.11}/LICENSE +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/__init__.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_base.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_cycles.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_epics.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_initiatives.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_intake.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_milestones.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_modules_states.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_projects.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_work_items.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api/api_client_workspace.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/api_client.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/auth.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/mcp_config.json +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/__init__.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/fixtures/records.json +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/migrations/manifest.json +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/plane.ttl +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/ontology/shapes/connector.shacl.ttl +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/plane_models.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/prompts/project_tracking_specialist.json +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-agent-operations/SKILL.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-agent-operations/agents/openai.yaml +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-agent-operations/references/catalog.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-create-work-item-guided/SKILL.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-create-work-item-guided/WORKFLOW.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-create-work-item-guided/references/property-discovery.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-cycle-planning/SKILL.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-cycle-planning/WORKFLOW.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-kg-ingestion/SKILL.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-kg-ingestion/WORKFLOW.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-my-priority-queue/SKILL.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-my-priority-queue/WORKFLOW.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-my-priority-queue/references/filter-recipes.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-my-priority-queue/scripts/rank_items.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-work-item-tracking/SKILL.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent/skills/plane-work-item-tracking/WORKFLOW.md +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/plane_agent.egg-info/dependency_links.txt +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/setup.cfg +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/conftest.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_action_discovery.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_init_dynamics.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_ontology_parent_link.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_rank_items.py +0 -0
- {plane_agent-2.3.9 → plane_agent-2.3.11}/tests/test_startup.py +0 -0
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: plane-agent
|
|
3
|
-
Version: 2.3.
|
|
3
|
+
Version: 2.3.11
|
|
4
4
|
Summary: Plane MCP Agent
|
|
5
|
-
Author-email:
|
|
5
|
+
Author-email: Repository Maintainers <maintainers@knuckles.team>
|
|
6
6
|
License: MIT
|
|
7
7
|
Classifier: Development Status :: 4 - Beta
|
|
8
8
|
Classifier: License :: OSI Approved :: MIT License
|
|
@@ -12,12 +12,8 @@ Classifier: Programming Language :: Python :: 3
|
|
|
12
12
|
Requires-Python: <3.15,>=3.12
|
|
13
13
|
Description-Content-Type: text/markdown
|
|
14
14
|
License-File: LICENSE
|
|
15
|
-
Requires-Dist: agent-connector-sdk[mcp]<
|
|
15
|
+
Requires-Dist: agent-connector-sdk[mcp]<0.6.0,>=0.5.2
|
|
16
16
|
Requires-Dist: requests>=2.34.2
|
|
17
|
-
Provides-Extra: mcp
|
|
18
|
-
Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "mcp"
|
|
19
|
-
Provides-Extra: all
|
|
20
|
-
Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "all"
|
|
21
17
|
Provides-Extra: test
|
|
22
18
|
Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
|
|
23
19
|
Requires-Dist: pytest>=9.1.1; extra == "test"
|
|
@@ -47,8 +43,6 @@ Dynamic: license-file
|
|
|
47
43
|

|
|
48
44
|

|
|
49
45
|
|
|
50
|
-
*Version: 2.3.9*
|
|
51
|
-
|
|
52
46
|
> **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
|
|
53
47
|
> interfaces, and guidance for provisioning a self-hosted Plane instance are
|
|
54
48
|
> maintained in the [official documentation](https://knuckles-team.github.io/plane-agent/).
|
|
@@ -20,8 +20,6 @@
|
|
|
20
20
|

|
|
21
21
|

|
|
22
22
|
|
|
23
|
-
*Version: 2.3.9*
|
|
24
|
-
|
|
25
23
|
> **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
|
|
26
24
|
> interfaces, and guidance for provisioning a self-hosted Plane instance are
|
|
27
25
|
> maintained in the [official documentation](https://knuckles-team.github.io/plane-agent/).
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
from agent_connector_sdk.connector import Connector
|
|
2
|
+
|
|
3
|
+
from plane_agent.api_client import Api
|
|
4
|
+
from plane_agent.auth import get_client
|
|
5
|
+
|
|
6
|
+
connector = Connector(
|
|
7
|
+
api=Api,
|
|
8
|
+
get_client=get_client,
|
|
9
|
+
tools="plane_agent.mcp_server",
|
|
10
|
+
instructions="plane-agent MCP Server — Condensed Action-Routed Tools.",
|
|
11
|
+
)
|
|
@@ -7,9 +7,6 @@ Served live as ``connector://resources``. Regenerate by editing the declarations
|
|
|
7
7
|
from __future__ import annotations
|
|
8
8
|
|
|
9
9
|
from agent_connector_sdk.ingest.live_declaration import source_meta
|
|
10
|
-
from agent_connector_sdk.ingest.sources import IngestSourceDeclaration, IngestSourceSpec
|
|
11
|
-
|
|
12
|
-
CONNECTOR = "plane-mcp"
|
|
13
10
|
|
|
14
11
|
SOURCES = (
|
|
15
12
|
source_meta(
|
|
@@ -63,82 +60,46 @@ SOURCES = (
|
|
|
63
60
|
),
|
|
64
61
|
)
|
|
65
62
|
|
|
63
|
+
SCHEMA_VERSION = 2
|
|
64
|
+
|
|
65
|
+
FIELD_SETS = {
|
|
66
|
+
"fields_1": {
|
|
67
|
+
"endDate": "xsd:string",
|
|
68
|
+
"identifier": "xsd:string",
|
|
69
|
+
"priority": "xsd:string",
|
|
70
|
+
"sequenceId": "xsd:integer",
|
|
71
|
+
"startDate": "xsd:string",
|
|
72
|
+
"state": "xsd:string",
|
|
73
|
+
},
|
|
74
|
+
}
|
|
75
|
+
|
|
66
76
|
SCHEMA_MAPPINGS = {
|
|
67
77
|
"Cycle": {
|
|
68
|
-
"
|
|
69
|
-
"endDate": "xsd:string",
|
|
70
|
-
"identifier": "xsd:string",
|
|
71
|
-
"priority": "xsd:string",
|
|
72
|
-
"sequenceId": "xsd:integer",
|
|
73
|
-
"startDate": "xsd:string",
|
|
74
|
-
"state": "xsd:string",
|
|
75
|
-
},
|
|
78
|
+
"field_sets": ["fields_1"],
|
|
76
79
|
"ontology_class": "Iteration",
|
|
77
80
|
},
|
|
78
81
|
"Issue": {
|
|
79
|
-
"
|
|
80
|
-
"endDate": "xsd:string",
|
|
81
|
-
"identifier": "xsd:string",
|
|
82
|
-
"priority": "xsd:string",
|
|
83
|
-
"sequenceId": "xsd:integer",
|
|
84
|
-
"startDate": "xsd:string",
|
|
85
|
-
"state": "xsd:string",
|
|
86
|
-
},
|
|
82
|
+
"field_sets": ["fields_1"],
|
|
87
83
|
"ontology_class": "WorkItem",
|
|
88
84
|
},
|
|
89
85
|
"Label": {
|
|
90
|
-
"
|
|
91
|
-
"endDate": "xsd:string",
|
|
92
|
-
"identifier": "xsd:string",
|
|
93
|
-
"priority": "xsd:string",
|
|
94
|
-
"sequenceId": "xsd:integer",
|
|
95
|
-
"startDate": "xsd:string",
|
|
96
|
-
"state": "xsd:string",
|
|
97
|
-
},
|
|
86
|
+
"field_sets": ["fields_1"],
|
|
98
87
|
"ontology_class": "Tag",
|
|
99
88
|
},
|
|
100
89
|
"PlaneModule": {
|
|
101
|
-
"
|
|
102
|
-
"endDate": "xsd:string",
|
|
103
|
-
"identifier": "xsd:string",
|
|
104
|
-
"priority": "xsd:string",
|
|
105
|
-
"sequenceId": "xsd:integer",
|
|
106
|
-
"startDate": "xsd:string",
|
|
107
|
-
"state": "xsd:string",
|
|
108
|
-
},
|
|
90
|
+
"field_sets": ["fields_1"],
|
|
109
91
|
"ontology_class": "Collection",
|
|
110
92
|
},
|
|
111
93
|
"ProjectState": {
|
|
112
|
-
"
|
|
113
|
-
"endDate": "xsd:string",
|
|
114
|
-
"identifier": "xsd:string",
|
|
115
|
-
"priority": "xsd:string",
|
|
116
|
-
"sequenceId": "xsd:integer",
|
|
117
|
-
"startDate": "xsd:string",
|
|
118
|
-
"state": "xsd:string",
|
|
119
|
-
},
|
|
94
|
+
"field_sets": ["fields_1"],
|
|
120
95
|
"ontology_class": "Concept",
|
|
121
96
|
},
|
|
122
97
|
"SoftwareProject": {
|
|
123
|
-
"
|
|
124
|
-
"endDate": "xsd:string",
|
|
125
|
-
"identifier": "xsd:string",
|
|
126
|
-
"priority": "xsd:string",
|
|
127
|
-
"sequenceId": "xsd:integer",
|
|
128
|
-
"startDate": "xsd:string",
|
|
129
|
-
"state": "xsd:string",
|
|
130
|
-
},
|
|
98
|
+
"field_sets": ["fields_1"],
|
|
131
99
|
"ontology_class": "SoftwareProject",
|
|
132
100
|
},
|
|
133
101
|
"Workspace": {
|
|
134
|
-
"
|
|
135
|
-
"endDate": "xsd:string",
|
|
136
|
-
"identifier": "xsd:string",
|
|
137
|
-
"priority": "xsd:string",
|
|
138
|
-
"sequenceId": "xsd:integer",
|
|
139
|
-
"startDate": "xsd:string",
|
|
140
|
-
"state": "xsd:string",
|
|
141
|
-
},
|
|
102
|
+
"field_sets": ["fields_1"],
|
|
142
103
|
"ontology_class": "Namespace",
|
|
143
104
|
},
|
|
144
105
|
}
|
|
@@ -180,22 +141,3 @@ RESOURCES = (
|
|
|
180
141
|
"name": "Workspace",
|
|
181
142
|
},
|
|
182
143
|
)
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
def declaration() -> IngestSourceDeclaration:
|
|
186
|
-
"""The declaration the server assembles from this module."""
|
|
187
|
-
specs = []
|
|
188
|
-
for item in SOURCES:
|
|
189
|
-
for entry in item["connector_sources"]:
|
|
190
|
-
body = {k: v for k, v in entry.items() if k not in ("tool", "mapping")}
|
|
191
|
-
specs.append(
|
|
192
|
-
IngestSourceSpec.model_validate({**body, "tools": (entry["tool"],)})
|
|
193
|
-
)
|
|
194
|
-
return IngestSourceDeclaration.model_validate(
|
|
195
|
-
{
|
|
196
|
-
"connector": CONNECTOR,
|
|
197
|
-
"sources": specs,
|
|
198
|
-
"schema_mappings": SCHEMA_MAPPINGS,
|
|
199
|
-
"resources": RESOURCES,
|
|
200
|
-
}
|
|
201
|
-
)
|
|
@@ -11,6 +11,7 @@ from __future__ import annotations
|
|
|
11
11
|
import logging
|
|
12
12
|
from typing import Any
|
|
13
13
|
|
|
14
|
+
from agent_connector_sdk.connector_identity import connector_name
|
|
14
15
|
from agent_connector_sdk.ingest import (
|
|
15
16
|
ChangeSet,
|
|
16
17
|
Entity,
|
|
@@ -23,15 +24,15 @@ from agent_connector_sdk.ingest import (
|
|
|
23
24
|
|
|
24
25
|
logger = logging.getLogger("plane_agent.kg")
|
|
25
26
|
|
|
26
|
-
_SOURCE = "
|
|
27
|
+
_SOURCE = connector_name("plane_agent")
|
|
27
28
|
_DOMAIN = "plane"
|
|
28
29
|
_BINDING = IngestBinding(connector=_SOURCE, stream=_DOMAIN)
|
|
29
30
|
|
|
30
31
|
|
|
31
32
|
def _to_entity(record: dict[str, Any]) -> Entity:
|
|
32
33
|
return Entity(
|
|
33
|
-
id=record.get("id"),
|
|
34
|
-
node_type=record.get("node_type"),
|
|
34
|
+
id=record.get("id") or "",
|
|
35
|
+
node_type=record.get("node_type") or "",
|
|
35
36
|
properties={k: v for k, v in record.items() if k not in ("id", "node_type")},
|
|
36
37
|
)
|
|
37
38
|
|
|
@@ -20,22 +20,14 @@ warnings.filterwarnings("ignore", message=".*urllib3.*or chardet.*")
|
|
|
20
20
|
warnings.filterwarnings("ignore", message=".*urllib3.*or charset_normalizer.*")
|
|
21
21
|
|
|
22
22
|
import logging
|
|
23
|
-
import sys
|
|
24
23
|
from typing import Any
|
|
25
24
|
|
|
26
|
-
from agent_connector_sdk.config import
|
|
25
|
+
from agent_connector_sdk.config import setting
|
|
27
26
|
from agent_connector_sdk.mcp.action_dispatch import resolve_action
|
|
28
27
|
from agent_connector_sdk.mcp.concurrency import run_blocking
|
|
29
|
-
from agent_connector_sdk.mcp.server import create_mcp_server
|
|
30
|
-
from agent_connector_sdk.mcp.tool_surface import register_tool_surface
|
|
31
|
-
from starlette.requests import Request
|
|
32
|
-
from starlette.responses import JSONResponse
|
|
33
28
|
|
|
34
|
-
from plane_agent.api_client import Api
|
|
35
29
|
from plane_agent.auth import get_client
|
|
36
30
|
|
|
37
|
-
__version__ = "0.1.37"
|
|
38
|
-
|
|
39
31
|
logger = get_logger(name="plane-agent")
|
|
40
32
|
logger.setLevel(logging.INFO)
|
|
41
33
|
|
|
@@ -800,56 +792,3 @@ def register_kg_tools(mcp: FastMCP):
|
|
|
800
792
|
return {"listed": len(records), "ingested": ingested}
|
|
801
793
|
|
|
802
794
|
return None
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
def get_mcp_instance() -> tuple[Any, ...]:
|
|
806
|
-
"""Initialize and return the MCP instance.
|
|
807
|
-
|
|
808
|
-
Ecosystem Concepts:
|
|
809
|
-
(MCP & Universal Skills)
|
|
810
|
-
(Guardrail Engine)
|
|
811
|
-
"""
|
|
812
|
-
load_config()
|
|
813
|
-
args, mcp, middlewares = create_mcp_server(
|
|
814
|
-
name="plane-agent MCP",
|
|
815
|
-
version=__version__,
|
|
816
|
-
instructions="plane-agent MCP Server — Condensed Action-Routed Tools.",
|
|
817
|
-
)
|
|
818
|
-
|
|
819
|
-
@mcp.custom_route("/health", methods=["GET"])
|
|
820
|
-
async def health_check(request: Request) -> JSONResponse:
|
|
821
|
-
return JSONResponse({"status": "OK"})
|
|
822
|
-
|
|
823
|
-
register_tool_surface(
|
|
824
|
-
mcp,
|
|
825
|
-
client_cls=Api,
|
|
826
|
-
get_client=get_client,
|
|
827
|
-
service="plane-agent",
|
|
828
|
-
tools_module=sys.modules[__name__],
|
|
829
|
-
)
|
|
830
|
-
|
|
831
|
-
for mw in middlewares:
|
|
832
|
-
mcp.add_middleware(mw)
|
|
833
|
-
return mcp, args, middlewares
|
|
834
|
-
|
|
835
|
-
|
|
836
|
-
def mcp_server() -> None:
|
|
837
|
-
mcp, args, middlewares = get_mcp_instance()
|
|
838
|
-
print(f"plane-agent MCP v{__version__}", file=sys.stderr)
|
|
839
|
-
print("\nStarting MCP Server", file=sys.stderr)
|
|
840
|
-
print(f" Transport: {args.transport.upper()}", file=sys.stderr)
|
|
841
|
-
print(f" Auth: {args.auth_type}", file=sys.stderr)
|
|
842
|
-
|
|
843
|
-
if args.transport == "stdio":
|
|
844
|
-
mcp.run(transport="stdio")
|
|
845
|
-
elif args.transport == "streamable-http":
|
|
846
|
-
mcp.run(transport="streamable-http", host=args.host, port=args.port)
|
|
847
|
-
elif args.transport == "sse":
|
|
848
|
-
mcp.run(transport="sse", host=args.host, port=args.port)
|
|
849
|
-
else:
|
|
850
|
-
logger.error("Invalid transport", extra={"transport": args.transport})
|
|
851
|
-
sys.exit(1)
|
|
852
|
-
|
|
853
|
-
|
|
854
|
-
if __name__ == "__main__":
|
|
855
|
-
mcp_server()
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
|
-
"api_version": "
|
|
2
|
+
"api_version": "graphos.io/v1",
|
|
3
3
|
"artifacts": {
|
|
4
4
|
"plane_agent/ontology/fixtures/records.json": "ad212a2725e246aceb1d2ecdf95db690f31b231888f6789f0c8867f0b70ab6e4",
|
|
5
|
-
"plane_agent/ontology/mappings/source.yaml": "
|
|
5
|
+
"plane_agent/ontology/mappings/source.yaml": "dc24762ec60986e3ff2bc0ec29ce585343abebaf9c9548a7d7659c66cef04151",
|
|
6
6
|
"plane_agent/ontology/migrations/manifest.json": "61b3a180e8fbc6862e59844dffe069ee13c592a4e635b259f6a39b174d30e5aa",
|
|
7
|
-
"plane_agent/ontology/plane.ttl": "
|
|
8
|
-
"plane_agent/ontology/shapes/connector.shacl.ttl": "
|
|
7
|
+
"plane_agent/ontology/plane.ttl": "35829508da04668ba127a880526d808fa6d4be676660bb77df1f7f1acb3f48b4",
|
|
8
|
+
"plane_agent/ontology/shapes/connector.shacl.ttl": "d94b9d57b38df1bacd019d8dd0449419d58e045b7f791de2788a8031bf7a35e8"
|
|
9
9
|
},
|
|
10
10
|
"checks": {
|
|
11
11
|
"declared_tool_schema": "passed",
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
"synthetic_fixture_contract": "passed"
|
|
16
16
|
},
|
|
17
17
|
"compatibility": {
|
|
18
|
-
"
|
|
18
|
+
"agent_utilities": ">=2.5.0,<3",
|
|
19
19
|
"bundle_schema": "2",
|
|
20
20
|
"epistemic_graph": ">=2.27.0,<3"
|
|
21
21
|
},
|
|
@@ -29,5 +29,5 @@
|
|
|
29
29
|
"signer": "UNSIGNED-PREVIEW",
|
|
30
30
|
"signing_public_key": "",
|
|
31
31
|
"status": "source-validated",
|
|
32
|
-
"validated_at": "2026-
|
|
32
|
+
"validated_at": "2026-10-24T06:19:45Z"
|
|
33
33
|
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: plane-agent
|
|
3
|
-
Version: 2.3.
|
|
3
|
+
Version: 2.3.11
|
|
4
4
|
Summary: Plane MCP Agent
|
|
5
|
-
Author-email:
|
|
5
|
+
Author-email: Repository Maintainers <maintainers@knuckles.team>
|
|
6
6
|
License: MIT
|
|
7
7
|
Classifier: Development Status :: 4 - Beta
|
|
8
8
|
Classifier: License :: OSI Approved :: MIT License
|
|
@@ -12,12 +12,8 @@ Classifier: Programming Language :: Python :: 3
|
|
|
12
12
|
Requires-Python: <3.15,>=3.12
|
|
13
13
|
Description-Content-Type: text/markdown
|
|
14
14
|
License-File: LICENSE
|
|
15
|
-
Requires-Dist: agent-connector-sdk[mcp]<
|
|
15
|
+
Requires-Dist: agent-connector-sdk[mcp]<0.6.0,>=0.5.2
|
|
16
16
|
Requires-Dist: requests>=2.34.2
|
|
17
|
-
Provides-Extra: mcp
|
|
18
|
-
Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "mcp"
|
|
19
|
-
Provides-Extra: all
|
|
20
|
-
Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "all"
|
|
21
17
|
Provides-Extra: test
|
|
22
18
|
Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
|
|
23
19
|
Requires-Dist: pytest>=9.1.1; extra == "test"
|
|
@@ -47,8 +43,6 @@ Dynamic: license-file
|
|
|
47
43
|

|
|
48
44
|

|
|
49
45
|
|
|
50
|
-
*Version: 2.3.9*
|
|
51
|
-
|
|
52
46
|
> **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
|
|
53
47
|
> interfaces, and guidance for provisioning a self-hosted Plane instance are
|
|
54
48
|
> maintained in the [official documentation](https://knuckles-team.github.io/plane-agent/).
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
LICENSE
|
|
2
|
-
MANIFEST.in
|
|
3
2
|
README.md
|
|
4
3
|
pyproject.toml
|
|
5
|
-
requirements.txt
|
|
6
4
|
plane_agent/__init__.py
|
|
7
5
|
plane_agent/__main__.py
|
|
8
6
|
plane_agent/api_client.py
|
|
@@ -29,7 +27,6 @@ plane_agent/api/api_client_modules_states.py
|
|
|
29
27
|
plane_agent/api/api_client_projects.py
|
|
30
28
|
plane_agent/api/api_client_work_items.py
|
|
31
29
|
plane_agent/api/api_client_workspace.py
|
|
32
|
-
plane_agent/connectors/__init__.py
|
|
33
30
|
plane_agent/ontology/__init__.py
|
|
34
31
|
plane_agent/ontology/certification.json
|
|
35
32
|
plane_agent/ontology/plane.ttl
|
|
@@ -37,9 +34,7 @@ plane_agent/ontology/fixtures/records.json
|
|
|
37
34
|
plane_agent/ontology/mappings/source.yaml
|
|
38
35
|
plane_agent/ontology/migrations/manifest.json
|
|
39
36
|
plane_agent/ontology/shapes/connector.shacl.ttl
|
|
40
|
-
plane_agent/prompts/__init__.py
|
|
41
37
|
plane_agent/prompts/project_tracking_specialist.json
|
|
42
|
-
plane_agent/skills/__init__.py
|
|
43
38
|
plane_agent/skills/plane-agent-operations/SKILL.md
|
|
44
39
|
plane_agent/skills/plane-agent-operations/agents/openai.yaml
|
|
45
40
|
plane_agent/skills/plane-agent-operations/references/catalog.md
|
|
@@ -56,13 +51,10 @@ plane_agent/skills/plane-my-priority-queue/references/filter-recipes.md
|
|
|
56
51
|
plane_agent/skills/plane-my-priority-queue/scripts/rank_items.py
|
|
57
52
|
plane_agent/skills/plane-work-item-tracking/SKILL.md
|
|
58
53
|
plane_agent/skills/plane-work-item-tracking/WORKFLOW.md
|
|
59
|
-
scripts/security_sanitizer.py
|
|
60
|
-
scripts/verify_api_integration.py
|
|
61
54
|
tests/conftest.py
|
|
62
55
|
tests/test_action_discovery.py
|
|
63
56
|
tests/test_coverage_gap_fillers.py
|
|
64
57
|
tests/test_cq_paths.py
|
|
65
|
-
tests/test_default_content_surfaces.py
|
|
66
58
|
tests/test_ingest_sources.py
|
|
67
59
|
tests/test_init.py
|
|
68
60
|
tests/test_init_dynamics.py
|
|
@@ -4,43 +4,32 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "plane-agent"
|
|
7
|
-
version = "2.3.
|
|
7
|
+
version = "2.3.11"
|
|
8
8
|
description = "Plane MCP Agent"
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
classifiers = [ "Development Status :: 4 - Beta", "License :: OSI Approved :: MIT License", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
|
|
11
11
|
requires-python = ">=3.12, <3.15"
|
|
12
|
-
dependencies = [ "agent-connector-sdk[mcp]>=0.
|
|
12
|
+
dependencies = [ "agent-connector-sdk[mcp]>=0.5.2,<0.6.0", "requests>=2.34.2",]
|
|
13
13
|
[[project.authors]]
|
|
14
|
-
name = "
|
|
15
|
-
email = "maintainers@
|
|
14
|
+
name = "Repository Maintainers"
|
|
15
|
+
email = "maintainers@knuckles.team"
|
|
16
16
|
|
|
17
17
|
[project.license]
|
|
18
18
|
text = "MIT"
|
|
19
19
|
|
|
20
20
|
[project.scripts]
|
|
21
|
-
plane-mcp = "
|
|
21
|
+
plane-mcp = "agent_connector_sdk.cli:serve"
|
|
22
22
|
|
|
23
23
|
[project.optional-dependencies]
|
|
24
|
-
mcp = [ "agent-connector-sdk[mcp]>=0.4.3,<1.0.0",]
|
|
25
|
-
all = [ "agent-connector-sdk[mcp]>=0.4.3,<1.0.0",]
|
|
26
24
|
test = [
|
|
27
25
|
"pytest-xdist>=3.8.0", "pytest>=9.1.1", "pytest-asyncio>=1.4.0", "pytest-cov>=7.1.0",]
|
|
28
26
|
|
|
29
|
-
[project.entry-points."agent_connector_sdk.skill_providers"]
|
|
30
|
-
plane-agent = "plane_agent.skills"
|
|
31
|
-
|
|
32
|
-
[project.entry-points."agent_connector_sdk.ontology_providers"]
|
|
33
|
-
plane-agent = "plane_agent.ontology"
|
|
34
|
-
|
|
35
|
-
[project.entry-points."agent_connector_sdk.source_connector_providers"]
|
|
36
|
-
plane-agent = "plane_agent.connectors"
|
|
37
|
-
|
|
38
27
|
[project.entry-points."agent_connector_sdk.prompt_providers"]
|
|
39
28
|
plane-agent = "plane_agent.prompts"
|
|
40
29
|
|
|
41
30
|
# The one declared connector identity: the fleet name (SDK-CONNECTOR-CONTROL-R071).
|
|
42
31
|
[project.entry-points."agent_connector_sdk.connector"]
|
|
43
|
-
plane-mcp = "plane_agent"
|
|
32
|
+
plane-mcp = "plane_agent:connector"
|
|
44
33
|
|
|
45
34
|
[tool.uv.workspace]
|
|
46
35
|
members = ["."]
|
|
@@ -55,6 +44,7 @@ override-dependencies = [
|
|
|
55
44
|
|
|
56
45
|
|
|
57
46
|
[tool.ruff]
|
|
47
|
+
extend-exclude = ["tests", "scripts"]
|
|
58
48
|
line-length = 88
|
|
59
49
|
target-version = "py312"
|
|
60
50
|
|
|
@@ -83,3 +73,10 @@ ignore_names = ["request", "config"]
|
|
|
83
73
|
|
|
84
74
|
[tool.pipelines_hooks.ste]
|
|
85
75
|
exempt = ["specs/*", "specs/**/*"]
|
|
76
|
+
|
|
77
|
+
[tool.pipelines.container]
|
|
78
|
+
debug_apt = ["default-jre", "ripgrep", "tree", "fd-find", "curl", "nano", "build-essential", "cmake", "libssl-dev", "libcurl4-openssl-dev", "pkg-config", "cargo", "rustc"]
|
|
79
|
+
limits = {"mcp" = {"memory_limit_env" = "AGENT_CONTAINER_MEMORY_LIMIT", "memory_limit" = "4g", "cpu_limit_env" = "AGENT_CONTAINER_CPU_LIMIT", "cpu_limit" = "2.0"}}
|
|
80
|
+
|
|
81
|
+
[tool.pipelines.api_integration]
|
|
82
|
+
baseline = 54.9
|
|
@@ -11,7 +11,7 @@ sys.argv = ["mcp_server.py"]
|
|
|
11
11
|
import asyncio
|
|
12
12
|
import inspect
|
|
13
13
|
from typing import Any
|
|
14
|
-
from unittest.mock import
|
|
14
|
+
from unittest.mock import patch
|
|
15
15
|
|
|
16
16
|
import pytest
|
|
17
17
|
from agent_connector_sdk.exceptions import AuthError
|
|
@@ -101,9 +101,9 @@ def get_all_mcp_tool_names():
|
|
|
101
101
|
"""Every tool the MCP server registers (one per API operation)."""
|
|
102
102
|
import asyncio
|
|
103
103
|
|
|
104
|
-
from
|
|
104
|
+
from agent_connector_sdk.connector import build_server
|
|
105
105
|
|
|
106
|
-
|
|
106
|
+
_, mcp = build_server("plane_agent", command_args=[])
|
|
107
107
|
return sorted(tool.name for tool in asyncio.run(mcp.list_tools()))
|
|
108
108
|
|
|
109
109
|
|
|
@@ -114,9 +114,9 @@ async def test_all_mcp_tools(tool_name):
|
|
|
114
114
|
|
|
115
115
|
CONCEPT:AU-ECO.mcp.fastmcp-middleware
|
|
116
116
|
"""
|
|
117
|
-
from
|
|
117
|
+
from agent_connector_sdk.connector import build_server
|
|
118
118
|
|
|
119
|
-
|
|
119
|
+
_, mcp = build_server("plane_agent", command_args=[])
|
|
120
120
|
tool = next(t for t in await mcp.list_tools() if t.name == tool_name)
|
|
121
121
|
properties = tool.parameters.get("properties", {})
|
|
122
122
|
assert "action" not in properties
|
|
@@ -125,53 +125,6 @@ async def test_all_mcp_tools(tool_name):
|
|
|
125
125
|
assert tool.annotations.read_only_hint is not None
|
|
126
126
|
|
|
127
127
|
|
|
128
|
-
@pytest.mark.concept("AU-ECO.mcp.fastmcp-middleware")
|
|
129
|
-
def test_mcp_server_run_options():
|
|
130
|
-
"""Test MCP server run options.
|
|
131
|
-
|
|
132
|
-
CONCEPT:AU-ECO.mcp.fastmcp-middleware
|
|
133
|
-
"""
|
|
134
|
-
from plane_agent.mcp_server import mcp_server
|
|
135
|
-
|
|
136
|
-
mock_mcp = MagicMock()
|
|
137
|
-
mock_args = MagicMock()
|
|
138
|
-
|
|
139
|
-
with patch(
|
|
140
|
-
"plane_agent.mcp_server.get_mcp_instance",
|
|
141
|
-
return_value=(mock_mcp, mock_args, []),
|
|
142
|
-
):
|
|
143
|
-
# Stdio Transport
|
|
144
|
-
mock_args.transport = "stdio"
|
|
145
|
-
mcp_server()
|
|
146
|
-
mock_mcp.run.assert_called_with(transport="stdio")
|
|
147
|
-
|
|
148
|
-
# SSE Transport
|
|
149
|
-
mock_args.transport = "sse"
|
|
150
|
-
mock_args.host = "127.0.0.1"
|
|
151
|
-
mock_args.port = 8000
|
|
152
|
-
mcp_server()
|
|
153
|
-
mock_mcp.run.assert_called_with(transport="sse", host="127.0.0.1", port=8000)
|
|
154
|
-
|
|
155
|
-
# Streamable HTTP Transport
|
|
156
|
-
mock_args.transport = "streamable-http"
|
|
157
|
-
mock_args.host = "127.0.0.1"
|
|
158
|
-
mock_args.port = 8000
|
|
159
|
-
mcp_server()
|
|
160
|
-
mock_mcp.run.assert_called_with(
|
|
161
|
-
transport="streamable-http", host="127.0.0.1", port=8000
|
|
162
|
-
)
|
|
163
|
-
|
|
164
|
-
# Invalid Transport
|
|
165
|
-
mock_args.transport = "invalid"
|
|
166
|
-
with patch("sys.exit") as mock_exit:
|
|
167
|
-
mcp_server()
|
|
168
|
-
mock_exit.assert_called_with(1)
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
128
|
@pytest.mark.concept("AU-ECO.mcp.fastmcp-middleware")
|
|
176
129
|
def test_requests_dependency_warning_fallback():
|
|
177
130
|
"""Test requests dependency warning fallback path.
|
|
@@ -206,9 +159,9 @@ def test_sse_healthcheck():
|
|
|
206
159
|
"""
|
|
207
160
|
|
|
208
161
|
async def run_test():
|
|
209
|
-
from
|
|
162
|
+
from agent_connector_sdk.connector import build_server
|
|
210
163
|
|
|
211
|
-
|
|
164
|
+
_, mcp = build_server("plane_agent", command_args=[])
|
|
212
165
|
|
|
213
166
|
# Introspect Starlette routes
|
|
214
167
|
routes = []
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
from __future__ import annotations
|
|
4
4
|
|
|
5
|
-
from
|
|
5
|
+
from agent_connector_sdk.ingest import load_declaration
|
|
6
6
|
import re
|
|
7
7
|
from pathlib import Path
|
|
8
8
|
|
|
@@ -44,7 +44,7 @@ def test_classes_extend_a_shared_parent(name: str, parent: str) -> None:
|
|
|
44
44
|
def test_no_mapping_has_a_null_ontology_class() -> None:
|
|
45
45
|
unmapped = [
|
|
46
46
|
name
|
|
47
|
-
for name, mapping in
|
|
47
|
+
for name, mapping in load_declaration("plane_agent").schema_mappings.items()
|
|
48
48
|
if not mapping.ontology_class
|
|
49
49
|
]
|
|
50
50
|
assert unmapped == []
|
|
@@ -5,7 +5,7 @@ from __future__ import annotations
|
|
|
5
5
|
from pathlib import Path
|
|
6
6
|
|
|
7
7
|
import pytest
|
|
8
|
-
from
|
|
8
|
+
from agent_connector_sdk.ingest import load_declaration
|
|
9
9
|
from agent_connector_sdk.mcp.tool_surface import operation_prefix
|
|
10
10
|
|
|
11
11
|
|
|
@@ -14,7 +14,7 @@ REPO_ROOT = Path(__file__).resolve().parent.parent
|
|
|
14
14
|
|
|
15
15
|
@pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
|
|
16
16
|
def test_declares_ingestible_sources() -> None:
|
|
17
|
-
declaration =
|
|
17
|
+
declaration = load_declaration("plane_agent")
|
|
18
18
|
assert declaration is not None
|
|
19
19
|
assert declaration.connector == "plane-mcp"
|
|
20
20
|
prefix = operation_prefix("plane-agent")
|
|
@@ -34,7 +34,7 @@ def test_declares_ingestible_sources() -> None:
|
|
|
34
34
|
|
|
35
35
|
@pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
|
|
36
36
|
def test_work_items_fan_out_per_project_and_map_to_issue_state() -> None:
|
|
37
|
-
declaration =
|
|
37
|
+
declaration = load_declaration("plane_agent")
|
|
38
38
|
for source_id in ("work-items", "project-states"):
|
|
39
39
|
source = declaration.source(source_id)
|
|
40
40
|
assert source is not None and source.for_each is not None
|
|
@@ -57,7 +57,7 @@ def test_work_items_fan_out_per_project_and_map_to_issue_state() -> None:
|
|
|
57
57
|
@pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
|
|
58
58
|
def test_sources_name_read_only_tools() -> None:
|
|
59
59
|
source_text = (REPO_ROOT / "plane_agent" / "mcp_server.py").read_text()
|
|
60
|
-
declaration =
|
|
60
|
+
declaration = load_declaration("plane_agent")
|
|
61
61
|
for source in declaration.sources:
|
|
62
62
|
assert not any(
|
|
63
63
|
verb in tool for tool in source.tools for verb in ("create", "update", "delete")
|