plugins/ folder of the repository. They use the same public protocol as your own plugins, and none is compiled into the engine. make dev runs the default set; optional plugins are pinned explicitly.
pdf-text
Turns a PDF into onebody Part per page with text, keyed page-1, page-2…, plus a source Part that references the PDF. The Version’s pdf-text.document extension holds page_count and text_pages. Pages without text, such as scans, are skipped with an empty_pages warning: there is no OCR. An encrypted or damaged PDF is quarantined with the code encrypted_pdf or corrupt_pdf.
Pin it with a route for
application/pdf. See Add content to upload a PDF.
newsml-g2
Turns IPTC NewsML-G2 items and messages into headline, slugline and paragraph Parts, preserving Arabic and other scripts in logical order. Each text Part carries its inherited language and direction within the extension budget. The original XML remains a source Blob. Thenewsml-g2.document extension exposes identity and editorial metadata;
newsml-g2.xml retains elements, attributes and mixed text with namespace URIs within the extension budget. The raw source always retains the complete XML.
quivr.metadata schema 1 supplies the common search and document filters, with source_type: news_item. Publication uses a valid firstCreated, falling back to versionCreated. Common values are bounded; original values stay in the source Blob. Stored Versions keep their original metadata; new source revisions run the updated normalizer.
Pin required routes for application/vnd.iptc.g2.newsitem+xml and
application/vnd.iptc.g2.newsmessage+xml. A message may contain several newsItem
elements. The first nonblank headline is the sole title; later headlines become
body text. All item text is indexed in source order within the text limits.
Version metadata describes the first item. Choose a stable message-level identity
before submission, or split the items to version them independently. For a single
item, use its guid as Record Key and version as Source Position.
max_input_bytes defaults to 1 MiB and max_text_bytes to 256 KiB. The
header_paths list selects literal element paths into newsml-g2.headers, using
{namespace-uri}name for foreign elements. DTDs and entities are refused. Oversize
text or output is refused with a diagnostic.
Extensions fit the engine’s 65,536-byte JSON budget. Oversize metadata omits fields
deterministically; oversize XML and selected-header views become empty objects.
Owned namespaces mark omissions with truncated: true, and every omission emits
extensions_truncated. These omissions let normalization succeed without dropping
searchable text. The raw source Blob remains complete.
See the installation, mapping and limits.
alerts
Keyword and local-vector checks need no classifier key. Jev checks need aTYPESAFE_API_KEY in the plugin’s environment.
Vector checks embed the description with the deployment’s embedding provider, which also embeds every document. With the default
core-ingest and an embedding server you run, that text stays inside the installation; with a hosted provider, it goes to that provider.
The pin’s kinds lists the alert kinds the deployment accepts. For keyword and local meaning checks without a TypeSafe key, pin "kinds": ["keywords", "meaning", "keywords_or_meaning", "keywords_and_meaning"], as make dev does. Use kind: meaning for a local description, and meaning_check: vectors for every meaning check. This pin excludes described, so that kind is refused with 422 invalid_expression even when it selects vectors. The kind list alone does not prevent a mixed expression from selecting Jev.
To offer Jev checks:
- Put the key in the
alertsplugin’s environment:TYPESAFE_API_KEY=<your key>. Never put it in Quivr’s configuration, in logs or in a repository. - Add
describedto the pin’skinds, keeping the kinds already offered:"kinds": ["keywords", "meaning", "keywords_or_meaning", "keywords_and_meaning", "described"]. A kind missing from the list is refused for new alerts. - Restart the plugin and Quivr. The plugin logs at startup whether described alerts are enabled.
make dev adds described only when TYPESAFE_API_KEY is set in its environment. Meaning kinds need alerts 0.4.0; existing Subscriptions keep the version they name until you migrate them.
See How alerts work, Keyword alerts and Meaning alerts.
core-ingest
The default ingestion plugin. It cuts thetitle and body Parts of each Version into windows of at most 384 tokens that overlap by 48 and prefer paragraph and sentence ends, then embeds each window in the space core.ingest.e5-small@1 (384 dimensions, cosine) through a Text Embeddings Inference server. A Version with a title and no body, such as a feed item without a description, gets one segment: its title. It refuses a Version with no title or body text, more than 256 KiB of text, 64 Parts or 256 windows, which is then blocked with ingestion_refused and a diagnostic that names the reason, and a query longer than 256 tokens.
hosted-embed
The optional hosted ingestion plugin selects a model, dimensions and input templates by configuration. It supports OpenAI-compatible/embeddings and Cohere v2 /embed APIs, with bearer, api-key or no authentication. Its key is a declared EMBED_API_KEY secret in the plugin process environment. It packs paragraphs and pages through all source text, batches requests and resumes completed batches after a retryable provider failure.
Configure document_template and query_template for the model’s required prompts;
the model name does not select a template. The
EmbeddingGemma 2 example
shows a model with separate document and query prompts. Generate an immutable manifest
from the configuration before installing it. Each model, dimension, revision or template change creates a new vector space; evaluation, backfill and promotion use the usual engine operations. Each provider attempt logs input-token usage for cost accounting. See the configuration examples and package commands.
core-retrieve
The default retrieval plugin follows the search mode:bm25 on the title and body for lexical, near_vector in every served space for semantic, and hybrid in every served space for hybrid. It merges candidates by score, keeps each segment once and breaks score ties by segment id. Optional pin settings select dense_weight, candidate_count and hybrid_fusion; defaults remain alpha 0.5, the search limit and relative-score fusion. See Core retrieval settings for bounds and an example.
It declares default (500 ms, no paid call) and deep (3 s, 1 cent). Its deep ranks like default; to re-rank, install jev.rerank and map the short name deep to jev.rerank/deep in retrieval.profiles. See Re-rank deep searches with Jev for that configuration. The api refuses to start without a retrieval plugin.
jev-rerank
The optionaljev.rerank retrieval plugin declares only deep. It asks core.retrieve/default for a hybrid shortlist, then scores it in bounded batches with Jev, TypeSafe’s paid model. A deep search can make paid calls; usage reports the calls and cost, and each re-ranked hit explains its probability. Without a TypeSafe key, or on errors and deadlines, it returns the original hybrid order without a Jev score. It can shorten passages, drop overlapping hits and cache scores. See Re-rank deep searches with Jev for configuration and settings, and Search profiles for how it builds on core.retrieve/default.
rss
Polls one feed per Connector Instance, with conditional requests and the feed’sttl. Each item becomes a Record keyed by its guid or id; an edited item becomes a new Version. It refuses private and loopback addresses unless allow_private_addresses is true, which only a local test deployment should set. See RSS and Atom feeds.
m365-mail
Collects one folder of one Microsoft 365 mailbox through Microsoft Graph: subject and body as text, attachments up to 25 MB as stored files.login_endpoint and graph_endpoint override Microsoft’s global endpoints, for a national cloud. See Microsoft 365 mail.
x-list
Polls the posts of one X list, turns edits into corrections, and withdraws posts deleted or made protected on X within a recheck window. It can also receive posts in real time through X webhooks.api_endpoint overrides the X API origin, for a test fake only. See X lists.
push-source
The offline Python sample accepts versioned text records atPOST records, secured by a Quivr instance token. Its events kind maps each record into title and body Parts, preserving the sender’s key and revision. It has no upstream credential or configuration, and its scheduled fetch only reports channel health. Write a push source explains its route; Receive and secure pushes walks through access and tokens.