---
schema_version: "newruntime-agent-readable-v0.1"
type: "raw_signal"
id: "tg-2559"
slug: "pydantic-ai-capabilities-progressive-disclosure"
title: "Pydantic AI loads capabilities only when needed"
description: "A capability can bundle instructions, tools, model settings, and hooks while exposing only a compact description until activation."
observed_at: "2026-06-28"
why_it_matters: "Progressive disclosure limits context cost and instruction interference while giving complex agents a typed, stateful capability lifecycle."
novelty: "notable"
verification_level: "source-inspected"
signal_type: "field-report"
evidence_kind: "mixed"
status: "published"
telegram_message_id: 2559
telegram_url: "https://t.me/qwgai/2559"
topics: ["agent-skills","context-engineering","tool-use"]
entities: ["Pydantic AI"]
related_patterns: []
source_urls: ["https://github.com/pydantic/pydantic-ai","https://pydantic.dev/articles/pydantic-ai-capabilities"]
import_batch: "telegram-2026-07-17-v1"
routes: {"html":"https://newruntime.com/signals/pydantic-ai-capabilities-progressive-disclosure/","markdown":"https://newruntime.com/signals/pydantic-ai-capabilities-progressive-disclosure.md","json":"https://newruntime.com/signals/pydantic-ai-capabilities-progressive-disclosure.json"}
source_format: "telegram-export-normalized-json"
---

# Pydantic AI loads capabilities only when needed

## Observation

A capability can bundle instructions, tools, model settings, and hooks while exposing only a compact description until activation.

## Why it matters

Progressive disclosure limits context cost and instruction interference while giving complex agents a typed, stateful capability lifecycle.

## Provenance

Normalized from QWG AI Telegram message 2559. The original Russian-language record remains available at https://t.me/qwgai/2559.