import { APIResource } from "../../core/resource.mjs";
import * as AgentsAPI from "./agents.mjs";
import * as ArchivesAPI from "../archives/archives.mjs";
import * as ModelsAPI from "../models/models.mjs";
import { APIPromise } from "../../core/api-promise.mjs";
import { ArrayPage, type ArrayPageParams, PagePromise } from "../../core/pagination.mjs";
import { RequestOptions } from "../../internal/request-options.mjs";
export declare class Folders extends APIResource {
    /**
     * Get the folders associated with an agent.
     */
    list(agentID: string, query?: FolderListParams | null | undefined, options?: RequestOptions): PagePromise<FolderListResponsesArrayPage, FolderListResponse>;
    /**
     * Attach a folder to an agent.
     */
    attach(folderID: string, params: FolderAttachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState | null>;
    /**
     * Detach a folder from an agent.
     */
    detach(folderID: string, params: FolderDetachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState | null>;
}
export type FolderListResponsesArrayPage = ArrayPage<FolderListResponse>;
/**
 * (Deprecated: Use Folder) Representation of a source, which is a collection of
 * files and passages.
 */
export interface FolderListResponse {
    /**
     * The human-friendly ID of the Source
     */
    id: string;
    /**
     * The embedding configuration used by the source.
     */
    embedding_config: ModelsAPI.EmbeddingConfig;
    /**
     * The name of the source.
     */
    name: string;
    /**
     * The timestamp when the source was created.
     */
    created_at?: string | null;
    /**
     * The id of the user that made this Tool.
     */
    created_by_id?: string | null;
    /**
     * The description of the source.
     */
    description?: string | null;
    /**
     * Instructions for how to use the source.
     */
    instructions?: string | null;
    /**
     * The id of the user that made this Tool.
     */
    last_updated_by_id?: string | null;
    /**
     * Metadata associated with the source.
     */
    metadata?: {
        [key: string]: unknown;
    } | null;
    /**
     * The timestamp when the source was last updated.
     */
    updated_at?: string | null;
    /**
     * The vector database provider used for this source's passages
     */
    vector_db_provider?: ArchivesAPI.VectorDBProvider;
}
export interface FolderListParams extends ArrayPageParams {
}
export interface FolderAttachParams {
    /**
     * The ID of the agent in the format 'agent-<uuid4>'
     */
    agent_id: string;
}
export interface FolderDetachParams {
    /**
     * The ID of the agent in the format 'agent-<uuid4>'
     */
    agent_id: string;
}
export declare namespace Folders {
    export { type FolderListResponse as FolderListResponse, type FolderListResponsesArrayPage as FolderListResponsesArrayPage, type FolderListParams as FolderListParams, type FolderAttachParams as FolderAttachParams, type FolderDetachParams as FolderDetachParams, };
}
//# sourceMappingURL=folders.d.mts.map