Hybrid keyword + semantic search across the whole library. English, Chinese, or mixed queries; matching is cross-lingual. Filters: `tags`, `provenance` (`authored` / `clipped` / `ai_summary` / `ocr` / `any`), `start` + `end` date range, `limit` (default 5, max 50).
Recent items, newest first. Filters: `start` + `end` (ISO, together), `provenance`, `keyword` (literal AND over full text, not semantic), `limit` (default 10, max 50).
One item by UUID as Markdown text plus `version`. Windowed: default first 8,000 characters, then `windowStart` = previous `nextStart` (`windowLength` up to 20,000). Chunk mode: `chunk` (ordinal from `chunkRef`) with `chunkRadius` 0–3 neighbours (default 1).
The user's plan, remaining credits, and storage.
Save an HTTP(S) URL (`id` UUID v4 you generate, `url`). Capture and enrichment run asynchronously and spend credits like a save from the app; the response reports `status`, `replayed`, and `consentRequired` / `insufficientCredits` when enrichment did not run.
Save a plain-text or Markdown note (`id` UUID v4, `authoredContent`, optional `hubTitle`). Stored verbatim, never AI-enriched, searchable shortly after.
Replace the user-authored text layer of any item (`authoredContent`, optional `hubTitle` to rename, `expectedVersion`). For notes that is the note; for clips and articles it overrides the extracted body while the original source stays archived. Revision-backed and undoable.
Replace an item's full tag list (`tags`, up to 20, the complete list not a delta; `expectedVersion`). Revision-backed and undoable.
Move an item to the recycle bin (`expectedVersion`). The user can restore it. Deleting an already-deleted item succeeds with `alreadyDeleted: true`, so retries are safe.