import type { ToolDefinition } from "./types.js";
/**
 * `GET /api/v1/repository?near=<behavior phrase>` as a tool — the bridge half
 * of roadmap SPGD-1102 ("Ask the suite map"), slice 3. The platform half
 * shipped first: `RequestedNearParam` guards the ask and `NearProbe` answers
 * it, behind the `near` block of `RepositoryOverview`, on both overview doors
 * (the singular `GET /api/v1/repository` under an `sgk_` key, the plural
 * `GET /api/v1/repositories/:id` under an agent or user key).
 *
 * == Why a SEPARATE tool, and not a parameter on `get_repository_overview`
 *
 * Every other ask on the overview is free or stored. This one is LIVE and
 * BILLED: a novel phrase costs one embedding call at the provider (a repeated
 * phrase is served from the embedding cache and buys nothing). An agent
 * calling the overview must never pay an embed by accident, and an agent
 * calling this tool has asked for nothing else — the same line
 * `near_duplicate_clusters` draws for the census, drawn here for a cost that
 * is per-call rather than per-ingest.
 *
 * == The phrase is sent trimmed, and a NUL is refused HERE
 *
 * `requireString` trims and refuses blank. The NUL refusal is the bridge's to
 * make, because the server's guard treats a NUL-containing, blank or
 * non-String `near` as NO ASK and answers the plain overview with `near:
 * null` — a 200 that would read, to an agent that sent a phrase, as an
 * answered ask. Refusing client-side keeps "asked, nothing came back" and
 * "never asked" from sharing one wire shape.
 *
 * == The response is passed through, not re-modelled
 *
 * Same rule as `near-duplicate-clusters.ts`. The `near` block's shape carries
 * distinctions the serializer spent care on — `ranked: null` (no ranking was
 * attempted: `provider_unconfigured` / `embedding_failed`) versus `ranked: []`
 * (the search ran and found nothing near), and, inside the latter,
 * `identity_count: 0` versus `identity_count > 0` with
 * `best_below_floor_similarity`. Coalescing any of them would turn three
 * different silences into one. The body goes back as it arrived.
 */
declare const findTestsNearBehavior: ToolDefinition;
export default findTestsNearBehavior;