Persist top-level agent description

[bhaveshpatel640]

Persist top-level agent description

---

Note

Medium Risk
Adds a required API field and DB migration with ServiceFoundry sync changes on create/update; backward-compatible for clients via defaults and backfill, but remote sync behavior changes when description is set.

Overview
Adds a top-level description on agents (up to 1024 characters, trimmed on create) alongside name and manifest. Create accepts an optional description (defaults to empty); update can change it without resending description when only the manifest changes. Responses and the SDK/OpenAPI types now include description as a required field on Agent.

Storage and migration: Postgres and SQLite gain a non-null description column; existing rows are backfilled from name. Agent stores read/write the column on create and patch update.

ServiceFoundry sync: TrueFoundryAgentStore sends the stored description on remote create/update (falling back to name when blank, capped at 1024 chars) instead of always using the agent name. Description-only or manifest+description updates trigger the same remote sync path as manifest-only updates did before.

Agent update API docs are broadened from “replaces manifest only” to general agent update wording.

^{Reviewed by Cursor Bugbot for commit 44d165f. Bugbot is set up for automated code reviews on this repo. Configure here.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 44d165f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@truefoundry/trueforge	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 6a11cf2. Configure here.}