autoassembler 0.3.1__py3-none-any.whl

autoassembler/planning/client.py

@@ -0,0 +1,1174 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.adapt_mpp_accepted import AdaptMppAccepted
+from ..types.diff_report import DiffReport
+from ..types.manufacturing_process_plan import ManufacturingProcessPlan
+from ..types.mpp_summary import MppSummary
+from ..types.seq_plan_accepted import SeqPlanAccepted
+from .raw_client import AsyncRawPlanningClient, RawPlanningClient
+from .types.adapt_request_namespace import AdaptRequestNamespace
+from .types.create_mpp_request_body import CreateMppRequestBody
+from .types.create_mpp_request_namespace import CreateMppRequestNamespace
+from .types.delete_mpp_request_namespace import DeleteMppRequestNamespace
+from .types.delete_mpp_response import DeleteMppResponse
+from .types.evaluate_dfa_request_namespace import EvaluateDfaRequestNamespace
+from .types.get_mpp_request_namespace import GetMppRequestNamespace
+from .types.get_mpp_response import GetMppResponse
+from .types.list_mpps_request_namespace import ListMppsRequestNamespace
+from .types.plan_request_namespace import PlanRequestNamespace
+from .types.validate_request_namespace import ValidateRequestNamespace
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class PlanningClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawPlanningClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawPlanningClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawPlanningClient
+        """
+        return self._raw_client
+
+    def list_mpps(
+        self, namespace: ListMppsRequestNamespace, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[MppSummary]:
+        """
+        Parameters
+        ----------
+        namespace : ListMppsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[MppSummary]
+            Process plan summaries for the assembly.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.planning.list_mpps(
+            namespace="user",
+            id="id",
+        )
+        """
+        _response = self._raw_client.list_mpps(namespace, id, request_options=request_options)
+        return _response.data
+
+    def create_mpp(
+        self,
+        namespace: CreateMppRequestNamespace,
+        id: str,
+        *,
+        request: CreateMppRequestBody,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ManufacturingProcessPlan:
+        """
+        Parameters
+        ----------
+        namespace : CreateMppRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request : CreateMppRequestBody
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ManufacturingProcessPlan
+            Created process plan document.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler, CreateMppRequest
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.planning.create_mpp(
+            namespace="user",
+            id="id",
+            request=CreateMppRequest(
+                name="name",
+            ),
+        )
+        """
+        _response = self._raw_client.create_mpp(namespace, id, request=request, request_options=request_options)
+        return _response.data
+
+    def adapt(
+        self,
+        namespace: AdaptRequestNamespace,
+        id: str,
+        *,
+        reference_mpp_id: str,
+        diff: DiffReport,
+        name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AdaptMppAccepted:
+        """
+        Creates a process plan for the target assembly by adapting a reference assembly's
+        process plan. Runs asynchronously and returns immediately with the
+        new `mppId` and `jobId`.
+
+        Parameters
+        ----------
+        namespace : AdaptRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        reference_mpp_id : str
+            Process plan for the reference assembly to adapt from.
+
+        diff : DiffReport
+
+        name : typing.Optional[str]
+            Optional name for the adapted process plan.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AdaptMppAccepted
+            Adaptation queued, with the operation tracking it.
+
+        Examples
+        --------
+        from autoassembler import (
+            AutoAssembler,
+            DiffDetails,
+            DiffFlags,
+            DiffNode,
+            DiffNodePairWithParts,
+            DiffReferenceTargetNodes,
+            DiffReport,
+            DiffSummary,
+            DiffSummaryAssemblyLabels,
+            DiffSummaryGeometricDiffs,
+            DiffSummaryPersistentEdgesCongruence,
+            DiffSummaryPersistentEdgesCongruencePose,
+            DiffSummaryPersistentNodesCongruence,
+            DiffSummaryPersistentNodesCongruencePose,
+            DiffSummaryTotalParts,
+            DiffSwap,
+        )
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.planning.adapt(
+            namespace="user",
+            id="id",
+            reference_mpp_id="referenceMppId",
+            diff=DiffReport(
+                version=4,
+                summary=DiffSummary(
+                    assembly_labels=DiffSummaryAssemblyLabels(
+                        reference="gearbox-v1",
+                        reference_name="Gearbox v1",
+                        target="gearbox-v2",
+                        target_name="Gearbox v2",
+                    ),
+                    total_parts=DiffSummaryTotalParts(
+                        reference=5,
+                        target=5,
+                    ),
+                    geometric_diffs=DiffSummaryGeometricDiffs(
+                        reference=1,
+                        target=1,
+                    ),
+                    persistent_nodes_congruence=DiffSummaryPersistentNodesCongruence(
+                        reference=4,
+                        target=4,
+                    ),
+                    persistent_nodes_congruence_pose=DiffSummaryPersistentNodesCongruencePose(
+                        reference=3,
+                        target=3,
+                    ),
+                    persistent_edges_congruence=DiffSummaryPersistentEdgesCongruence(
+                        reference=3,
+                        target=3,
+                    ),
+                    persistent_edges_congruence_pose=DiffSummaryPersistentEdgesCongruencePose(
+                        reference=2,
+                        target=2,
+                    ),
+                    candidate_swaps=2,
+                ),
+                details=DiffDetails(
+                    geom_diff_nodes=DiffReferenceTargetNodes(
+                        reference=[
+                            DiffNode(
+                                node="ref-old-mount",
+                                part="old-mount",
+                            )
+                        ],
+                        target=[
+                            DiffNode(
+                                node="target-new-mount",
+                                part="new-mount",
+                            )
+                        ],
+                    ),
+                    swaps=[
+                        DiffSwap(
+                            reference_node="ref-left-cover",
+                            target_node="target-right-cover",
+                            reference_parent="ref-housing",
+                            target_parent="target-housing",
+                            reference_part="left-cover",
+                            target_part="right-cover",
+                            confidence="high",
+                        ),
+                        DiffSwap(
+                            reference_node="ref-old-bracket",
+                            target_node="target-new-bracket",
+                            reference_part="old-bracket",
+                            target_part="new-bracket",
+                            identity_score=0.72,
+                            confidence="low",
+                            embedding_similarity=0.9,
+                            volume_ratio=0.8,
+                            same_identity_score=0.72,
+                            volume_ratio_min=0.85,
+                        ),
+                    ],
+                    moved_pose_pairs=[
+                        DiffNodePairWithParts(
+                            reference_node="ref-motor",
+                            target_node="target-motor",
+                            reference_parent="ref-housing",
+                            target_parent="target-housing",
+                            reference_part="motor",
+                            target_part="motor",
+                        )
+                    ],
+                    flags=DiffFlags(
+                        same_geom_diff_name_pairs=[DiffNodePairWithParts()],
+                        same_geom_pose_diff_name_pairs=[DiffNodePairWithParts()],
+                        same_name_congruent_diff_pose_pairs=[DiffNodePairWithParts()],
+                        part_revision=[DiffNodePairWithParts()],
+                        unchanged_pairs=[
+                            DiffNodePairWithParts(
+                                reference_node="ref-housing",
+                                target_node="target-housing",
+                                reference_parent="ref-root",
+                                target_parent="target-root",
+                            )
+                        ],
+                    ),
+                ),
+            ),
+        )
+        """
+        _response = self._raw_client.adapt(
+            namespace, id, reference_mpp_id=reference_mpp_id, diff=diff, name=name, request_options=request_options
+        )
+        return _response.data
+
+    def get_mpp(
+        self,
+        namespace: GetMppRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> GetMppResponse:
+        """
+        Parameters
+        ----------
+        namespace : GetMppRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetMppResponse
+            Process plan document wrapper.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.planning.get_mpp(
+            namespace="user",
+            id="id",
+            mpp_id="mppId",
+        )
+        """
+        _response = self._raw_client.get_mpp(namespace, id, mpp_id, request_options=request_options)
+        return _response.data
+
+    def delete_mpp(
+        self,
+        namespace: DeleteMppRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DeleteMppResponse:
+        """
+        Parameters
+        ----------
+        namespace : DeleteMppRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DeleteMppResponse
+            Delete status.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.planning.delete_mpp(
+            namespace="user",
+            id="id",
+            mpp_id="mppId",
+        )
+        """
+        _response = self._raw_client.delete_mpp(namespace, id, mpp_id, request_options=request_options)
+        return _response.data
+
+    def plan(
+        self,
+        namespace: PlanRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        station_ids: typing.Sequence[str],
+        overwrite: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SeqPlanAccepted:
+        """
+        Plans the Station graph from scratch, computing a suitable process plan (Step graph)
+        for each of the requested stations. The run overwrites any pre-existing plan; deciding which
+        stations have to be re-planned is the caller's responsibility.
+        Pass `overwrite: false` to have a station that already has a plan left alone instead.
+
+        **Async** — returns 202 immediately.
+
+        Parameters
+        ----------
+        namespace : PlanRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        station_ids : typing.Sequence[str]
+            IDs of the Station nodes to plan. All must exist in the process plan's station graph and have a supported input/output boundary.
+
+        overwrite : typing.Optional[bool]
+            Whether the run may replace a plan a requested station already has. Checked per station, so one station never blocks another.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SeqPlanAccepted
+            Planning jobs accepted and running in the background.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.planning.plan(
+            namespace="user",
+            id="id",
+            mpp_id="mppId",
+            station_ids=["stationIds"],
+        )
+        """
+        _response = self._raw_client.plan(
+            namespace, id, mpp_id, station_ids=station_ids, overwrite=overwrite, request_options=request_options
+        )
+        return _response.data
+
+    def validate(
+        self,
+        namespace: ValidateRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        station_ids: typing.Sequence[str],
+        fix_directions: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SeqPlanAccepted:
+        """
+        **Feasibility validation** — checks structural consistency of the entire process plan,
+        then validates geometrical feasibility of assembly steps for the requested
+        stations. When a blocked step has a workspace-free alternative direction,
+        `fixDirections` (off by default) writes it onto the step graph and the
+        persisted verdict reflects the repaired plan.
+
+        **Async** — returns 202 with `{ queued }`.
+
+        Parameters
+        ----------
+        namespace : ValidateRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        station_ids : typing.Sequence[str]
+            IDs of the Station nodes to validate. All must exist in the process plan's station graph and stations without persisted assembly steps are accepted and reported as skipped.
+
+        fix_directions : typing.Optional[bool]
+            Apply each blocked step's workspace-free alternative direction onto the step graph, so the persisted verdict describes the repaired plan. Absent, the step graph is untouched.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SeqPlanAccepted
+            Validation jobs accepted and running in the background.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.planning.validate(
+            namespace="user",
+            id="id",
+            mpp_id="mppId",
+            station_ids=["stationIds"],
+        )
+        """
+        _response = self._raw_client.validate(
+            namespace,
+            id,
+            mpp_id,
+            station_ids=station_ids,
+            fix_directions=fix_directions,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def evaluate_dfa(
+        self,
+        namespace: EvaluateDfaRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        station_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SeqPlanAccepted:
+        """
+        Projects each sequential assembly addend directly from the persisted Step
+        graph into an explicit state-of-assembly transition, evaluates DFA, and
+        persists per-station reports under `plan.dfa`. Runs asynchronously.
+
+        Parameters
+        ----------
+        namespace : EvaluateDfaRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        station_ids : typing.Optional[typing.Sequence[str]]
+            Stations to score. Omitted means every station with assembly steps, and then a station that is not ready is skipped rather than refused. A station named here must be planned and hold a feasible validation verdict, or the whole request is refused with 409. Named stations without assembly steps are accepted and reported as skipped.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SeqPlanAccepted
+            DFA evaluation accepted (or nothing to evaluate). `skipped` lists requested stations that were not queued — no assembly steps, or, for an unfiltered request, not yet validated.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.planning.evaluate_dfa(
+            namespace="user",
+            id="id",
+            mpp_id="mppId",
+        )
+        """
+        _response = self._raw_client.evaluate_dfa(
+            namespace, id, mpp_id, station_ids=station_ids, request_options=request_options
+        )
+        return _response.data
+
+
+class AsyncPlanningClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawPlanningClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawPlanningClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawPlanningClient
+        """
+        return self._raw_client
+
+    async def list_mpps(
+        self, namespace: ListMppsRequestNamespace, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[MppSummary]:
+        """
+        Parameters
+        ----------
+        namespace : ListMppsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[MppSummary]
+            Process plan summaries for the assembly.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.planning.list_mpps(
+                namespace="user",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list_mpps(namespace, id, request_options=request_options)
+        return _response.data
+
+    async def create_mpp(
+        self,
+        namespace: CreateMppRequestNamespace,
+        id: str,
+        *,
+        request: CreateMppRequestBody,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ManufacturingProcessPlan:
+        """
+        Parameters
+        ----------
+        namespace : CreateMppRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request : CreateMppRequestBody
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ManufacturingProcessPlan
+            Created process plan document.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler, CreateMppRequest
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.planning.create_mpp(
+                namespace="user",
+                id="id",
+                request=CreateMppRequest(
+                    name="name",
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_mpp(namespace, id, request=request, request_options=request_options)
+        return _response.data
+
+    async def adapt(
+        self,
+        namespace: AdaptRequestNamespace,
+        id: str,
+        *,
+        reference_mpp_id: str,
+        diff: DiffReport,
+        name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AdaptMppAccepted:
+        """
+        Creates a process plan for the target assembly by adapting a reference assembly's
+        process plan. Runs asynchronously and returns immediately with the
+        new `mppId` and `jobId`.
+
+        Parameters
+        ----------
+        namespace : AdaptRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        reference_mpp_id : str
+            Process plan for the reference assembly to adapt from.
+
+        diff : DiffReport
+
+        name : typing.Optional[str]
+            Optional name for the adapted process plan.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AdaptMppAccepted
+            Adaptation queued, with the operation tracking it.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import (
+            AsyncAutoAssembler,
+            DiffDetails,
+            DiffFlags,
+            DiffNode,
+            DiffNodePairWithParts,
+            DiffReferenceTargetNodes,
+            DiffReport,
+            DiffSummary,
+            DiffSummaryAssemblyLabels,
+            DiffSummaryGeometricDiffs,
+            DiffSummaryPersistentEdgesCongruence,
+            DiffSummaryPersistentEdgesCongruencePose,
+            DiffSummaryPersistentNodesCongruence,
+            DiffSummaryPersistentNodesCongruencePose,
+            DiffSummaryTotalParts,
+            DiffSwap,
+        )
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.planning.adapt(
+                namespace="user",
+                id="id",
+                reference_mpp_id="referenceMppId",
+                diff=DiffReport(
+                    version=4,
+                    summary=DiffSummary(
+                        assembly_labels=DiffSummaryAssemblyLabels(
+                            reference="gearbox-v1",
+                            reference_name="Gearbox v1",
+                            target="gearbox-v2",
+                            target_name="Gearbox v2",
+                        ),
+                        total_parts=DiffSummaryTotalParts(
+                            reference=5,
+                            target=5,
+                        ),
+                        geometric_diffs=DiffSummaryGeometricDiffs(
+                            reference=1,
+                            target=1,
+                        ),
+                        persistent_nodes_congruence=DiffSummaryPersistentNodesCongruence(
+                            reference=4,
+                            target=4,
+                        ),
+                        persistent_nodes_congruence_pose=DiffSummaryPersistentNodesCongruencePose(
+                            reference=3,
+                            target=3,
+                        ),
+                        persistent_edges_congruence=DiffSummaryPersistentEdgesCongruence(
+                            reference=3,
+                            target=3,
+                        ),
+                        persistent_edges_congruence_pose=DiffSummaryPersistentEdgesCongruencePose(
+                            reference=2,
+                            target=2,
+                        ),
+                        candidate_swaps=2,
+                    ),
+                    details=DiffDetails(
+                        geom_diff_nodes=DiffReferenceTargetNodes(
+                            reference=[
+                                DiffNode(
+                                    node="ref-old-mount",
+                                    part="old-mount",
+                                )
+                            ],
+                            target=[
+                                DiffNode(
+                                    node="target-new-mount",
+                                    part="new-mount",
+                                )
+                            ],
+                        ),
+                        swaps=[
+                            DiffSwap(
+                                reference_node="ref-left-cover",
+                                target_node="target-right-cover",
+                                reference_parent="ref-housing",
+                                target_parent="target-housing",
+                                reference_part="left-cover",
+                                target_part="right-cover",
+                                confidence="high",
+                            ),
+                            DiffSwap(
+                                reference_node="ref-old-bracket",
+                                target_node="target-new-bracket",
+                                reference_part="old-bracket",
+                                target_part="new-bracket",
+                                identity_score=0.72,
+                                confidence="low",
+                                embedding_similarity=0.9,
+                                volume_ratio=0.8,
+                                same_identity_score=0.72,
+                                volume_ratio_min=0.85,
+                            ),
+                        ],
+                        moved_pose_pairs=[
+                            DiffNodePairWithParts(
+                                reference_node="ref-motor",
+                                target_node="target-motor",
+                                reference_parent="ref-housing",
+                                target_parent="target-housing",
+                                reference_part="motor",
+                                target_part="motor",
+                            )
+                        ],
+                        flags=DiffFlags(
+                            same_geom_diff_name_pairs=[DiffNodePairWithParts()],
+                            same_geom_pose_diff_name_pairs=[DiffNodePairWithParts()],
+                            same_name_congruent_diff_pose_pairs=[
+                                DiffNodePairWithParts()
+                            ],
+                            part_revision=[DiffNodePairWithParts()],
+                            unchanged_pairs=[
+                                DiffNodePairWithParts(
+                                    reference_node="ref-housing",
+                                    target_node="target-housing",
+                                    reference_parent="ref-root",
+                                    target_parent="target-root",
+                                )
+                            ],
+                        ),
+                    ),
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.adapt(
+            namespace, id, reference_mpp_id=reference_mpp_id, diff=diff, name=name, request_options=request_options
+        )
+        return _response.data
+
+    async def get_mpp(
+        self,
+        namespace: GetMppRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> GetMppResponse:
+        """
+        Parameters
+        ----------
+        namespace : GetMppRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetMppResponse
+            Process plan document wrapper.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.planning.get_mpp(
+                namespace="user",
+                id="id",
+                mpp_id="mppId",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_mpp(namespace, id, mpp_id, request_options=request_options)
+        return _response.data
+
+    async def delete_mpp(
+        self,
+        namespace: DeleteMppRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DeleteMppResponse:
+        """
+        Parameters
+        ----------
+        namespace : DeleteMppRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DeleteMppResponse
+            Delete status.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.planning.delete_mpp(
+                namespace="user",
+                id="id",
+                mpp_id="mppId",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.delete_mpp(namespace, id, mpp_id, request_options=request_options)
+        return _response.data
+
+    async def plan(
+        self,
+        namespace: PlanRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        station_ids: typing.Sequence[str],
+        overwrite: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SeqPlanAccepted:
+        """
+        Plans the Station graph from scratch, computing a suitable process plan (Step graph)
+        for each of the requested stations. The run overwrites any pre-existing plan; deciding which
+        stations have to be re-planned is the caller's responsibility.
+        Pass `overwrite: false` to have a station that already has a plan left alone instead.
+
+        **Async** — returns 202 immediately.
+
+        Parameters
+        ----------
+        namespace : PlanRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        station_ids : typing.Sequence[str]
+            IDs of the Station nodes to plan. All must exist in the process plan's station graph and have a supported input/output boundary.
+
+        overwrite : typing.Optional[bool]
+            Whether the run may replace a plan a requested station already has. Checked per station, so one station never blocks another.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SeqPlanAccepted
+            Planning jobs accepted and running in the background.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.planning.plan(
+                namespace="user",
+                id="id",
+                mpp_id="mppId",
+                station_ids=["stationIds"],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.plan(
+            namespace, id, mpp_id, station_ids=station_ids, overwrite=overwrite, request_options=request_options
+        )
+        return _response.data
+
+    async def validate(
+        self,
+        namespace: ValidateRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        station_ids: typing.Sequence[str],
+        fix_directions: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SeqPlanAccepted:
+        """
+        **Feasibility validation** — checks structural consistency of the entire process plan,
+        then validates geometrical feasibility of assembly steps for the requested
+        stations. When a blocked step has a workspace-free alternative direction,
+        `fixDirections` (off by default) writes it onto the step graph and the
+        persisted verdict reflects the repaired plan.
+
+        **Async** — returns 202 with `{ queued }`.
+
+        Parameters
+        ----------
+        namespace : ValidateRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        station_ids : typing.Sequence[str]
+            IDs of the Station nodes to validate. All must exist in the process plan's station graph and stations without persisted assembly steps are accepted and reported as skipped.
+
+        fix_directions : typing.Optional[bool]
+            Apply each blocked step's workspace-free alternative direction onto the step graph, so the persisted verdict describes the repaired plan. Absent, the step graph is untouched.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SeqPlanAccepted
+            Validation jobs accepted and running in the background.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.planning.validate(
+                namespace="user",
+                id="id",
+                mpp_id="mppId",
+                station_ids=["stationIds"],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.validate(
+            namespace,
+            id,
+            mpp_id,
+            station_ids=station_ids,
+            fix_directions=fix_directions,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def evaluate_dfa(
+        self,
+        namespace: EvaluateDfaRequestNamespace,
+        id: str,
+        mpp_id: str,
+        *,
+        station_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SeqPlanAccepted:
+        """
+        Projects each sequential assembly addend directly from the persisted Step
+        graph into an explicit state-of-assembly transition, evaluates DFA, and
+        persists per-station reports under `plan.dfa`. Runs asynchronously.
+
+        Parameters
+        ----------
+        namespace : EvaluateDfaRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        mpp_id : str
+            Manufacturing Process Plan ID.
+
+        station_ids : typing.Optional[typing.Sequence[str]]
+            Stations to score. Omitted means every station with assembly steps, and then a station that is not ready is skipped rather than refused. A station named here must be planned and hold a feasible validation verdict, or the whole request is refused with 409. Named stations without assembly steps are accepted and reported as skipped.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SeqPlanAccepted
+            DFA evaluation accepted (or nothing to evaluate). `skipped` lists requested stations that were not queued — no assembly steps, or, for an unfiltered request, not yet validated.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.planning.evaluate_dfa(
+                namespace="user",
+                id="id",
+                mpp_id="mppId",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.evaluate_dfa(
+            namespace, id, mpp_id, station_ids=station_ids, request_options=request_options
+        )
+        return _response.data