Xagent v0.8.2
A V2 execution-event system with pause and auto-recovery for interrupted tasks, a Milvus knowledge-base engine, new conversations that wait for connector inputs, a native Bedrock Converse runtime and configurable execution token budgets
📅 Released October 10, 2026
🔄 How to update
cd xagent && git pull
docker compose up -d
pip install --upgrade xagent-ai
✅ Highlights
V2 execution events
Execution, model context and task displays are now built from execution events and can be recovered from them.
Pause and auto-recovery
Runs that hit persistence or model-provider failures pause instead of failing, and can resume automatically under a policy.
Milvus knowledge base
A Milvus engine with search, delete, rename and rollback, shipped as a docker-compose add-on.
🚀 What's New
🧱 V2 execution event system
Execution event writers are wired in and reader contracts established; V2 executions can be recovered from event facts, model context and task displays are built from execution events, and context reads are bounded to the latest summary suffix.
⏸️ Task interruption and auto-recovery
Run failures are classified into interruption reasons; runs that hit persistence failures or a model provider that stays unavailable pause instead of failing; task APIs and events expose interruption state; new auto-recovery settings, an auto-resume policy and eligibility rules.
🗄️ Milvus knowledge-base engine
The KB engine is locked per deployment; a new Milvus collection handle commits vectors per document with a visibility flag and supports search, delete, rename and rollback; Milvus ships as a docker-compose add-on.
🔌 Connector runtime input checks
Connector runtime inputs are checked when a conversation is opened; a new conversation's first message waits until its connector inputs are filled; custom connectors can be deleted from the Tools page edit dialog.
📁 Connector upgrades
Google Drive gains a file move tool, a Picker authorization flow and in-place content replacement; OneDrive gains a move-item tool; Jira gains an attachment upload tool; HubSpot moves to hosted MCP; connector downloads become durable file references.
🤖 Models and runtimes
A native Bedrock Converse runtime; Azure OpenAI and routing model ids declared in the provider registry; a safe provider-call boundary and per-task model override; a typed ModelProviderError for OpenAI-compatible provider failures; support for Claude-compatible model setup.
💰 Configurable execution token budgets
Set a token budget on executions to cap what a single task can spend.
🧠 Persistent memory and context
The redesigned persistent-memory lifecycle is enabled; stored tool results are listed when the context is compacted; tool identity is persisted per invocation; the agent continues after a model-authored form is answered.
🧹 Data retention
Expired tasks are reported on the v1 API and shown on internal surfaces, with a per-team retention period override hook.
🔐 OAuth and permissions
Google review scopes are gated; per-account authorize and token endpoints are supported; every built-in Microsoft connector requests offline_access, and OneDrive, Outlook and Teams require app-scoped grants.
🛠️ Builder and interaction
Agent Builder keeps preview history and can rerun samples; clarification forms offer suggestions and pagination; failed task messages and channel failure replies include the task id; a runnable Parallel Search MCP example.
🛠 Stability & Polish
- Trace: record finish_reason and usage_missing on llm_call_end
- Model: abort an OpenAI-compatible stream that stops making progress
- Bound upload cleanup disposal
- Agent: skip settlement agent results and look up anchors by event id in V2 context reads
- Knowledge base: delete documents through the handle, complete KBCollectionHandle with contract tests, and read collection and document stats through the engine
- Preserve Gemini image input token modalities
- Clarify connector access and pause on authentication failures
- Knowledge base: match collection delete rows by exact directory prefix, and keep referenced files in a deleted collection's directory
- A2A: return the canceled state from the cancel response
- Web: settle a pause whose run paused before the pause was recorded
- Memory: stop copying the user's request text into memory note metadata
- Tools: cap read_tool_result pages at the tool output limit
- Knowledge base: truncate main pointer timestamps to milliseconds
- Model: apply default_max_tokens in OpenAICompatibleLLM request builders
- Tools: keep knowledge-base authoring tools off chat agents
- Expose effective MCP runtime argument bindings
- Model: explicit credentials, strict catalog reads and Zhipu SDK-thread context
- Acknowledge admission-queued SDK replies as queued
- Record task attachment detachment atomically
- Web: charge admission capacity per active execution, keep runnable admission heads across execution lanes, and release a drained incarnation's admission ticket while its task keeps running
- Track builder preview completion by task status
- MCP: redact resource/issuer in the OAuth runtime diagnostic
- MCP: replace the per-server init cap with reclaim of abandoned handshakes
- Prevent SQLite task identity reuse
- Preserve semantic and channel task completion outcomes
- OAuth: surface a forwardable admin-consent link for Microsoft connectors
- Deputy: verify an update's record is readable before reporting success
- Remove the blank Google Slides page and support designed PPTX import
- Knowledge base: apply caller scope to the sparse substring fallback
- Show uncached formulas in spreadsheet previews and sanitize preview HTML
- MCP: stage durable files for upload connectors
- Excel: add reliable bounded row queries and excel_delete_rows for structural row deletion
- Clarify agent builder completion and chat handoff
- Preserve registered upload paths after cache eviction, and recover builder previews after upload failures
- Agent: fetch the newest recovery state alone before paging older ones
- Protect KB references from upload cleanup claims, and complete recoverable file cleanup (2B)
- Preserve failed DAG step outcomes in chat
- Jira: add a continuation note to truncated jira_search_issues pages
- Avoid repeated clarification text in task history
- Agent: classify V2 in-run persistence failures and reconcile lost finalize acks
- Web: back off task command dispatch after repeated failures, and keep the dispatcher running when a task owner cancels its command
- PowerPoint: never return the raw driveItem from write results
- Calendar: put Zoom join links on calendar events and add zoom_create_meeting
- Move the execution budget below account settings
- Google: explain unreachable files, failed Drive moves, and how to open Office files stored in Drive
- MCP: report a reconnect state for OAuth servers whose only grant the app-scoped policy rejects
- OneDrive: drop every preauthenticated download URL from drive items, explain a path miss without forwarding Graph error bodies, and point an empty search at the folder listing while preferring in-place Office edits
- OAuth: accept the catalog provenance marker on built-in OAuth servers, and make actor OAuth callback errors actionable
- Agent: build DAG checkpoint payloads from committed step state
- Connectors: reject names that fold to an existing connector or a catalog app name
- MCP: point the agent at file: when an upload path is refused
- Web: mark the external cancel terminal frame as an interruption, and surface model-provider failures to task stream consumers
- Knowledge base: count an ingested document once in the collection stats
- Jobs: run the Celery engine check in a child process
- Agent: stop resending a tool call cut off at the output limit
- Web: project resumed run outcomes onto trigger runs
- Knowledge base: a series of internal refactors that hand failed-ingest cleanup decisions and status snapshots to the facade and handles
- CI: fail hung tests with a per-test timeout
- Bump compose images to 0.8.1