Release Notes

Installation command updated

The pip index URL for all Elsai Core packages has changed. Replace any existing install commands that use https://elsai-core-package.optisolbusiness.com/root/ with the new URL:

https://core-packages.elsai.ai/root/<package-name>/

Example:

# Old (no longer works)
pip install --extra-index-url https://elsai-core-package.optisolbusiness.com/root/elsai-model/ elsai-model==1.4.1

# New (correct)
pip install --extra-index-url https://core-packages.elsai.ai/root/elsai-model/ elsai-model==1.4.1

All install commands in this documentation already reflect the updated URL.

---

Elsai Core v3.0 — Elsai Model v2.0.0

Release Date: Jun 2026

Unified *Model provider API (elsai-model==2.0.0) replacing v1.4.x *Connector classes. See Core release notes and LLM Models.

Agents: elsai-agents is compatible with elsai-model v2.0.0 — pass *Model instances directly to Agent(model=…). See Agents release notes.

Agent-as-tool concurrency: Agent.as_tool(mode=…) supports reject (default), queue, and spawn for parallel calls to the same sub-agent. See Agent as Tool.

---

Elsai Agents v0.1.0

Release Date: 2025

Initial release of the Elsai Agent Framework, built on the Strands Agents SDK. Provides a complete toolkit for building production AI agents with tools, multi-agent coordination, memory, and lifecycle control.

What's included

Core agent runtime

• Agent class — Single-entry point for creating and running agents with any supported LLM
• Agent loop — Automatic tool-call/response cycle with configurable max iterations
• Streaming — Token-by-token and event-stream output
• Structured output — Typed responses via Pydantic models

Tools

• @tool decorator — Convert any Python function into an agent tool
• MCP Tools — Connect agents to any MCP server
• Directory tools — Auto-load tools from ./tools/

Multi-agent

• Graph — DAG-based agent pipelines with conditional routing
• Swarm — Dynamic agent handoffs with shared context
• Workflow — Sequential and parallel agent pipelines
• Agent as Tool — Nest agents inside other agents
• Agent-to-Agent (A2A) — Remote agent calls over HTTP via A2AServer and A2AAgent

Memory and sessions

• SessionManager — Persist and restore agent conversation state across runs
• File and S3 storage backends for session persistence

Lifecycle and control

• Hooks — BeforeAgentCallEvent, AfterAgentCallEvent, BeforeToolCallEvent, AfterToolCallEvent
• Interrupts — Pause and resume agent execution mid-loop
• Retry strategies — ModelRetryStrategy with exponential backoff

Plugins

• AgentSkills — Load reusable skill sets from SKILL.md files
• AgentsMdPlugin — Hierarchical AGENTS.md discovery and system-prompt injection
• LLMSteeringHandler — Pre/post-call LLM guardrails (Proceed / Guide / Interrupt)
• ContextOffloader — Automatic offloading of large context to external storage

Agent configuration

• Pass plugins, hooks, session_manager, and other metadata through AgentConfig — direct Agent(...) keyword arguments for these fields are deprecated

Installation

pip install --extra-index-url https://elsai-agents.elsai.ai/root/ elsai-agents==0.1.0

Optional extras:

# With A2A support
pip install --extra-index-url https://elsai-agents.elsai.ai/root/ "elsai-agents[a2a]==0.1.0"

---

elsai-agents-tools v0.1.0

Release Date: 2026

Initial release of the Elsai Prebuilt Tools package — a companion to elsai-agents with ready-made tools for agents. Python import namespace: elsai_tools.

What's included

• 50+ prebuilt tools across nine categories: RAG and memory, file operations, shell/system, code interpretation, web and network, multimodal, AWS, utilities, and multi-agent workflows
• Function tools — import from elsai_tools.<module> and pass to Agent(tools=[...])
• Class-based providers — LocalChromiumBrowser, AgentCoreCodeInterpreter, AgentCoreMemoryToolProvider, A2AClientToolProvider
• Optional pip extras — mem0-memory, local-chromium-browser, agent-core-code-interpreter, diagram, rss, a2a-client, and more
• Direct tool calls — agent.tool.<name>(...) without going through the LLM
• Tool consent — confirmation prompts for sensitive tools; BYPASS_TOOL_CONSENT=true for CI

Installation

pip install --extra-index-url https://elsai-agents.elsai.ai/root/ elsai-agents-tools==0.1.0

Requires Python 3.10+ and elsai-agents>=0.2.0.

Optional extras:

pip install --extra-index-url https://elsai-agents.elsai.ai/root/ \
  "elsai-agents-tools[mem0-memory,local-chromium-browser,diagram]==0.1.0"

See the Prebuilt Tools API for per-tool parameters and import paths.

---

Elsai Core v2.0.0

Release Date: July 2025

New features

Elsai Cloud Connectors

• Microsoft Outlook Integration — Send emails with attachments and rich HTML formatting using the Microsoft Graph API.
• Microsoft Delta API Support — Track incremental changes in Outlook, OneDrive, and SharePoint data.
• EmailService — Generic email sending service.

Elsai OCR Extractors v2.0.0

• Mistral OCR — Support for the Mistral OCR engine for complex document layouts.
• Amazon Boto3 Connector — Native connectors for AWS services using the Boto3 SDK (sync and async modes).
• Amazon Textractor — AWS Textract integration for document analysis (sync and async workflows).

Elsai Model v1.0.0

• Gemini Integration — Google Gemini with full multimodal generation capabilities.
• LiteLLM Integration — Unified interface across all LLM providers through LiteLLM.
• Async OpenAI & Azure OpenAI — Asynchronous connectors for high-throughput inference.

Elsai VectorDB v2.0.0

• as_retriever() method — All vector stores now expose a retriever interface for seamless integration with elsai-retrievers in RAG workflows.

Changes

Elsai Prompts

• Pezzo → Elsai Foundry Migration — Prompts are now managed within Elsai Foundry, providing centralized version control, better traceability, and improved lifecycle management. v1.0.0 is deprecated.

Elsai Model

• Native Bedrock implementation — Migrated from LangChain to a native boto3 implementation, reducing latency and dependency overhead.

Elsai OCR Extractors

• VisionAI enhancements — Sync and async processing, configurable batch sizes.
• Azure Document Intelligence — Accepts additional keyword arguments for customization.

Upgrade guide

pip install --upgrade \
  --extra-index-url https://core-packages.elsai.ai/root/elsai-model/ elsai-model==1.4.1 \
  --extra-index-url https://core-packages.elsai.ai/root/elsai-ocr-extractors/ elsai-ocr-extractors==2.0.1 \
  --extra-index-url https://core-packages.elsai.ai/root/elsai-prompts/ elsai-prompts==1.1.0 \
  --extra-index-url https://core-packages.elsai.ai/root/elsai-cloud-connectors/ elsai-cloud==2.1.0 \
  --extra-index-url https://core-packages.elsai.ai/root/elsai-vectordb/ elsai-vectordb==2.2.1

---

Package version history

elsai-agents

Version	Date	Changes
0.1.0	2025	Initial release — Agent, tools, multi-agent, sessions, hooks, plugins

elsai-agents-tools

Version	Date	Changes
0.1.0	2026	Initial release — 50+ prebuilt tools, class-based providers, optional extras

elsai-model

Version	Date	Changes
2.0.0	Jun 2026	Unified *Model provider API; see Elsai Core v3.0
1.4.1	—	Legacy connector API (v1.4.x)
1.3.0	—	implementation param (native/langchain) for OpenAI and Azure
1.2.2	—	All connectors return full response object
1.2.1	—	Gemini logprobs support
1.2.0	—	Bedrock invoke_with_image for OCR
1.1.2	—	Gemini response format change
1.1.1	—	Bedrock Messages API (Claude Sonnet 4 support)
1.1.0	—	AnthropicBedrockConnector; Bedrock streaming
1.0.1	—	Streaming for OpenAI and Azure OpenAI
1.0.0	Jul 2025	Gemini; LiteLLM; native Bedrock boto3

elsai-vectordb

Version	Date	Changes
2.2.1	Latest	Current stable
2.1.0	—	Filter-based retrieve_document for ChromaDB and Pinecone
2.0.0	Jul 2025	as_retriever() method added
1.1.0	—	update_document, delete_document, list_collections, delete_collection
1.0.0	—	ChromaDB, Pinecone, Weaviate

elsai-ocr-extractors

Version	Date	Changes
2.0.1	Latest	Current stable
2.0.0	Jul 2025	Mistral OCR; Amazon Boto3 Connector; Amazon Textractor
1.0.0	—	VisionAI sync/async; Azure Document Intelligence keywords

elsai-embeddings

Version	Date	Changes
0.2.0	Latest	Amazon Bedrock embeddings
0.1.0	—	Azure OpenAI embeddings

elsai-chat-history

Version	Date	Changes
1.1.0	Latest	SemanticMemoryStrategyImpl, SimilaritySearchStrategy
1.0.0	—	Initial release — storage backends, trimming/summarization/LRU/TTL strategies

elsai-prompts

Version	Date	Changes
1.1.0	Jul 2025	Migrated to Elsai Foundry
1.0.0	—	Deprecated — Pezzo-based

elsai-cloud-connectors

Version	Date	Changes
2.1.0	Latest	Current stable
1.0.0	Jul 2025	Outlook; Delta API; EmailService

elsai-graph packages

Package	Version	Notes
elsai-graph-constructor	0.1.0	Initial release
elsai-graph-generator	0.1.0	Initial release
elsai-graph-query-rag	0.1.0	Initial release

Other packages

Package	Version	Notes
elsai-retrievers	0.1.0	Initial release
elsai-text-extractors	0.1.0	Initial release
elsai-parsers	0.1.0	Initial release
elsai-nli	0.1.0	Initial release
elsai-stt	0.1.0	Initial release
elsai-utilities	0.2.0	Current stable
elsai-db	0.2.0	LangChain upgrade
elsai-mcp	0.1.1	Current stable