No-op MCP context for unit tests.

Extends FakeZotero with update-specific behaviour.

Minimal pyzotero client stub. Extend per test file as needed.

FakeZotero extended with attachment_both stub.

Minimal httpx.Response stub.

Minimal ChromaClient stand-in that records operations for assertions.

pyzotero client double with scripted responses.

Minimal requests.Response stand-in.

Stub for a fitz (PyMuPDF) Document object. Supports the interface used by server.add_from_file: - doc.metadata - doc.page_count - doc

Extended stub that tracks write operations for merge testing.

Direct SQLite reader for Zotero's local database. Provides fast access to item metadata and fulltext for semantic search without going t

FakeZotero with collection() lookups, trash fetch, and addto support.

Extends FakeZotero with relation-specific behaviour.

FakeZotero extended with attachment_both tracking.

Class to interact with Zotero's local Better BibTeX JSON-RPC API

pyzotero stub exposing item_versions / last_modified_version.

FakeZotero that records addto_collection calls and lets the test decide whether pyzotero's atomic filing 'worked' on create_items.

FakeZotero with tracking for collection write operations.

Fake Zotero client that models the real parent/child hierarchy. Papers contain notes and attachments; annotations live under attachments, not

LocalZoteroReader stub: no DB, attachments / storage dir injected.

Captures PUT calls and returns a configurable response.

Drop-in replacement for fastmcp.Context that writes to stderr.

Represents a single step in a CFI path. In CFI notation: - Elements are even numbers: (index + 1) * 2 - Text nodes are odd numbers:

Custom Ollama embedding function for ChromaDB. Uses Ollama's local HTTP API. Registered under the name ``ollama`` so ChromaDB can rebuild per

FakeZotero with add_parameters support for citation-key tests.

A segment of a CFI path, consisting of steps and an optional terminal offset.

Subclass that skips DB init and allows injecting fake attachment text.

Custom HuggingFace embedding function for ChromaDB using sentence-transformers. Registered under the name "huggingface" so ChromaDB rebuilds it (

Represents a Zotero item with text content for semantic search.

FakeZotero honoring a content= kwarg for CSL/bibtex rendering.

Minimal pyzotero stub with the methods search_items needs.

Result of downloading an attachment from one of the supported sources.

Chroma stub that records upserts and supports chunk bookkeeping.

Minimal ChromaClient stub for unit tests.

Minimal httpx.Response stub.

LocalZoteroReader stub with no DB and configurable attachments.

Details about a Zotero attachment.

HTML parser that extracts text while tracking precise positions for CFI generation. This parser: - Tracks element indices among element

Fakes a ChromaDB client whose upsert raises a transient error. Exercises the deferred-retry path in _process_item_batch.

Fake Zotero client that returns different items based on itemType parameter.

Custom Gemini embedding function for ChromaDB using google-genai. Registered under the name "gemini" so ChromaDB can rebuild it from a persis

Custom OpenAI embedding function for ChromaDB. Registered under the name "openai" so ChromaDB rebuilds it (rather than its own incompatible b

Raised when WebDAV environment variables are missing.

Semantic search interface for Zotero libraries using ChromaDB.

LocalZoteroReader stub that skips DB init.

A registered EF whose persisted name is *not* ``"default"``. This recreates the embedding-function conflict that a real populated collection

ChromaDB client for Zotero semantic search.

Stub that returns parents + children from collection_items.

Optional cross-encoder re-ranker for semantic search results.

Complete EPUB CFI representation. Format: epubcfi(/6/<spine>!<path>,<start>,<end>) For ranges: - base: /6/<spine_index> (spine refe

ChromaClient stub for update_database runs with no items.

Simulates a fitz.Document with a get_toc() method.

Minimal fitz document stub for page geometry lookups.

Stub for a fitz Page object.