resources

Overview ¶

profiles/resources shows the resource half of the profile vocabulary: not only *where* the provider profile lives, but *what must exist inside it*.

One import (profile/) covers both questions:

adaptor.WithProfile(profile.CloneNative(dir, profile.LinkAuth()))  // where
adaptor.WithProfileResources(profile.Resources{...})               // what

WithProfile is construction scope only — the profile is part of what the Agent *is* and participates in the session fingerprint. WithProfileResources is a SharedOption, so the same value seeds the agent and can be swapped for a single Run. Merge rules per resource kind:

Skills        append   (the one append-merged family)
MCP           replaces when non-nil
Agents/Hooks/Config  replace and declare when non-nil (empty slice = "none")
Instructions  replaces and declares when non-nil

ProfileState/SyncProfile report desired-vs-observed truthfully: a driver that cannot materialize a resource says so instead of pretending.

Usage:

go run ./examples/profiles/resources -agent=codex