const client = new CastariClient({ apiKey: '...' });
const files = client.files;

const result = await client.files.upload(file, filename, options?);

const file = new Blob(['Hello, world!'], { type: 'text/plain' });
const result = await client.files.upload(file, 'hello.txt', {
  description: 'Greeting file',
  tags: ['example'],
});
console.log(result.file_id);

const result = await client.files.list(options?);

const file = await client.files.get(fileId);

const file = await client.files.update(fileId, options);

await client.files.delete(fileId);

const response = await client.files.download(fileId);

const usage = await client.files.getUsage();

const usage = await client.files.getUsage();
console.log(`${usage.total_files} files, ${usage.total_mb} MB used (${usage.usage_percent}%)`);

interface StorageUsage {
  total_files: number;
  total_bytes: number;
  total_mb: number;
  limit_mb: number;
  usage_percent: number;
}

const presigned = await client.files.getUploadUrl(filename, sizeBytes, options?);

const file = await client.files.confirmUpload(fileId, sha256Hash);

const agentFile = await client.files.attachToAgent(agentSlug, options);

const result = await client.files.listAgentFiles(agentSlug);

await client.files.detachFromAgent(agentSlug, fileId);