luplo.core.import_pipeline
==========================

.. py:module:: luplo.core.import_pipeline

.. autoapi-nested-parse::

   lp import — agent-driven extraction + verification pipeline.

   luplo holds zero LLM dependencies; all extraction and code-grounding work
   happens on the calling agent's surface. This package only handles the
   storage protocol: schemas, refusal helpers, and the begin/finalize phases.



Submodules
----------

.. toctree::
   :maxdepth: 1

   /api/luplo/core/import_pipeline/begin/index
   /api/luplo/core/import_pipeline/codeblock_strip/index
   /api/luplo/core/import_pipeline/finalize/index
   /api/luplo/core/import_pipeline/manifest/index
   /api/luplo/core/import_pipeline/refusal/index
   /api/luplo/core/import_pipeline/results/index
   /api/luplo/core/import_pipeline/sources/index


Classes
-------

.. autoapisummary::

   luplo.core.import_pipeline.ImportManifest
   luplo.core.import_pipeline.ImportResults


Package Contents
----------------

.. py:class:: ImportManifest

   Bases: :py:obj:`pydantic.BaseModel`


   Contract emitted by `begin` — read by the agent, agent-agnostic.


   .. py:attribute:: bundle_id
      :type:  str


   .. py:attribute:: dest_lang
      :type:  str | None


   .. py:attribute:: repo_root
      :type:  str


   .. py:attribute:: sources
      :type:  ManifestSources


   .. py:attribute:: protocol
      :type:  ProtocolBlock


   .. py:method:: at_least_one_source() -> ImportManifest

      Ensure the manifest carries at least one of spec or plan.



.. py:class:: ImportResults

   Bases: :py:obj:`pydantic.BaseModel`


   Envelope submitted by the agent to `finalize`.


   .. py:attribute:: bundle_id
      :type:  str


   .. py:attribute:: items
      :type:  list[ResultItem]


   .. py:attribute:: close_work_unit
      :type:  bool
      :value: False