import { z } from 'zod';
import { FailureSchema } from './output-schemas.js';
import { ToolName } from './tool-names.js';
type BatchFailure = z.infer<typeof FailureSchema>;
/**
 * Records the items a batch tool could not act on.
 *
 * These failures are reported in the tool result rather than thrown, so the
 * server answers 200 and logs nothing while the caller's items stay untouched.
 * A whole batch can fail on an expired token or a dropped connection with no
 * trace on this side, which leaves nothing to diagnose from afterwards.
 *
 * @param toolName - The tool that ran the batch, for the log prefix.
 * @param total - How many items the caller asked for.
 * @param failures - The items that failed, as reported in the result.
 * @param options.redactItems - Set where `item` is the caller's own text rather
 * than an identifier, e.g. a task title. That text can carry personal data and
 * must not reach server logs; the error and its code carry the diagnosis anyway.
 */
export declare function logBatchFailures(toolName: ToolName, total: number, failures: ReadonlyArray<BatchFailure>, options?: {
    redactItems?: boolean;
}): void;
export {};
//# sourceMappingURL=batch-failures.d.ts.map