/**
 * Copyright (c) 2026, Salesforce, Inc.,
 * All rights reserved.
 * For full license text, see the LICENSE.txt file
 */
import { type GraphQLSchema } from "graphql";
import { type ToolOutput } from "./types.js";
import { type QuerySession } from "../lib/session.js";
/**
 * Render → validate → codegen → assemble. Shared finalizer for every typed
 * intent function (`buildList`, `buildDetail`, …).
 *
 * Validation and codegen never throw — their failure modes surface as entries in
 * `warnings[]`:
 * - `Validation: <msg>` — non-schema-level errors from `graphql-js validate()`.
 * - `Validation: schema check skipped (<msg>)` — `validate()` itself crashed.
 * - `Codegen: <msg>` — `generateTypes()` threw; `types` becomes `// Type generation failed: <msg>`.
 *
 * `renderQuery`, however, CAN throw — by design. It runs before (outside) the
 * try/catch and enforces the W-23204027 render-layer fail-safe: if any emitted
 * GraphQL Name (operation/variable/field name, alias, type condition, directive
 * name) or argument key is not a valid GraphQL Name, it throws rather than emit
 * an injectable identifier. This fires only on a programmer error or a hostile
 * input that slipped past the per-builder guards (e.g. a `filter`/`orderBy` key —
 * `z.record(z.unknown())` with no charset). At the MCP boundary `runTool`
 * catches it and the message (`… is not a valid GraphQL Name`) is classified as
 * `UserInput`, so failing loud is safe there. Direct callers (e.g. an eval
 * harness) that bypass that boundary must be prepared for the throw. Do NOT move
 * `renderQuery` into the try below — that would swallow the fail-safe and let an
 * injected selection reach the output.
 *
 * Schema-level errors (e.g. "Input Object type X must define one or more fields"
 * raised by malformed UIAPI schemas, not by the user's query) are filtered out
 * per FR-9.2.
 *
 * `primingNote` (if provided) is prepended to `warnings[]` so callers can surface
 * the FR-13.3 lazy-prime notification without a separate channel. `extraWarnings`
 * are appended after schema-validation warnings — used by intent builders to
 * surface non-validator findings (e.g. malformed `$var` placeholders).
 */
export declare function buildOutput(session: QuerySession, schema: GraphQLSchema, primingNote?: string, extraWarnings?: string[]): ToolOutput;