Skip to content

Persist top-level agent description - #650

Open
bhaveshpatel640 wants to merge 11 commits into
mainfrom
AGE-2120
Open

Persist top-level agent description#650
bhaveshpatel640 wants to merge 11 commits into
mainfrom
AGE-2120

Conversation

@bhaveshpatel640

@bhaveshpatel640 bhaveshpatel640 commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Persist top-level agent description


Note

Medium Risk
Requires a DB migration and a breaking API/SDK contract on create; ServiceFoundry sync behavior changes on agent create/update, with existing dual-write failure modes still possible.

Overview
Adds a required top-level description on agents (1–1024 chars, trimmed) across the public API, persistence, and generated SDK. Create must include it; update can change it optionally while still requiring a full manifest replacement.

Storage: Postgres and SQLite migrations add a non-null description column and backfill existing rows from name. Agent stores read/write description on create and patch.

ServiceFoundry: TrueFoundryAgentStore now sends the stored description on remote create/update (falling back to name when blank, capped at 1024) instead of always using the agent name.

Breaking API change: Clients must pass description on agent create; list/get responses include it. OpenAPI, docs, and @truefoundry/trueforge-sdk are regenerated accordingly. Import path sets description to the imported agent’s name.

Reviewed by Cursor Bugbot for commit 4dee7fe. Bugbot is set up for automated code reviews on this repo. Configure here.

@changeset-bot

changeset-bot Bot commented Sep 9, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 4dee7fe

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

This PR includes changesets to release 3 packages
Name Type
@truefoundry/trueforge-sdk Patch
@truefoundry/trueforge Patch
@truefoundry/trueforge-ui 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 Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale Bugbot comment from a previous run.

Comment thread .github/fern/openapi/openapi.json
cursor[bot]

This comment was marked as outdated.

Comment thread .github/fern/openapi/openapi.json

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Fix All in Cursor

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

Reviewed by Cursor Bugbot for commit 00210d3. Configure here.

Comment thread packages/trueforge/src/schemas/agent.ts
@harshil-2096
harshil-2096 added this pull request to stack #708 September 11, 2026 09:57
Comment thread packages/trueforge/tests/unit/truefoundry/TrueFoundryAgentStore.test.ts Outdated
* }
*/
export interface CreateAgentRequest {
/** Short summary of what the agent does. */

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

don't need comment here

* }
*/
export interface UpdateAgentRequest {
/** Short summary of what the agent does. */

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same here

@bhaveshpatel640
bhaveshpatel640 removed this pull request from stack #708 September 11, 2026 11:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants