pynydus.agents.letta.hatcher

Letta hatcher connector. Spec §10.3.

Produces a valid Letta AgentFile (.af) from an Egg:

  • agent.af <- single JSON file conforming to AgentFileSchema

The .af file is a self-contained portable format importable by any Letta server via letta.agents.import_file().

All 4 MemoryLabel values have explicit mappings:

  • PERSONA -> blocks[label=”persona”]

  • CONTEXT -> blocks[label=”human”]

  • FLOW -> agents[0].system

  • STATE -> archival_memory.json (supplemental. .af doesn’t support passages yet)

Module Contents

Classes

LettaHatcher

Produce a valid Letta AgentFile (.af) from an Egg.

Functions

_skill_to_module_name

Convert a skill display name to a Python module name.

API

class pynydus.agents.letta.hatcher.LettaHatcher

Bases: pynydus.api.protocols.Hatcher

Produce a valid Letta AgentFile (.af) from an Egg.

render(egg: pynydus.api.schemas.Egg, output_dir: pathlib.Path) → pynydus.api.raw_types.RenderResult

Render Egg records into an AgentFileSchema-shaped .af file.

Placeholders ({{SECRET_NNN}}, {{PII_NNN}}) are preserved. the pipeline substitutes real values after this step.

Args: egg: The Egg to render. output_dir: Target directory (unused, pipeline performs disk I/O).

Returns: File dict and any warnings produced during rendering.

hatch(egg: pynydus.api.schemas.Egg, output_dir: pathlib.Path) → pynydus.api.schemas.HatchResult

Generate Letta project files from an Egg.

.. deprecated:: Use :meth:render instead. The pipeline now handles disk I/O.

Args: egg: The Egg to hatch. output_dir: Directory where output files are written.

Returns: Result with list of created files and any warnings.

pynydus.agents.letta.hatcher._skill_to_module_name(name: str) → str

Convert a skill display name to a Python module name.