/**
 * Copyright (c) 2026, Salesforce, Inc.,
 * All rights reserved.
 * For full license text, see the LICENSE.txt file
 */
import { type CreateSpec, type ToolOutput, type UpdateSpec } from "./types.js";
import { type PrimeDeps } from "../lib/prime-schema.js";
export type MutationOp = "Create" | "Update";
/**
 * Build a UIAPI Create/Update mutation against a Salesforce org. Shared
 * implementation for `sf_gql_create` and `sf_gql_update` (FR-5.6).
 *
 * Implicit behaviors:
 * - `returnFields` defaults to `["Id"]`.
 * - `inputVariable` defaults to `"input"`; a leading `$` is stripped.
 * - Operation name defaults to `<Op><Object>` (e.g. `CreateAccount`, `UpdateAccount`).
 * - The `input` argument on the mutation field is bound to the declared variable.
 *
 * Throws on invalid `object`/`inputVariable`/`operationName` GraphQL Names, empty
 * `returnFields`, auth-missing, or introspection failure. Never throws on
 * validation/codegen failure (those surface as `warnings[]`).
 */
export declare function buildMutation(spec: CreateSpec | UpdateSpec, op: MutationOp, deps?: PrimeDeps): Promise<ToolOutput>;