AgenticX v0.3.8
AgenticX v0.3.8
Published Python package: agenticx==0.3.8
Installation
pip install -U agenticx==0.3.8PyPI
Highlights
New capabilities and integrations introduced since v0.3.7, grouped by module.
-
Core / Runtime — Group Chat & Workforce
routing="team"now bridges directly intoWorkforcePattern, with a new open-call heuristic in the group router and richer tool-progress details- Workforce auto-dispatches on complex prompts — no
/teamprefix, no UI toggle required - New
task_experiencetools surfaced to group agents for cross-turn memory
-
Desktop / Electron
- Focus Mode: full lifecycle, state restoration, and a frosted composer layout that prevents control overlap
- Lite mode deprecated; Pro is now the default and only experience (welcome page removed)
- New API model picker workflow and improved model list UI
- Chat Markdown code blocks render with Prism syntax highlighting and theme
-
MCP
- Unified MCP settings panel with Monaco editor and three sub-panels (servers / brand / market)
- Local brand discovery with JSON Schema validation, plus new Studio APIs
/api/mcp/discover,/api/mcp/raw,/api/mcp/marketplace - Per-tool granular disable, with the default-MCP skip list persisted outside
mcp.jsonso user choices survive upgrades
-
Knowledge Base
- When Office parsing fails for missing LibreOffice, AgenticX now suggests the correct install command for the user's OS
-
Studio / Server
- Persistent avatar/session model preferences and desktop layout state
- Studio session now tracks per-MCP-server operation state for accurate UI feedback
-
Enterprise (NEW)
- Foundation: AgenticX Enterprise product line bootstrapped, with multi-tenant auth, IAM management, admin onboarding, and a policy-controlled gateway with audit & metering
- Identity & IAM: PostgreSQL-backed IAM core (departments, members, roles, audit events, migration
0005); admin console IAM REST APIs, route RBAC, CSV import templates, drill-down department cards with member filtering; web portal JWT scopes, locked-user kickout, and admin entry - Gateway & Compliance: real-model upstream, embeddings proxy, token-quota tracking, streaming policy errors, context-aware policy hot reload, and dual-write audit (PostgreSQL + JSONL fallback) backed by a PG query store with real RBAC injection
- Policy Rule Center: PG-backed policy service and admin APIs,
EvalContext+applies_tofiltering in the policy engine, separated publish/disable scopes, and a full admin UI workflow for rule packs - Web Portal: modern minimalist chat UX inspired by leading AI tools — message actions, session title editing, query/retry version branching, persistent thinking-chain, multi-session isolation, server-synced chat history backed by tenant-safe PostgreSQL tables
- Admin Console v2: vben-style AppShell, dashboard KPIs, IAM CRUD, audit/metering, model service & user-visible model assignment, policy packs, token quota management
- Design System: Machi v2 foundation — oklch tokens, dual-theme fix, 10 new shadcn primitives shared across portal and admin console
- Plugins: minimal
doc-reviewand PDF watermark CLIs added under enterprise plugins
-
Packaging / Deploy
- One-command local middleware startup script + docs for running the enterprise stack end-to-end
- Production
docker-composeskeleton aligned with gateway config and shared runtime, plus ingress notes - One-command local data reset workflow for development
Fixes & Improvements
Bug fixes, stability hardening, and visible UI/UX polish since v0.3.7.
-
Core / Runtime
- Bounded exploratory progress and lazy session creation so long workspaces no longer accumulate unbounded state
-
Desktop / Electron
- Stability fixes around app startup: no duplicate main windows on macOS, IPC handlers register before renderer requests, wait for Studio before listing avatars/sessions, fallback for model-less active pane
- New chats are no longer auto-restored into a running session; cross-session message bleed eliminated
- Lazy session creation lets workspaces bind before the first message is sent
- Solid base color for dark/dim themes regardless of OS theme; portable & resilient recommended-skill icons
- Group editor save flow stabilized; Cancel grouped next to Save in footer
- Composer: input-bar overflow fix and group-chat barge-in / streaming-stop reliability
-
MCP
- No more stale "connected" state; clear error when the SDK is missing
- Support immediate cancel while connecting
- Editor flicker (per-second redraw) eliminated; scan-discovery UI removed; Ctrl+S save and centered toast added
- Improved marketplace search and card information display
- Fixed startup failure when MCP commands are missing in packaged bundles
-
Knowledge Base
- Reopening the resource panel during an in-flight ingest now shows real-time progress instead of a blank state
- Parse-failure errors actually log root cause (no more bare
'_type'); self-heal corrupted Chroma persistence directories and tenant compatibility errors; deletion failures fixed - Filter
Nonemetadata before vector write so PDF/DOCX chunks without char offsets no longer crash ingestion - Cross-loop session reuse for
BailianEmbeddingin the desktop runtime
-
Studio / Server
- Group chat execution state management corrected so transitions stay consistent across cancel/retry
-
Enterprise
- Policy Center hotfixes: RBAC, snapshot CAS, publish transaction, draft-test flow stabilized, request-phase compliance only evaluates the current user input
- Gateway: policy override reload, SSE error propagation, quota lock, and stream settle on cancel
- Token-usage metering: fixed double root cause that left the counter at 0
- Audit: chain validity returned without throwing; corrupt JSONL lines are skipped instead of breaking the reader
- Web portal chat: hardened history sync with dev-DB fallback, stale session-switch race fixed, taller InputArea, retry button in message actions, right-aligned user bubbles, message area aligned with input box, empty reasoning/toolcall blocks suppressed, share hidden until messages exist
- Admin console: sticky sidebar on large screens, accessibility & React-key warnings cleaned up, quota/policy paths configurable via env, seed user IDs aligned with portal/DB ULID system
- Auth & build: graceful handling of schema drift and DB errors; resolved client boundary for
iam-coreimports - Visual polish: Machi auth pages density and copy, top-bar badges removed with larger welcome avatar, Gateway online indicator restored, global focus-ring cleanup across textareas and inputs, sidebar icons centered when collapsed
- Plugins:
doc-reviewreturns anissuesfield, PDF watermark CLI emits safe JSON
-
Packaging / CI
- Desktop bundle now ships the full PDF/Office parsing stack (
chromadb,pypdf,PyMuPDF,python-docx,python-pptx,numpy,onnxruntime) pluspython-multipart— packagedagx-serverno longer crashes on startup and KB ingestion works out-of-the-box (closes #10) - CI security keyword scan:
set -uand pipeline exit-code fixes, switched to scanning only changed files
- Desktop bundle now ships the full PDF/Office parsing stack (
Stats
- Commits: 162 commits over 17 days (2026-04-19 → 2026-05-06)