import type { WorkspaceManagementTypes } from "@cargo-ai/types";
import { type Token } from "../core.js";
import { type FolderRef } from "../refs.js";
export type FolderKind = WorkspaceManagementTypes.FolderKind;
export type FolderHandle = {
    readonly slug: string;
    readonly uuid: Token;
    readonly kind: FolderKind;
    readonly resource: "folder";
};
export type FolderSpec = {
    /** Which kind of resource this folder holds (model, agent, play, …). */
    kind: FolderKind;
    name?: string;
    emojiSlug?: string;
    /** Parent folder, for nesting — a folder handle or a `folderRef(uuid)`. */
    parent?: FolderHandle | FolderRef;
};
export declare function defineFolder(slug: string, spec: FolderSpec): FolderHandle;
//# sourceMappingURL=folder.d.ts.map