[kid7st]

Part of #894: author-written conversation starters and the program's name for clients. The avatar from that issue is not included.

Behavior

info() gains an agent group; name stays the instance's name.

{
  name,                                       // the instance's name (one path segment)
  agent: { name, description?, starters? },   // how the agent presents itself
  commands, tools, models, defaultModel
}

• agent.name is the program's name: package.json's name, else the directory's. It is always present.
• agent.description is the instance's description, else package.json's description.
• agent.starters are example first messages. A client may put one in a composer as an editable draft; reading or choosing one never sends anything.

Where each value is written:

	package.json	fastagent.config.ts	fastagent.json
name	the program's name	removed	the instance's name (unchanged)
description	the program's description	removed	optional, replaces it for this instance
starters	none	defaults.starters	optional, overrides the default

starters and description are validated by the instance configuration's JSON Schema (at most 6 starters of at most 200 characters, none blank), so the program's defaults and fastagent.json share one check, and fastagent build publishes it for editors. Sources are recorded like any other value.

fastagent info prints the program's name (when it differs from the instance's), the description and the starters, and --json adds agent with the same three values.

The definition now carries description from package.json, and fastagent build writes it into the generated entry beside name and version.

Breaking changes

No compatibility layer, per the maintenance policy.

• info().description is now info().agent.description (SPEC.md §3).
• AgentConfig.name is removed: it changed definition.name but not dist/package.json's name, so the two could disagree. Set the name in package.json.
• description is no longer a fastagent.config.ts key; both now fail as unknown key.

Verification

npm run lint, npm run typecheck, npm test (195 files, 2387 tests). New tests: in-process and HTTP conformance of info().agent, the package.json to info() wiring with an instance override, the resolved config's sources, and refusals of invalid description and starters.

Known limitations

• An already built dist/ that sets name in its config still opens, since a built config is not re-checked.
• No avatar.