Core tools

The connectors in this site (Gmail, Telegram, MCP, the gateway, …) give an agent reach into the outside world. Core tools are the complement: they give an agent structure over other agents — orchestration, planning, composition, and human-in-the-loop primitives that ship inside the LazyBridge core itself.

These live in lazybridge, not lazytools

Unlike the connectors (which live in the lazytoolkit package), the core tools are part of the LazyBridge runtime — either as Agent classmethods in core (chain, parallel) or as framework extensions under lazybridge.ext.* (planners, human-in-the-loop). They are documented here, alongside the connectors, so you have one place to look when you ask "what can I drop into Agent(tools=[...])?" — but the code, the version, and the CHANGELOG are LazyBridge's. Install LazyBridge (it comes transitively with pip install lazytoolkit).

Core tool	What it gives an agent	Import	Guide
Planners	Hand an LLM a list of sub-agents; get back one Agent that dynamically plans and dispatches work to them — a validated DAG builder or a flat blackboard to-do list.	from lazybridge.ext.planners import …	Planners
Composition sugar	Pre-packaged pipelines you shape: Agent.chain(…) runs agents sequentially; Agent.parallel(…) fans them out concurrently. Both return an agent.	from lazybridge import Agent	Composition sugar
Human-in-the-loop	Put a person in the loop as a one-turn approval/form (HumanEngine) or an interactive REPL with tools, retry, and store access (SupervisorEngine). Factories return an Agent.	from lazybridge.ext.hil import …	Human-in-the-loop

Core vs ext vs connectors

LazyBridge draws a deliberate line between the stable runtime and the extensions layered on top — see the upstream core-vs-ext guide. The short version:

Layer	Lives in	Holds
Core	lazybridge/	Agent, LLMEngine, Plan, Step, Tool, Envelope, Memory, Store, Session, sentinels, guards, providers
Framework extensions	lazybridge/ext/*	OpenTelemetry, HumanEngine / SupervisorEngine, evals, planners, visualizer
Concrete tools	lazytoolkit (this site)	connectors (Gmail, Telegram, MCP, gateway), document readers, skills

Where each core tool lives: chain / parallel are Agent classmethods in the frozen core; planners and human-in-the-loop are framework extensions (lazybridge.ext.*) — they compose the core Agent / Plan abstractions but are not part of the frozen core surface, so their API may evolve between LazyBridge minor releases. Pin a version and read the LazyBridge CHANGELOG before upgrading.

Follow the Planners, Composition sugar, and Human-in-the-loop guides for the full, reference-grade treatment.