@omelhorsite/sdk 0.3.0 → 0.4.1

package/dist/types/resources/storage.d.ts

@@ -1,48 +1,47 @@
 /**
  * The `storage` namespace: the virtual filesystem.
  *
- * A node is a file or a directory, identified by an opaque id. Since the ltree
- * migration the id IS the address: there is no `path` column any more, and
- * navigation goes parent id -> children, with `ancestors()` for a breadcrumb.
- * Never build or parse a path string.
+ * A node is a file or a directory, identified by an opaque id. The id IS the
+ * address: a node carries no path, and navigation goes parent id -> children,
+ * with `ancestors()` for a breadcrumb. Never build or parse a path string.
  *
  * {@link StorageNamespace.resolvePath} exists for humans typing `docs/a.pdf`,
  * and it is exactly what it looks like: one request per segment, walking
- * `name` + `parent_id` down the filtered index. It memoises what it learns per
- * client instance so a CLI session does not re-walk the same prefix, but the
- * cheap call is always the one that already has an id.
+ * `name` + `parent_id` down a filtered listing. It memoises what it learns per
+ * client instance so a second walk down the same prefix is free, but the cheap
+ * call is always the one that already has an id.
  *
  * Uploads do NOT stream through this namespace. Bytes go straight to object
- * storage with a presigned URL; Rails only mints the plan and, at the end,
+ * storage with a presigned URL; the API only mints the plan and, at the end,
  * binds the blob. That whole dance lives in `storage/upload.ts` and is reached
  * through {@link StorageNamespace.upload}.
  *
- * Four throttles bound what this namespace can do, and they are far tighter
+ * Three rate limits bound what this namespace can do, and two are far tighter
  * than the API's general ceiling:
  *
- * - `fs_upload` - 300/min for the whole upload control plane. Paced by
+ * - 300 requests a minute for the whole upload control plane. Paced by
  *   {@link UploadManager}.
- * - `fs_bulk_job` - TWELVE a minute for `copy`, `createDirectories`,
- *   `emptyTrash` and `trash` together. Paced by {@link StorageNamespace.bulkGate}.
- * - the general 600/min for everything else.
- * - the direct PUTs at the object store, which rack-attack never sees at all.
+ * - TWELVE a minute for `copy`, `createDirectories`, `emptyTrash` and `trash`
+ *   together. Paced by {@link StorageNamespace.bulkGate}.
+ * - the general 600 a minute for everything else.
+ *
+ * The direct PUTs at the object store are not rate limited by the API.
  */
 /**
  * The server's null sentinel: U+0008, a literal backspace.
  *
- * `CrudActions` rewrites any filter value equal to it before the query layer
- * ever sees it - `transform_values! { |v| v == "\b" ? nil : v }`, applied to
- * every option bag, not just to `exact_search`. Through `exact_search` that is
- * exactly what is wanted: `where(parent_id: nil)`, the root nodes.
+ * The server reads any filter value equal to it as `null`, in every option
+ * bag. Through `exact_search[parent_id]` that is exactly what is wanted: the
+ * nodes with no parent, i.e. the roots.
  *
- * Through `extra_options` the same rewrite is a trap, because
- * `QueryExtraOptions::FsNodes` opens with
- * `return unless params[:parent_id].present?` and `nil` is not present, so the
- * filter is dropped without a word. {@link StorageNamespace.list} is built
- * around that difference; do not collapse the two filters back together.
+ * Through `extra_options[parent_id]` the same value is a trap: a `null` there
+ * counts as no filter at all, and the filter is dropped without a word.
+ * {@link StorageNamespace.list} is built around that difference; do not
+ * collapse the two filters back together.
  */
 import { type ApiClient, Resource } from "../http";
-import type { BaseRecord, FileOutput, Id, OperationOptions, Paginated, PageParams, RequestOptions } from "../types";
+import type { ListParams } from "../listing";
+import type { BaseRecord, FileOutput, Id, OperationOptions, Paginated, RequestOptions } from "../types";
 import type { User } from "./account";
 import { StorageRateGate, UploadManager } from "./storage/upload";
 import type { UploadInput } from "./storage/upload";
@@ -51,27 +50,14 @@ export type FsNodeKind = "file" | "directory";
 /**
  * A node in the virtual filesystem.
  *
- * This is the WHOLE record, and it was checked against the blueprint CHAIN
- * rather than against the table, because those two disagree.
- * `FsNodeBlueprint` declares `name`, `parent_id`, `kind`, `size`,
- * `max_size`; it extends `ApplicationBlueprint`, which contributes `id`,
- * `created_at` and `updated_at`; and its `:extended` view has an EMPTY body,
- * which in Blueprinter inherits the base fields rather than emitting nothing.
- * So `list`, `get`, `create` and `update` all answer the same eight fields.
- * Reading a view name and assuming it adds something has already produced bugs
- * in this repo - follow the `<` before deciding a field does or does not exist.
- *
- * The `fs_nodes` TABLE is wider than that, and the difference is never sent:
- * `creator_id`, `updater_id`, `destroyer_id`, `signed_url_generated`,
- * `is_vault_root` and the `id_path` ltree are all real columns that appear in
- * no view. Declaring them client-side is worse than leaving them out, because
- * every later reader then believes they arrive.
+ * This is the WHOLE record: `list`, `get`, `create` and `update` all answer
+ * the same eight fields.
  *
- * There is no `data` and no `url` field either: bytes are reached through
+ * There is no `data` and no `url` field: bytes are reached through
  * {@link StorageNamespace.download}, {@link StorageNamespace.downloadStream} or
  * {@link StorageNamespace.downloadUrl}, never off the record. And no
  * `content_type` and no `path` - the type is decided from the name at download
- * time, and the `path` column was dropped in the ltree migration.
+ * time, and a node is addressed by id.
  */
 export interface FsNode extends BaseRecord {
     readonly name: string;
@@ -100,10 +86,8 @@ export interface FsRoots {
  * A bulk operation the server runs in the background.
  *
  * `copy`, `createDirectories`, `trash` and `emptyTrash` all answer with nothing
- * but a job id: the work happens in a worker and the response says only that it
- * was enqueued. Poll it with `oms.jobs.wait(jobId)`; this namespace has no
- * access to the jobs namespace and deliberately does not grow a second polling
- * loop.
+ * but a job id: the response says only that the work was enqueued. Poll it
+ * with `oms.jobs.wait(jobId)`.
  */
 export interface FsBulkJob {
     /** Feed this to `oms.jobs.get` / `oms.jobs.wait`. */
@@ -124,13 +108,27 @@ export interface FsStream {
     /** Byte length when the server sent one. Always `undefined` for a zip. */
     readonly size: number | undefined;
 }
+/** Filter columns of `GET /fs_nodes`. */
+export declare const FS_NODE_FILTER_COLUMNS: readonly ["id", "created_at", "updated_at", "name", "parent_id"];
+/** `extra_options` keys of `GET /fs_nodes`. */
+export declare const FS_NODE_EXTRA_OPTION_KEYS: readonly ["parent_id", "include_pending"];
+/**
+ * `extra_options` of `GET /fs_nodes`. `parent_id` here returns the folder's
+ * children AND the folder itself; the `parent_id` column in `exactSearch`
+ * returns the children only, and is the only one that can say `null`.
+ */
+export interface FsNodeExtraOptions {
+    readonly parent_id?: Id;
+    readonly include_pending?: boolean;
+}
 /** Filters for {@link StorageNamespace.list}. */
-export interface ListFsNodesParams extends PageParams {
+export interface ListFsNodesParams extends ListParams<(typeof FS_NODE_FILTER_COLUMNS)[number], FsNodeExtraOptions> {
     /**
      * Directory to list. `null` lists the caller's ROOT nodes (home, trash,
-     * vault), which the server selects through its `\b` null sentinel.
+     * vault). Omitted, no parent filter is applied and the listing spans the
+     * caller's whole tree, which is what a name search across folders wants.
      */
-    readonly parentId: Id | null;
+    readonly parentId?: Id | null;
     /**
      * Include nodes whose bytes never landed. Off by default, because a
      * half-finished upload is not something a user wants to see - and because a
@@ -141,10 +139,9 @@ export interface ListFsNodesParams extends PageParams {
      * Also return the parent itself, so one call gets both the folder's metadata
      * and its children. It occupies a slot on the page like any other row.
      *
-     * IGNORED when `parentId` is `null`, and that is a correction rather than a
-     * convenience: the server-side filter behind this flag cannot express "no
-     * parent" at all, and asking it to used to answer with the caller's whole
-     * tree. The roots have no folder to fold in anyway. The detail is on
+     * IGNORED when `parentId` is `null`: the server-side filter behind this flag
+     * cannot express "no parent", and asking it to answers with the caller's
+     * whole tree. The roots have no folder to fold in anyway. The detail is on
      * {@link StorageNamespace.list}.
      */
     readonly includeSelf?: boolean;
@@ -165,6 +162,8 @@ export interface CopyFsNodesInput {
     readonly ids: Id[];
     readonly newParentId: Id;
 }
+/** `GET /fs_grants` filters on {@link BASE_FILTER_COLUMNS} only. */
+export type ListFsGrantsParams = ListParams<never>;
 /**
  * A sharing grant on a node.
  *
@@ -179,7 +178,7 @@ export interface FsGrant extends BaseRecord {
     readonly grantee_id: Id | null;
     /** Write access. Always `false` on a public grant - the server validates it. */
     readonly editable: boolean;
-    /** Only on the `:extended` view, i.e. from `get`, `create` and `update`. */
+    /** Only from `get`, `create` and `update`; absent in listings. */
     readonly fs_node?: FsNode;
     readonly grantor?: User;
     readonly grantee?: User | null;
@@ -214,22 +213,22 @@ export interface SharedFsNodeView {
  *
  * Creating one with a `granteeId` notifies that user. Creating one WITHOUT a
  * grantee mints a public link: the server also creates a short link in the `ss`
- * namespace whose endpoint is the grant's own id, pointing at the frontend's
- * `/storage/shared?id=<node>` page. Deleting the grant deletes that link.
+ * namespace whose endpoint is the grant's own id. Deleting the grant deletes
+ * that link.
  */
 export declare class FsGrantsNamespace extends Resource {
     /**
      * `GET /fs_grants` - the grants you hold: issued by you, or issued to you.
      *
-     * There is no server-side filter for the node. The controller allows only
-     * `id`, `created_at` and `updated_at` as search keys, and an unknown key is a
-     * 400, not a wider result - so narrowing to one node is a client-side filter
-     * over this listing. {@link StorageNamespace.shared} is the cheap way to ask
+     * There is no server-side filter for the node. The only search keys accepted
+     * are `id`, `created_at` and `updated_at`, and an unknown key is a 400, not a
+     * wider result - so narrowing to one node is a client-side filter over this
+     * listing. {@link StorageNamespace.shared} is the cheap way to ask
      * "how is THIS node shared".
      *
      * @throws {OmsAuthError} 401 when anonymous.
      */
-    list(params?: PageParams, options?: RequestOptions): Promise<Paginated<FsGrant>>;
+    list(params?: ListFsGrantsParams, options?: RequestOptions): Promise<Paginated<FsGrant>>;
     /** `GET /fs_grants/:id` - one grant, with its node, grantor and grantee expanded. */
     get(id: Id, options?: RequestOptions): Promise<FsGrant>;
     /**
@@ -259,9 +258,9 @@ export declare class StorageNamespace extends Resource {
     /** Sharing grants. */
     readonly grants: FsGrantsNamespace;
     /**
-     * Paces the four bulk-job endpoints against the `fs_bulk_job` throttle, which
-     * is twelve requests a minute for all of them together. A loop that trashes
-     * files one at a time waits here rather than collecting 429s.
+     * Paces the four bulk-job endpoints against their shared limit of twelve
+     * requests a minute. A loop that trashes files one at a time waits here
+     * rather than collecting 429s.
      */
     readonly bulkGate: StorageRateGate;
     /**
@@ -300,40 +299,29 @@ export declare class StorageNamespace extends Resource {
      * TWO server-side filters address a directory and they are NOT
      * interchangeable. That asymmetry is the whole subtlety of this method:
      *
-     * - `exact_search[parent_id]` reaches `Searchable.exact_search`, which is a
-     *   bare `where(params)`. The controller has already rewritten a `\b` value
-     *   to `nil` by then, so the sentinel lands as `WHERE parent_id IS NULL` -
-     *   and since `FsNode.root_nodes` is exactly `where(parent_id: nil)`, this is
-     *   the only filter in the API that can say "the roots". The ltree
-     *   `id_path` is the source of truth for ANCESTRY, but rootness is still a
-     *   null `parent_id`.
-     * - `extra_options[parent_id]` reaches `QueryExtraOptions::FsNodes`, which
-     *   runs `where(parent_id: x).or(where(id: x))` and so folds the folder
-     *   itself back into its own listing. Convenient - and guarded by
-     *   `return unless params[:parent_id].present?`, with that same `\b` -> `nil`
-     *   rewrite happening first. Hand it the sentinel and the guard drops the
-     *   filter IN SILENCE. The request still answers 200; it just answers with
-     *   the caller's ENTIRE listable tree, page after page, instead of three
-     *   rows. It is the same failure shape as the `inside_path` incident that
-     *   `reject_unknown_filter_keys!` was written for, except this key IS known,
-     *   so nothing rejects it.
+     * - `exact_search[parent_id]` selects the children only. A `\b` value is
+     *   read as `null` and selects the nodes with no parent, so this is the only
+     *   filter in the API that can say "the roots".
+     * - `extra_options[parent_id]` selects the children AND the folder itself.
+     *   Hand it the sentinel and the filter is dropped IN SILENCE. The request
+     *   still answers 200; it just answers with the caller's ENTIRE listable
+     *   tree, page after page, instead of three rows.
      *
      * Hence `includeSelf` is honoured under a real directory and ignored at the
      * top of the tree. Not client-side taste: it is the only combination the
      * server can actually express.
      *
-     * The endpoint is conditional-GET aware and answers 304 to a matching
-     * `If-None-Match`. The SDK never sends one, and asks the runtime not to
-     * revalidate on its own, because a 304 has no body and would surface here as
-     * an error rather than as an empty page.
+     * The endpoint answers 304 to a matching `If-None-Match`. The SDK never
+     * sends one, and asks the runtime not to revalidate on its own, because a
+     * 304 has no body and would surface here as an error rather than as an
+     * empty page.
      */
-    list(params: ListFsNodesParams, options?: RequestOptions): Promise<Paginated<FsNode>>;
+    list(params?: ListFsNodesParams, options?: RequestOptions): Promise<Paginated<FsNode>>;
     /**
      * `GET /fs_nodes/:id` - one node.
      *
-     * Resolves against the broader `viewable_by` scope, so a node reached through
-     * a public share link answers here even though it never appears in
-     * {@link list}.
+     * Visibility is wider than {@link list}'s: a node reached through a public
+     * share link answers here even though it never appears in a listing.
      *
      * @throws {OmsApiError} 404 when the node does not exist or is not visible.
      */
@@ -352,11 +340,10 @@ export declare class StorageNamespace extends Resource {
      * Resolves a slash-separated path under a starting node, walking children one
      * level at a time.
      *
-     * A convenience for humans and CLIs, NOT how the API works. The `path` column
-     * was dropped in the ltree migration and nothing on the server accepts a path
-     * string, so each segment costs one filtered listing. Results are memoised
-     * per client instance, which makes a second walk down the same prefix free,
-     * but the cheap call is always the one that already has an id.
+     * A convenience for humans, NOT how the API works. Nothing on the server
+     * accepts a path string, so each segment costs one filtered listing. Results
+     * are memoised per client instance, which makes a second walk down the same
+     * prefix free, but the cheap call is always the one that already has an id.
      *
      * `.` is skipped and `..` climbs to the parent. A leading `/` means "from the
      * home root" and ignores `from`.
@@ -376,9 +363,9 @@ export declare class StorageNamespace extends Resource {
      * blobs and reads the finished nodes back.
      *
      * Files at or above `MULTIPART_THRESHOLD` (32 MiB, exported from this
-     * package) take the multipart path automatically, and that is not tuning:
-     * the object store sits behind Cloudflare with a request-body cap around
-     * 100 MB, so it is the only way a large file gets in at all.
+     * package) take the multipart path automatically, and that is not tuning: a
+     * single request to the object store is capped at roughly 100 MB, so it is
+     * the only way a large file gets in at all.
      *
      * A per-file rejection - a quota that ran out, a name that collides with a
      * directory - does not throw. It comes back in
@@ -404,7 +391,7 @@ export declare class StorageNamespace extends Resource {
      * job's result is the list of directories that were created. Existing levels
      * are reused, so re-running the same paths is a no-op that creates nothing.
      *
-     * Costs one of the twelve `fs_bulk_job` requests a minute. Pass every path in
+     * Counts against the twelve bulk-job requests a minute. Pass every path in
      * one call rather than looping.
      *
      * @throws {OmsApiError} 400 when `paths` is empty or the parent is not a
@@ -471,10 +458,10 @@ export declare class StorageNamespace extends Resource {
      * `GET /fs_nodes/:id/zip` - a directory and every file under it that the
      * caller can see, as a zip archive.
      *
-     * Streamed, and streamed for real: the server generates it with
-     * `ActionController::Live`, so there is no `Content-Length` and no way to
-     * know the size in advance. Never retried automatically either - a retry
-     * restarts the whole archive from zero.
+     * Streamed, and streamed for real: the server generates the archive as it
+     * sends it, so there is no `Content-Length` and no way to know the size in
+     * advance. Never retried automatically either - a retry restarts the whole
+     * archive from zero.
      *
      * @throws {OmsApiError} 400 when the node is not a directory, 404 when it is
      *   not visible.
@@ -483,8 +470,8 @@ export declare class StorageNamespace extends Resource {
     /**
      * `PATCH /fs_nodes/:id` with a new name.
      *
-     * The returned node is checked against what was asked for. The controller
-     * silently drops any field outside its update allowlist, so a 200 alone
+     * The returned node is checked against what was asked for. The server
+     * silently drops any field it does not accept on update, so a 200 alone
      * proves nothing about the write having happened.
      *
      * @throws {OmsApiError} 400 when the name collides with a sibling or contains
@@ -494,9 +481,7 @@ export declare class StorageNamespace extends Resource {
     /**
      * `PATCH /fs_nodes/:id` with a new parent.
      *
-     * The server refuses a move that would make a node its own ancestor; that
-     * cycle check is the fix for the 2026-07-27 copy outage and must not be
-     * second-guessed client-side.
+     * The server refuses a move that would make a node its own ancestor.
      *
      * Like {@link rename}, the answer is verified rather than assumed.
      *
@@ -515,7 +500,7 @@ export declare class StorageNamespace extends Resource {
      * filters the index does, so a copy with NO selection would resolve to the
      * caller's entire listable tree and duplicate it.
      *
-     * Costs one of the twelve `fs_bulk_job` requests a minute.
+     * Counts against the twelve bulk-job requests a minute.
      */
     copy(input: CopyFsNodesInput, options?: RequestOptions): Promise<FsBulkJob>;
     /**
@@ -528,7 +513,7 @@ export declare class StorageNamespace extends Resource {
      * Refuses an empty id list for the same reason {@link copy} does: with no
      * selection the endpoint resolves to the caller's whole listable tree.
      *
-     * Costs one of the twelve `fs_bulk_job` requests a minute, so trash the whole
+     * Counts against the twelve bulk-job requests a minute, so trash the whole
      * selection in one call.
      */
     trash(ids: Id[], options?: RequestOptions): Promise<FsBulkJob>;
@@ -587,7 +572,7 @@ export declare class StorageNamespace extends Resource {
     /**
      * Fetches an object-storage URL on the injected transport with no credential
      * of ours attached. The presigned signature in the URL IS the credential, and
-     * a bearer header alongside it is what makes MinIO reject the request.
+     * the store rejects a request that carries a bearer header alongside it.
      */
     private fetchObject;
 }

package/dist/types/resources/tickets.d.ts

@@ -11,7 +11,8 @@
  * in the same request.
  */
 import { type ApiClient, Resource } from "../http";
-import type { FileInput, Id, Paginated, PageParams, RequestOptions, Timestamp } from "../types";
+import type { ListParams } from "../listing";
+import type { FileInput, Id, Paginated, RequestOptions, Timestamp } from "../types";
 /** Lifecycle of a ticket. */
 export type TicketStatus = "open" | "closed";
 /**
@@ -99,29 +100,37 @@ export interface CreateTicketInput {
     readonly initialMessage?: string;
     readonly context?: TicketContext;
     /**
-     * Files to attach. The SDK turns each one into the data URI the endpoint
-     * expects, so every attachment is buffered in memory.
+     * Files to attach, as bytes or as an already-encoded data URL. Bytes are
+     * base64-encoded here, so every attachment is buffered in memory.
      *
-     * Backend caps: {@link TICKET_MAX_ATTACHMENTS} files,
+     * Server caps: {@link TICKET_MAX_ATTACHMENTS} files,
      * {@link TICKET_MAX_ATTACHMENT_BYTES} in total, `image/*` and `video/*`
-     * only - and an attachment that breaks any of them is dropped in SILENCE,
-     * with the ticket still answering 201. The SDK therefore validates before
-     * sending and raises rather than let a screenshot disappear.
+     * only. An attachment over a cap is dropped server-side with the ticket
+     * still answering 201, so the SDK validates first and throws instead.
      */
-    readonly attachments?: FileInput[];
+    readonly attachments?: ReadonlyArray<FileInput | TicketAttachmentDataUrl>;
+}
+/** An attachment that is already a `data:<mime>;base64,...` URL. */
+export interface TicketAttachmentDataUrl {
+    readonly dataUrl: string;
+    readonly filename: string;
 }
 /** Fields that can change after a ticket exists. */
 export interface UpdateTicketInput {
     readonly status?: TicketStatus;
 }
+/** Filter columns of `GET /tickets`, on top of {@link BASE_FILTER_COLUMNS}. */
+export declare const TICKET_FILTER_COLUMNS: readonly ["status", "user_id"];
 /** Filters for {@link TicketsNamespace.list}. */
-export interface ListTicketsParams extends PageParams {
+export interface ListTicketsParams extends ListParams<(typeof TICKET_FILTER_COLUMNS)[number]> {
     readonly status?: TicketStatus;
     /** Administrators only: someone else's tickets. */
     readonly userId?: Id;
 }
+/** Filter columns of `GET /ticket_messages`, on top of {@link BASE_FILTER_COLUMNS}. */
+export declare const TICKET_MESSAGE_FILTER_COLUMNS: readonly ["ticket_id", "sender_id", "created_at"];
 /** Filters for {@link TicketMessagesNamespace.list}. */
-export interface ListTicketMessagesParams extends PageParams {
+export interface ListTicketMessagesParams extends ListParams<(typeof TICKET_MESSAGE_FILTER_COLUMNS)[number]> {
     readonly ticketId: TicketId;
 }
 /** Arguments for replying to a ticket. */

package/dist/types/resources/tools/backgroundRemoval.d.ts

@@ -1,15 +1,14 @@
 /**
  * Background removal: cuts the subject out of an image.
  *
- * `POST /background_removals` enqueues a proxy job and answers immediately with
- * a row plus a `job_id` and, for an anonymous caller, a `watch_token`. Poll
+ * `POST /background_removals` enqueues a job and answers immediately with a
+ * row plus a `job_id` and, for an anonymous caller, a `watch_token`. Poll
  * through `oms.jobs` with that handle, or use {@link BackgroundRemovalNamespace.run}.
  *
- * Backend limits: 15 MiB, and an image bomb (absurd pixel count for its byte
- * size) is rejected with a 400 before any work starts.
+ * Limits: 15 MiB, and an image bomb (absurd pixel count for its byte size) is
+ * rejected with a 400 before any work starts.
  *
- * This tool has no daily quota - it is one of the two that the `Quotas`
- * catalogue does not meter - so there is no `quota()` here to call first.
+ * This tool has no daily quota, so there is no `quota()` here to call first.
  */
 import { Resource } from "../../http";
 import type { FileInput, Id, RequestOptions } from "../../types";
@@ -18,12 +17,12 @@ import { type ToolCaptcha, type ToolJobHandle, type ToolRecord, type ToolRunOpti
  * A background removal run.
  *
  * Both routes that answer with one - `POST /background_removals` and
- * `GET /background_removals/:id` - render the `:extended` view, so `result_url`
- * is always PRESENT and simply `null` until the run completes.
+ * `GET /background_removals/:id` - answer the same shape, so `result_url` is
+ * always PRESENT and simply `null` until the run completes.
  *
  * `progress_percent`, inherited from {@link ToolRecord}, is never sent for this
- * tool: `BackgroundRemovalBlueprint` has no such field. Progress lives on the
- * {@link Job} row that {@link BackgroundRemovalCreated.job_id} names.
+ * tool. Progress lives on the {@link Job} row that
+ * {@link BackgroundRemovalCreated.job_id} names.
  */
 export interface BackgroundRemoval extends ToolRecord {
     /**
@@ -38,7 +37,7 @@ export interface BackgroundRemoval extends ToolRecord {
 export type BackgroundRemovalCreated = BackgroundRemoval & ToolJobHandle;
 /** Arguments for starting a run. */
 export interface CreateBackgroundRemovalInput extends ToolCaptcha {
-    /** The image. Backend cap: 15 MiB. */
+    /** The image. Cap: 15 MiB. */
     readonly file: FileInput;
 }
 /** The `backgroundRemoval` tool, reachable as `oms.tools.backgroundRemoval`. */
@@ -56,8 +55,7 @@ export declare class BackgroundRemovalNamespace extends Resource {
      *
      * NOT retried by default, unlike most of the SDK. The transport's policy
      * replays a `POST` that died with a 502, and here that would re-upload the
-     * image and start a second run on a sidecar that serialises them. Pass
-     * `retry: {}` to opt back in.
+     * image and start a second run. Pass `retry: {}` to opt back in.
      *
      * @throws {OmsApiError} 400 when the image is too large or looks like a bomb.
      * @throws {OmsAuthError} 401 when anonymous and the captcha is missing or bad.