fix(agent-bff): derive a primary key when the schema declares none

[Tonours]

Stacked on #1894, which merges first. Review only the last commit; the parent's diff belongs to that PR.

What

A collection whose schema declares no primary key gets one derived from its id field.

Why

forest_liana publishes isPrimaryKey only from 9.17.6 (2026-06-04). Below that line every collection is keyless, so unpackPrimaryKey rejects every record the agent returns and a plain list answers 500 mapping_error. Of the 125 forest-rails environments active in the last 120 days, the twenty oldest run between 2.14.6 and 8.3.2, several of them production.

How

buildPrimaryKeys falls back to a field literally named id, typed as the schema declares it, String when no such field exists. Keyed on the shape of the schema rather than the liana version: a collection that declares a key keeps it, and every v2 agent declares one, so this only fires where the alternative is a 500.

How to test

yarn workspace @forestadmin/agent-bff test. Three unit tests cover the declared-key, derived-key and no-id-field cases.

Definition of Done

General

• Write an explicit title for the Pull Request, following Conventional Commits specification
• Test manually the implemented changes
• Validate the code quality (indentation, syntax, style, simplicity, readability)

Security

• Consider the security impact of the changes made

[qltysh]

Coverage Impact

This PR will not change total coverage.

Modified Files with Diff Coverage (19)

Rating	File	% Diff	Uncovered Line #s
	packages/agent-bff/src/read-model/forest-schema-client.ts	100.0%
	packages/agent-bff/src/read-model/read-model.ts	100.0%
	packages/agent-bff/src/openapi/unfolded-paths.ts	100.0%
	packages/agent-bff/src/context/build-context.ts	100.0%
	packages/agent-bff/src/read-model/schema-cache.ts	100.0%
	packages/agent-bff/src/read-model/agent-capabilities-fetcher.ts	100.0%
	packages/agent-bff/src/openapi/collect-unfolding.ts	100.0%
	packages/agent-bff/src/validation/operator-normalizer.ts	100.0%
	packages/agent-bff/src/data/pack-id.ts	100.0%
	packages/agent-bff/src/data/agent-query.ts	100.0%
	packages/agent-bff/src/validation/validation-errors.ts	100.0%
	packages/agent-bff/src/read-model/read-model-store.ts	100.0%
	packages/agent-bff/src/validation/capabilities-validator.ts	100.0%
	packages/agent-client/src/filter-wire-format.ts	100.0%
	packages/agent-bff/src/read-model/synthesize-capabilities.ts	100.0%
	packages/agent-client/src/query-serializer.ts	100.0%
	packages/forestadmin-client/src/schema/index.ts	100.0%
	packages/agent-client/src/index.ts	100.0%
	packages/forestadmin-client/src/permissions/forest-http-api.ts	100.0%
	Total	100.0%

🚦 See full report on Qlty Cloud »

🛟 Help

• Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.

• Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.

• File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)

  • Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.

[nbouliol]

Spec (no ticket): no Linear ticket is linked to this PR, so the functional check was limited to the PR description, which the diff matches.

[qltysh]

2 new issues

Tool	Category	Rule	Count
qlty	Structure	Function with many returns (count = 4): filterSchema	1
qlty	Structure	Function with high complexity (count = 11): createAgentCapabilitiesFetcher	1

[nbouliol]

Spec (no ticket): no Linear ticket is linked to this PR, so the functional check was limited to the PR description, which the diff matches.

[nbouliol]

Approving on the review side: the seven findings from the validator run at 59ef8a1a are all closed and verified at 3797d1ee, each with the property that closes its class and a regression pinned where a test applies.

Two things this approval does not clear:

• #1894 is still open, and this PR is based on its branch, so it cannot merge first.
• LLM Integration Tests (ai-proxy) is red. Unrelated to this diff, but it is red.