import { DatasetContract, DatasetOptions } from "./dataset.type.mjs";

//#region ../ai/src/eval/dataset.d.ts
/**
 * Create an immutable evaluation dataset that feeds `agent.eval({ cases })`
 * directly.
 *
 * **Role.** A taggable, filterable, shardable wrapper around a list of
 * {@link DatasetEntry} rows. `agent.eval` accepts a `DatasetContract` in
 * place of a raw `EvalCase[]`, reading `.cases` off it.
 *
 * Sources (combinable — file entries append after inline `cases`):
 * - `cases` → inline entries.
 * - `fromFile` → a JSONL file read once, synchronously, at construction
 *   (one JSON object per line). A malformed line throws an
 *   `InvalidRequestError` naming the 1-based line number.
 *
 * @example
 * const ds = dataset({ name: "support", fromFile: "./eval/support.jsonl" });
 * const smoke = ds.filter((entry) => entry.tags?.includes("smoke"));
 * const shard = ds.shard(0, 4); // first of four parallel CI shards
 *
 * const report = await agent.eval({ cases: ds, scorers: [contains()] });
 */
declare function dataset<TOutput = unknown>(options: DatasetOptions<TOutput>): DatasetContract<TOutput>;
//#endregion
export { dataset };
//# sourceMappingURL=dataset.d.mts.map