Public API surface

PenguiFlow’s public surface is exported from penguiflow.__init__.

Import style

Prefer importing from penguiflow (top-level) for stable APIs:

from penguiflow import PenguiFlow, Context, NodePolicy, ReactPlanner

Stability expectations

• Public types and functions exported at top-level aim to be stable across 2.x.
• Internal modules and RFC/proposal documents may change without notice.

Key entry points

• Runtime: create(), PenguiFlow, Node, Context, NodePolicy
• Concurrency: map_concurrent, join_k, routers
• Planner: ReactPlanner, Trajectory
• Skills: SkillsConfig, SkillPackConfig, SkillProvider, SkillProviderFactory, SkillProposeRequest
• Sessions: StreamingSession, SessionManager
• Tools: tool, build_catalog, ToolLoadingMode

Version source of truth

• Package version: penguiflow.__version__
• Packaging metadata: pyproject.toml