Skip to content

v0.106.0 ​

v0.106.0 is a non-breaking integration release that adds first-party provider adapters for the acquisition connector workflow.

What Changed ​

AreaChangeWhy it matters
Connector servercontextdb connectors serveRuns acquisition connector endpoints outside the main contextdb API
OpenAI adapterPOST /openai/search and /openai/crawlLets acquisition execution call OpenAI web-search-backed research
xAI adapterPOST /xai/search and /xai/crawlLets acquisition execution call xAI web-search-backed research
Anthropic adapterPOST /anthropic/search and /anthropic/crawlLets acquisition execution call Claude web-search-backed research
NormalizationProvider responses become { "items": [...] }Keeps provider details behind the same source-constrained acquisition contract
Feature metadataacquisition-provider-connectorsLets live services advertise bundled provider adapter support

Run It ​

Start the connector server:

bash
OPENAI_API_KEY=... \
XAI_API_KEY=... \
ANTHROPIC_API_KEY=... \
contextdb connectors serve \
  --addr :7780 \
  --providers openai,xai,anthropic \
  --allowed-domains docs.example.com,github.com

Then use the adapter endpoint from acquisition execution:

json
{
  "budget": 2,
  "max_results": 3,
  "allowed_source_ids": ["openai:web"],
  "connectors": [
    {
      "id": "openai-web",
      "type": "search",
      "endpoint": "http://localhost:7780/openai/search",
      "allowed_source_ids": ["openai:web"],
      "default_labels": ["acquired", "provider:openai"]
    }
  ]
}

Dry-run behavior is unchanged: contextdb will not call the adapter until acquisition execution is run with execute: true.

Configuration ​

VariablePurpose
OPENAI_API_KEYOpenAI adapter API key
XAI_API_KEYxAI adapter API key
ANTHROPIC_API_KEYAnthropic adapter API key
CONTEXTDB_OPENAI_CONNECTOR_MODELOpenAI model override
CONTEXTDB_XAI_CONNECTOR_MODELxAI model override
CONTEXTDB_ANTHROPIC_CONNECTOR_MODELAnthropic model override
CONTEXTDB_OPENAI_BASE_URLOpenAI-compatible base URL override
CONTEXTDB_XAI_BASE_URLxAI base URL override
CONTEXTDB_ANTHROPIC_BASE_URLAnthropic base URL override
CONTEXTDB_CONNECTOR_ALLOWED_DOMAINSComma-separated provider search domain allow-list
CONTEXTDB_CONNECTOR_BLOCKED_DOMAINSComma-separated provider search domain block-list

Domain allow/block lists are mutually exclusive for one connector server process.

Compatibility ​

This release is additive. The main contextdb REST API, acquisition execution contract, SDKs, and existing custom connector endpoints continue to work unchanged.

Verification ​

The release includes provider adapter tests for OpenAI-compatible request shape, Anthropic web-search message shape, normalized connector items, and connector server routing.

Released under the MIT License.