Architecture

Architecture

TinyAgents separates the provider-neutral agent loop from host policy and product integration. The workspace packages are:

Package	Responsibility
tinyagents-harness	Model calls, tool execution, middleware, runtime context, events, and provider adapters.
tinyagents-harness-tools	Reusable tools such as goals, todos, skills, and sub-agent controls.
tinyagents-registry	Named model, tool, agent, and capability catalogs.
tinyagents-session	Durable transcripts, thread history, and run records.
tinyagents-runtime	Host-neutral stateful turns built on the harness.
tinyagents-orchestration	Detached sub-agent invocation, durable job lifecycle, and steering.
tinyagents-definition	Host-owned agent definition vocabulary.

The host selects the model and tools, supplies storage and credentials, and applies authorization and execution policy. The harness runs each model/tool turn and reports typed events. The session package stores history; the orchestration package composes child agents without owning host policy.

See the Harness, Registry, and Development pages for package details.