import type { Files } from "../index.js";
import type { ApprovalConfig } from "../internal/ai-tools/approval.js";
import type { FileReadToolName, FileToolName, FileWriteToolName } from "../internal/ai-tools/schemas.js";
import type { AgentsToolOverrides } from "./types.js";
export declare const agentsListFiles: (files: Files) => import("@openai/agents-core").FunctionTool<unknown, import("zod").ZodObject<{
    cursor: import("zod").ZodOptional<import("zod").ZodString>;
    limit: import("zod").ZodOptional<import("zod").ZodNumber>;
    prefix: import("zod").ZodOptional<import("zod").ZodString>;
}, import("zod/v4/core").$strip>, string>;
export declare const agentsGetFileMetadata: (files: Files) => import("@openai/agents-core").FunctionTool<unknown, import("zod").ZodObject<{
    key: import("zod").ZodString;
}, import("zod/v4/core").$strip>, string>;
export declare const agentsDownloadFile: (files: Files) => import("@openai/agents-core").FunctionTool<unknown, import("zod").ZodObject<{
    binary: import("zod").ZodOptional<import("zod").ZodBoolean>;
    key: import("zod").ZodString;
    maxBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
}, import("zod/v4/core").$strip>, string>;
export declare const agentsGetFileUrl: (files: Files) => import("@openai/agents-core").FunctionTool<unknown, import("zod").ZodObject<{
    expiresIn: import("zod").ZodOptional<import("zod").ZodNumber>;
    key: import("zod").ZodString;
    responseContentDisposition: import("zod").ZodOptional<import("zod").ZodString>;
}, import("zod/v4/core").$strip>, string>;
export declare const agentsUploadFile: (files: Files, { needsApproval }?: {
    needsApproval?: boolean;
}) => import("@openai/agents-core").FunctionTool<unknown, import("zod").ZodObject<{
    cacheControl: import("zod").ZodOptional<import("zod").ZodString>;
    content: import("zod").ZodString;
    contentType: import("zod").ZodOptional<import("zod").ZodString>;
    encoding: import("zod").ZodOptional<import("zod").ZodEnum<{
        base64: "base64";
        text: "text";
    }>>;
    key: import("zod").ZodString;
    metadata: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
}, import("zod/v4/core").$strip>, string>;
export declare const agentsDeleteFile: (files: Files, { needsApproval }?: {
    needsApproval?: boolean;
}) => import("@openai/agents-core").FunctionTool<unknown, import("zod").ZodObject<{
    key: import("zod").ZodString;
}, import("zod/v4/core").$strip>, string>;
export declare const agentsCopyFile: (files: Files, { needsApproval }?: {
    needsApproval?: boolean;
}) => import("@openai/agents-core").FunctionTool<unknown, import("zod").ZodObject<{
    from: import("zod").ZodString;
    to: import("zod").ZodString;
}, import("zod/v4/core").$strip>, string>;
export declare const agentsSignUploadUrl: (files: Files, { needsApproval }?: {
    needsApproval?: boolean;
}) => import("@openai/agents-core").FunctionTool<unknown, import("zod").ZodObject<{
    contentType: import("zod").ZodOptional<import("zod").ZodString>;
    expiresIn: import("zod").ZodNumber;
    key: import("zod").ZodString;
    maxSize: import("zod").ZodOptional<import("zod").ZodNumber>;
    minSize: import("zod").ZodOptional<import("zod").ZodNumber>;
}, import("zod/v4/core").$strip>, string>;
export interface AgentsFileTools {
    listFiles: ReturnType<typeof agentsListFiles>;
    getFileMetadata: ReturnType<typeof agentsGetFileMetadata>;
    downloadFile: ReturnType<typeof agentsDownloadFile>;
    getFileUrl: ReturnType<typeof agentsGetFileUrl>;
    uploadFile: ReturnType<typeof agentsUploadFile>;
    deleteFile: ReturnType<typeof agentsDeleteFile>;
    copyFile: ReturnType<typeof agentsCopyFile>;
    signUploadUrl: ReturnType<typeof agentsSignUploadUrl>;
}
export type ReadOnlyAgentsFileTools = Pick<AgentsFileTools, FileReadToolName>;
export interface AgentsFileToolsOptions {
    /**
     * The configured `Files` instance the tools will operate against.
     */
    files: Files;
    /**
     * When `true`, write tools (`uploadFile`, `deleteFile`, `copyFile`,
     * `signUploadUrl`) are omitted entirely. The model cannot mutate the
     * bucket regardless of approval configuration.
     */
    readOnly?: boolean;
    /**
     * Approval gating for write tools. Defaults to `true` (every write
     * requires approval). Pass `false` to disable, or an object keyed
     * by write-tool name for fine-grained control.
     */
    requireApproval?: ApprovalConfig;
    /**
     * Per-tool overrides for `description` and `needsApproval` without
     * touching `execute` or `parameters`.
     */
    overrides?: Partial<Record<FileToolName, AgentsToolOverrides>>;
}
/**
 * Create a set of files-sdk tools shaped for the OpenAI Agents SDK
 * (`@openai/agents`).
 *
 * Returns a record keyed by tool name — spread `Object.values()` into
 * `new Agent({ tools })`. Write tools require approval by default; the
 * Agents SDK surfaces an `interruption` that the program resolves by
 * approving or rejecting the call.
 *
 * @example
 * ```ts
 * import { Agent, run } from "@openai/agents";
 * import { Files } from "files-sdk";
 * import { s3 } from "files-sdk/s3";
 * import { createAgentsFileTools } from "files-sdk/openai";
 *
 * const files = new Files({ adapter: s3({ bucket: "uploads" }) });
 * const tools = createAgentsFileTools({ files });
 *
 * const agent = new Agent({
 *   instructions: "Help the user manage their files.",
 *   name: "Files agent",
 *   tools: Object.values(tools),
 * });
 *
 * const result = await run(agent, "List my files.");
 * ```
 */
export declare function createAgentsFileTools(opts: AgentsFileToolsOptions & {
    readOnly: true;
}): ReadOnlyAgentsFileTools;
export declare function createAgentsFileTools(opts: AgentsFileToolsOptions & {
    readOnly?: false | undefined;
}): AgentsFileTools;
export declare function createAgentsFileTools(opts: AgentsFileToolsOptions): AgentsFileTools | ReadOnlyAgentsFileTools;
export type { FileReadToolName, FileToolName, FileWriteToolName };
//# sourceMappingURL=agents.d.ts.map