import type { ClientFn } from "../types/core.js";
import type { DatasetSelector, Example } from "../types/datasets.js";
export type AppendDatasetExamplesParams = ClientFn & {
    /**
     * The dataset to append examples to
     */
    dataset: DatasetSelector;
    /**
     * The examples to append to the dataset
     */
    examples: Example[];
};
export type AppendDatasetExamplesResponse = {
    datasetId: string;
    versionId: string;
};
/**
 * Append examples to an existing dataset.
 *
 * @experimental this interface may change in the future
 *
 * @param params - The parameters for appending examples
 * @param params.client - Optional Phoenix client instance
 * @param params.dataset - The dataset to append examples to (by ID or name)
 * @param params.examples - The examples to append. Each example can include:
 *   - `input`: Required input data for the example
 *   - `output`: Optional expected output data
 *   - `metadata`: Optional metadata for the example
 *   - `splits`: Optional split assignment (string, array of strings, or null)
 *   - `spanId`: Optional OpenTelemetry span ID to link the example back to its source span
 *   - `id`: Optional stable ID for the example, used to reference or update it later
 *
 * @returns A promise that resolves to the dataset ID and version ID
 *
 * @example
 * ```ts
 * const { datasetId, versionId } = await appendDatasetExamples({
 *   dataset: { datasetName: "qa-dataset" },
 *   examples: [
 *     {
 *       input: { question: "What is deep learning?" },
 *       output: { answer: "Deep learning is..." },
 *       spanId: "span123abc" // Links to the source span
 *     },
 *     {
 *       id: "my-stable-id", // Stable ID for referencing this example later
 *       input: { question: "What is a transformer?" },
 *       output: { answer: "A transformer is..." },
 *     }
 *   ]
 * });
 * ```
 */
export declare function appendDatasetExamples({ client: _client, dataset, examples, }: AppendDatasetExamplesParams): Promise<AppendDatasetExamplesResponse>;
//# sourceMappingURL=appendDatasetExamples.d.ts.map