/**
 * Lightweight client for the Shortcut storage API.
 *
 * Wraps the storage endpoints used for file sync:
 * - POST /api/v1/storage/list
 * - POST /api/v1/storage/delete
 * - POST /api/v1/storage/write
 * - POST /api/v1/storage/signed-url
 * - Fetch signed URL (direct GCS download)
 */
export interface StorageEntry {
    path: string;
    size: number;
    isDir: boolean;
    updated?: string;
}
export type StorageContext = 'user' | 'team' | 'system';
export interface StorageOwnerOptions {
    teamId?: string;
}
/** List files at a GCS path recursively. */
export declare function storageList(accessToken: string, path: string, storageContext: StorageContext, options?: StorageOwnerOptions): Promise<StorageEntry[]>;
/** Download a file from GCS via signed URL. Returns raw bytes. */
export declare function downloadFile(accessToken: string, path: string, storageContext: StorageContext, options?: StorageOwnerOptions): Promise<Buffer>;
/** Upload raw bytes to GCS via a signed write URL. */
export declare function uploadFile(accessToken: string, path: string, storageContext: StorageContext, content: Buffer): Promise<void>;
/** Write UTF-8 text through the storage API. Skill manifests use this for provenance metadata. */
export declare function storageWrite(accessToken: string, path: string, storageContext: StorageContext, content: Buffer, contentType?: string, options?: StorageOwnerOptions): Promise<void>;
/** Delete a file or directory tree from storage. */
export declare function storageDelete(accessToken: string, path: string, storageContext: StorageContext, recursive?: boolean): Promise<number>;
//# sourceMappingURL=storage-client.d.ts.map