plane-agent 2.3.7__tar.gz → 2.3.9__tar.gz

{plane_agent-2.3.7/plane_agent.egg-info → plane_agent-2.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plane-agent
-Version: 2.3.7
+Version: 2.3.9
 Summary: Plane MCP Agent
 Author-email: Project Maintainers <maintainers@users.noreply.github.com>
 License: MIT
@@ -12,12 +12,12 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: <3.15,>=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.0
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3
 Requires-Dist: requests>=2.34.2
 Provides-Extra: mcp
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.0; extra == "mcp"
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "mcp"
 Provides-Extra: all
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.0; extra == "all"
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "all"
 Provides-Extra: test
 Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
 Requires-Dist: pytest>=9.1.1; extra == "test"
@@ -47,7 +47,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/plane-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/plane-agent)
 
-*Version: 2.3.7*
+*Version: 2.3.9*
 
 > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
 > interfaces, and guidance for provisioning a self-hosted Plane instance are

{plane_agent-2.3.7 → plane_agent-2.3.9}/README.md

@@ -20,7 +20,7 @@
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/plane-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/plane-agent)
 
-*Version: 2.3.7*
+*Version: 2.3.9*
 
 > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
 > interfaces, and guidance for provisioning a self-hosted Plane instance are

{plane_agent-2.3.7 → plane_agent-2.3.9}/plane_agent/connector_sources.py

@@ -28,6 +28,39 @@ SOURCES = (
         text_field="description",
         title_field="name",
     ),
+    source_meta(
+        tool="plane_list_work_items",
+        source_id="work-items",
+        record_type="Issue",
+        id_field="id",
+        cursor_field="updated_at",
+        description="Plane work items of every project in the workspace.",
+        for_each={"source": "projects", "argument": "project_id", "field": "id"},
+        preset={
+            "doc_type": "work_item",
+            "params_style": "args",
+        },
+        records_path="data.results",
+        server="plane-mcp",
+        text_field="description_html",
+        title_field="name",
+    ),
+    source_meta(
+        tool="plane_list_states",
+        source_id="project-states",
+        record_type="ProjectState",
+        id_field="id",
+        cursor_field="updated_at",
+        description="Workflow states of every project; resolves the state id of a work item to its name.",
+        for_each={"source": "projects", "argument": "project_id", "field": "id"},
+        preset={
+            "doc_type": "project_state",
+            "params_style": "args",
+        },
+        records_path="data",
+        server="plane-mcp",
+        title_field="name",
+    ),
 )
 
 SCHEMA_MAPPINGS = {

{plane_agent-2.3.7 → plane_agent-2.3.9/plane_agent.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plane-agent
-Version: 2.3.7
+Version: 2.3.9
 Summary: Plane MCP Agent
 Author-email: Project Maintainers <maintainers@users.noreply.github.com>
 License: MIT
@@ -12,12 +12,12 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: <3.15,>=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.0
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3
 Requires-Dist: requests>=2.34.2
 Provides-Extra: mcp
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.0; extra == "mcp"
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "mcp"
 Provides-Extra: all
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.0; extra == "all"
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.3; extra == "all"
 Provides-Extra: test
 Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
 Requires-Dist: pytest>=9.1.1; extra == "test"
@@ -47,7 +47,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/plane-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/plane-agent)
 
-*Version: 2.3.7*
+*Version: 2.3.9*
 
 > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
 > interfaces, and guidance for provisioning a self-hosted Plane instance are

plane_agent-2.3.9/plane_agent.egg-info/requires.txt

@@ -0,0 +1,14 @@
+agent-connector-sdk[mcp]<1.0.0,>=0.4.3
+requests>=2.34.2
+
+[all]
+agent-connector-sdk[mcp]<1.0.0,>=0.4.3
+
+[mcp]
+agent-connector-sdk[mcp]<1.0.0,>=0.4.3
+
+[test]
+pytest-xdist>=3.8.0
+pytest>=9.1.1
+pytest-asyncio>=1.4.0
+pytest-cov>=7.1.0

{plane_agent-2.3.7 → plane_agent-2.3.9}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "plane-agent"
-version = "2.3.7"
+version = "2.3.9"
 description = "Plane MCP Agent"
 readme = "README.md"
 classifiers = [ "Development Status :: 4 - Beta", "License :: OSI Approved :: MIT License", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
 requires-python = ">=3.12, <3.15"
-dependencies = [ "agent-connector-sdk[mcp]>=0.4.0,<1.0.0", "requests>=2.34.2",]
+dependencies = [ "agent-connector-sdk[mcp]>=0.4.3,<1.0.0", "requests>=2.34.2",]
 [[project.authors]]
 name = "Project Maintainers"
 email = "maintainers@users.noreply.github.com"
@@ -21,8 +21,8 @@ text = "MIT"
 plane-mcp = "plane_agent.mcp_server:mcp_server"
 
 [project.optional-dependencies]
-mcp = [ "agent-connector-sdk[mcp]>=0.4.0,<1.0.0",]
-all = [ "agent-connector-sdk[mcp]>=0.4.0,<1.0.0",]
+mcp = [ "agent-connector-sdk[mcp]>=0.4.3,<1.0.0",]
+all = [ "agent-connector-sdk[mcp]>=0.4.3,<1.0.0",]
 test = [
     "pytest-xdist>=3.8.0", "pytest>=9.1.1", "pytest-asyncio>=1.4.0", "pytest-cov>=7.1.0",]
 

plane_agent-2.3.9/requirements.txt

@@ -0,0 +1 @@
+agent-connector-sdk[mcp]>=0.4.3,<1.0.0

plane_agent-2.3.9/tests/test_ingest_sources.py

@@ -0,0 +1,65 @@
+"""The packaged ingestible-source declaration (CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+from plane_agent.connector_sources import declaration as declared_sources
+from agent_connector_sdk.mcp.tool_surface import operation_prefix
+
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+
+
+@pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
+def test_declares_ingestible_sources() -> None:
+    declaration = declared_sources()
+    assert declaration is not None
+    assert declaration.connector == "plane-mcp"
+    prefix = operation_prefix("plane-agent")
+    expected = {
+        "projects": ("SoftwareProject", f"{prefix}_list_projects"),
+        "work-items": ("Issue", f"{prefix}_list_work_items"),
+        "project-states": ("ProjectState", f"{prefix}_list_states"),
+    }
+    assert [s.source_id for s in declaration.sources] == list(expected)
+    for source in declaration.sources:
+        record_type, tool = expected[source.source_id]
+        assert source.record_type == record_type
+        assert source.tools == (tool,)
+        # The engine admits a record only under the pack mapping of its type.
+        assert record_type in declaration.schema_mappings
+
+
+@pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
+def test_work_items_fan_out_per_project_and_map_to_issue_state() -> None:
+    declaration = declared_sources()
+    for source_id in ("work-items", "project-states"):
+        source = declaration.source(source_id)
+        assert source is not None and source.for_each is not None
+        assert source.for_each.source == "projects"
+        assert (source.for_each.argument, source.for_each.field) == (
+            "project_id",
+            "id",
+        )
+    work_items = declaration.source("work-items")
+    assert work_items is not None
+    assert (work_items.id_field, work_items.title_field) == ("id", "name")
+    assert work_items.records_path == "data.results"
+    mapping = declaration.schema_mappings["Issue"]
+    assert mapping.ontology_class == "WorkItem"
+    assert "state" in mapping.fields
+    ontology = (REPO_ROOT / "plane_agent" / "ontology" / "plane.ttl").read_text()
+    assert "Issue" in ontology and "state" in ontology
+
+
+@pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
+def test_sources_name_read_only_tools() -> None:
+    source_text = (REPO_ROOT / "plane_agent" / "mcp_server.py").read_text()
+    declaration = declared_sources()
+    for source in declaration.sources:
+        assert not any(
+            verb in tool for tool in source.tools for verb in ("create", "update", "delete")
+        )
+    assert "list_work_items" in source_text and "list_states" in source_text

plane_agent-2.3.7/plane_agent.egg-info/requires.txt

@@ -1,14 +0,0 @@
-agent-connector-sdk[mcp]<1.0.0,>=0.4.0
-requests>=2.34.2
-
-[all]
-agent-connector-sdk[mcp]<1.0.0,>=0.4.0
-
-[mcp]
-agent-connector-sdk[mcp]<1.0.0,>=0.4.0
-
-[test]
-pytest-xdist>=3.8.0
-pytest>=9.1.1
-pytest-asyncio>=1.4.0
-pytest-cov>=7.1.0

plane_agent-2.3.7/requirements.txt

@@ -1 +0,0 @@
-agent-connector-sdk[mcp]>=0.4.0,<1.0.0

plane_agent-2.3.7/tests/test_ingest_sources.py

@@ -1,27 +0,0 @@
-"""The packaged ingestible-source declaration (CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003)."""
-
-from __future__ import annotations
-
-from pathlib import Path
-
-import pytest
-from plane_agent.connector_sources import declaration as declared_sources
-from agent_connector_sdk.mcp.tool_surface import operation_prefix
-
-
-REPO_ROOT = Path(__file__).resolve().parent.parent
-
-
-@pytest.mark.spec("CONN-PLANE-AGENT-CONNECTOR-CONTENT-R003")
-def test_declares_ingestible_sources() -> None:
-    declaration = declared_sources()
-    assert declaration is not None
-    assert declaration.connector == "plane-mcp"
-    source = declaration.source("projects")
-    assert source is not None and source.record_type == "SoftwareProject"
-    prefix = operation_prefix("plane-agent")
-    assert source.tools == (f"{prefix}_list_projects",)
-    # The engine admits a record only under the pack mapping of its type.
-    assert source.record_type in declared_sources().schema_mappings
-    # Work items are project-scoped, so only the projects source is declared.
-    assert [s.source_id for s in declaration.sources] == ["projects"]