Skip to content

docs/UX: search limit hard-capped at 100 — over-limit reads as empty results, not an error #308

@silversurfer562

Description

@silversurfer562

Summary

The search limit parameter is hard-capped at 100, and exceeding it fails as a Pydantic validation error rather than clamping — from the client's side the call simply returns nothing useful, which reads as "no results," not "bad request."

How it bit us

A recall path over-fetched a candidate pool (limit = k * 10) for client-side dedup. It worked for k <= 10 and silently returned [] for k >= 11 — shipped that way, caught only when a later consumer used a bigger k (fixed in Smart-AI-Memory/attune-ai#666 by clamping to 100 client-side).

Ask

  • Document the cap on limit (client + REST docs).
  • Consider either clamping server-side or surfacing the validation error in a way the client can't mistake for an empty result set.

Server + client 0.14.0. Happy to PR a docs note.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions