agentkit.prompts

Versioned Prompt value type and the built-in prompts used by shipped cognitions.

See the Prompts concept for the mental model.

agentkit.prompts — the prompt-management skeleton.

The framework defines WHAT a prompt is. Applications own storage, discovery, resolution, and any validation/evaluation contracts they choose to add — those don't belong in the framework's public surface unless the framework actually dispatches them.

The skeleton: - Prompt (data type) — id + version + template + render() - builtin — the framework's own seed prompts (Compactor)

Why no validator/evaluator skeleton: exporting Validator / PromptEvaluator type aliases the framework never dispatches would imply a runtime validation surface that doesn't exist. The Agent's parse-and-repair uses its own SchemaAdapter path. Apps that need that pattern ship their own shapes.

Why no store/registry/resolver: prompts are code (defined as constants, version-controlled in git). Apps that need runtime mutation, dynamic loading, or a UI to inspect prompt history ship their own infrastructure on top of this skeleton.

Prompt dataclass

Prompt(
    id: str,
    version: str,
    template: str,
    inputs: tuple[str, ...] = tuple(),
)

A versioned system prompt. The version label travels with every output the prompt produces (stamped via RequestBuilder onto AgentResult + traces), so a regression in quality maps back to a specific template version.