/**
 * Copyright (c) 2026, Salesforce, Inc.,
 * All rights reserved.
 * For full license text, see the LICENSE.txt file
 */
import { type RawSpec, type ToolOutput } from "./types.js";
import { type PrimeDeps } from "../lib/prime-schema.js";
/**
 * Build an arbitrary UIAPI operation from CLI-style commands. Implements
 * `sf_gql_raw` — the low-level escape hatch (FR-12) for operations the typed
 * tools do not model (cross-union selections, custom mutations).
 *
 * `operation` selects the session root (query/mutation/aggregate); the agent
 * hand-drives every selection. No typed-tool sugar (no aggregations[] handling,
 * no auto-pagination, no Id defaulting).
 *
 * Fails fast: the first command that cannot be applied throws
 * `command <i> (<cmd>): <why>`. Throws on an invalid `typeName` (must be a valid
 * GraphQL Name), auth-missing / introspection failure (via getSchemaWithPriming)
 * and on empty `commands`. Never throws on validation or codegen failure (those
 * surface as warnings[]).
 */
export declare function buildRaw(spec: RawSpec, deps?: PrimeDeps): Promise<ToolOutput>;