feat: add pagination and server side search to list agents

[sr07asthana]

Summary

Closes #

Changes

How was this tested?

Checklist

• I have read the contributing guidelines
• pnpm build, pnpm test, pnpm typecheck, pnpm lint:ci, and pnpm format:check pass locally
• Tests added/updated where it makes sense
• No hand-edits to generated code (packages/trueforge-sdk, .github/fern/openapi/openapi.json, docs/openapi.json) — fork PRs omit SDK regen; maintainers regenerate after merge
• Docs / .env.example updated if configuration or behavior changed

---

Note

Medium Risk
Breaking change for API/SDK consumers (pagination required, list return type). Pagination and auth-scoped listing touch core agent registry paths; invalid tokens are rejected with 400.

Overview
GET /api/v1/agents is now token-paginated (default limit 25, max 25) with a required pagination envelope on ListAgentsResponse, plus optional agent_name substring filtering and 400 on bad tokens. Postgres/SQLite agent stores and listAccessibleAgents return { data, pagination } using offset-based page tokens.

The SDK agents.list accepts ListAgentsRequest and returns a Page (with BadRequestError on 400). OpenAPI/docs/changeset are updated accordingly.

The Agents library drops infinite scroll for prev/next rows-per-page via useSearchAgentsList paged mode and TableTokenPagination. The harness adapter walks SDK pages (listAgentsPage / drainAgentsList) to honor UI offset/limit; name search in the library is still client-side on each fetched page (the new agent_name query param is not wired through searchAgents yet). Default list page size moves from 50 → 25.

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

[changeset-bot]

🦋 Changeset detected

Latest commit: 359e637

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	Patch
@truefoundry/trueforge-ui	Patch
@truefoundry/trueforge-sdk	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]

Stale Bugbot comment from a previous run.

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 2 potential issues.

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

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

[cursor]

Full last page enables Next

Medium Severity

Paged mode treats a full page (rows.length >= limit) as another page, but listAgentsPage drops the SDK hasNextPage signal. When the last page is exactly full, Next stays enabled and opens an empty “No Agents Found” page.

Additional Locations (2)

• packages/trueforge-ui/src/atoms/lib/useSearchAgentsList.ts#L237-L239
• packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/agentsList.ts#L27-L35

 

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