feat: add Zaps.ai as a first-class provider

[argosautomation]

Summary

Adds Zaps.ai as a first-class provider in Esperanto, covering Language Models and Embeddings.

Zaps.ai is a privacy gateway — requests are routed through Zaps for automatic PII redaction before being forwarded to the upstream provider (OpenAI, Anthropic, etc.). It exposes an OpenAI-compatible API.

Changes

New Files

• src/esperanto/providers/llm/zaps.py — ZapsLanguageModel (extends OpenAILanguageModel)
• src/esperanto/providers/embedding/zaps.py — ZapsEmbeddingModel (extends OpenAIEmbeddingModel)

Modified Files

• src/esperanto/factory.py — Registered zaps in language and embedding provider modules
• src/esperanto/model_discovery.py — Added get_zaps_models() discovery function + registry entry

Configuration

Env Variable	Description	Default
ZAPS_API_KEY	API key for Zaps.ai	(required)
ZAPS_BASE_URL	Base URL	https://api.zaps.ai/v1

Usage

from esperanto.factory import AIFactory

# Language Model
model = AIFactory.create_language('zaps', 'gpt-4o')
response = model.chat_complete([{'role': 'user', 'content': 'Hello!'}])

# Embeddings
embedder = AIFactory.create_embedding('zaps', 'text-embedding-3-small')
vectors = embedder.embed(['Privacy is important'])

Testing

All factory registration and provider instantiation tests pass locally.

[cubic-dev-ai]

No issues found across 4 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

[lfnovo]

Is there a reason why this cannot be done through the openai compatible provider instead?