plm-connector-sdk

Wave 5 Conv D (FTR-605 V1 head) — decorator-based authoring surface for read-only connectors against external PLM systems.

Quick start

from plm_connector_sdk import (
    ConnectorContext,
    ConnectorReadRequest,
    ConnectorReadResult,
    connector,
    read_method,
)


@connector(id="teamcenter", version="1.0.0", description="Teamcenter ref")
class TeamcenterConnector:
    @read_method(name="get_item", evidence_ref_type="tc.item")
    async def get_item(
        self, request: ConnectorReadRequest, ctx: ConnectorContext
    ) -> ConnectorReadResult:
        ...

Federation with standalone MCP repos

Wave 5 Conv D ships the in-tree reference (teamcenter) only. Real production connectors for 3DEXPERIENCE / PTC Windchill live in standalone MCP-spec repos and federate at V1.1+ via the same ConnectorRuntime Protocol consumed by the engine-core dispatcher (no Python-level coupling — the dispatcher routes by connector_id to either an in-tree decorator-registered runtime OR an external MCP server URL once the wire protocol surface lands).

Authoring a new connector

See .federation/authoring-a-connector.md for the full generate → fill → verify workflow.

Import-linter contracts

• plm_connector_sdk MUST NOT import plm_engine_core.
• plm_connector_sdk MUST NOT import plm_skill_kernel.
• plm_connector_sdk MUST NOT import plm_accelerators (Workbench).