Bucket

A tool ref to some of its operations, for tools: "objects", "head", "put" (store a file from a url or from text, so the model never handles bytes), "signed_url" (a link that reads a file) and "remove". The bucket itself in tools gives all five, as {name}__objects and so on; policy names them bucket.objects, bucket.put, ... (bucket.*).

Create a bucket, unique by name per user (a taken name throws Conflict with existingId).

A lazy reference to the bucket called name for the current (or given) user. With createIfMissing it's created on first use; one that exists is used as it is.

A lazy reference to a bucket by id.

Load a bucket by id now; an unknown id raises noclick.NotFound.

The current user's buckets (or those userFilter covers).

One page of buckets; pass nextCursor back as cursor.

Store data at key, replacing what was there (up to 100 MB; larger files go through a PUT signed link).

The file's bytes; a missing key throws NotFound.

A file's size, type, etag and metadata, without downloading it.

The files under prefix, in key order (or the first limit), fetched page by page.

One page of objects; pass nextCursor back as cursor.

Delete the file at key (a key that isn't there is fine).

What key held before each write through NoClick of the last 30 days, newest first.

Put key back as version held it; what it holds now is kept as a version in turn.

A link that reads (GET) or uploads (PUT) the file without a NoClick key, until it expires.

The plain URL a public bucket serves key at; a private bucket throws NotAvailable.

Change the bucket's settings; making it private stops every public URL at once.

Invite-only beta.

Put a message on queue (a Queue or its name, in the bucket's own user) for every file stored under prefix (the whole bucket when omitted), however it arrived: put, a PUT signed link or S3 credentials. The message is { event: "put", bucket, key, size, content_type, etag, at }. Asking again for the same queue and prefix changes nothing; enabled: false stops it.

await recordings.notify("new-recordings", { prefix: "calls/" });

Invite-only beta. Keys for the S3-compatible endpoint, valid ttlS seconds (900 to 43,200; 3600 by default).

Export every file, to take anywhere: a zip holding each one at its key (under buckets/<name>/files/), with index.jsonl listing each key's content type and metadata. A key that can't be a path in a zip (an empty, . or .. part) is kept under renamed/, and the index says which. wait() resolves to an ExportBundle: the zip at url, valid 7 days.

Delete the bucket: it goes to the trash, restorable for 30 days (its files stored, and billed, until it's purged). It must be empty unless force (which takes its files too), and in no agent's tools. Returns its TrashItem.