pynydus.api.protocols

Abstract base classes for agent connectors (spawners and hatchers).

Module Contents

Classes

Spawner	Base class for all platform spawners.
Hatcher	Base class for all platform hatchers.

API

class pynydus.api.protocols.Spawner

Bases: abc.ABC

Base class for all platform spawners.

A spawner reads redacted source files and produces a ParseResult containing structured skills, memory, MCP configs, and neutral metadata.

abstract parse(files: dict[str, str]) → pynydus.api.raw_types.ParseResult

Parse redacted source files into structured records.

Args: files: Mapping of relative path to UTF-8 content (already redacted).

Returns: Structured parse output.

class pynydus.api.protocols.Hatcher

Bases: abc.ABC

Base class for all platform hatchers.

A hatcher takes a loaded Egg and produces target-platform files in an output directory.

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

Render egg contents into target-platform files.

Args: egg: Loaded Egg with all modules. output_dir: Target output directory (connectors may ignore until write).

Returns: File mapping and optional warnings (placeholders intact).