AgenticX v0.3.10 + AgenticX Enterprise v0.2.1 + AgenticX Desktop(Near) v0.2.1
AgenticX v0.3.10
Published Python package: agenticx==0.3.10
Installation
pip install -U agenticx==0.3.10PyPI
Highlights
-
Core / Runtime
- Tool-loop context budget control: decay and archive oversized tool results (M1), add reference parameters (M2), and introduce
skill_import_repo(M3) so long multi-tool runs stay within context limits. - Long-task signals end-to-end: surface termination and compaction events, plus enriched
token_budget_exceededevents with configurable resolution for automation and unattended runs. - Force an LLM retry next round when streamed tool calls are truncated mid-stream.
- Teach prompts to plan todos at milestone granularity and suppress ghost todo progress cards on document-only turns.
- Default meta-agent and IM replies to the new Near brand (Python side); shared Near brand constants for both TS and Python.
- Tool-loop context budget control: decay and archive oversized tool results (M1), add reference parameters (M2), and introduce
-
Studio / Server
- Unified session continue API with an unattended supervisor for resuming stalled long-running sessions.
- Preserve interrupted execution state when chat turns fail mid-run, so resumes pick up cleanly.
-
Skills / Tools / Project State
code_devharness with a 4-layer context model and explicit phase gate for structured coding workflows.- Disk-backed project state store with
feature_loopruntime mode, bundled skills, and a read-only Studio API + CLIresumefor resumable feature work.
-
Knowledge Base / Code Search
- Multi-brain knowledge architecture MVP: scoped brains and relocated brain scope, with
code_searchgated on mounted brains. - Semble-backed
code_searchPoC with lifecycle tools, offline error tests, evaluation runner, Studio HTTP routes, and serve-time model preload.
- Multi-brain knowledge architecture MVP: scoped brains and relocated brain scope, with
-
Packaging
- New optional
[semble]pip extra so users can opt in to Semble-backed code search without forcing the dependency on the core install.
- New optional
Fixes & Improvements
- Core / Runtime
- Downgrade non-initial system messages for the MiniMax provider to avoid upstream 400s on multi-turn conversations.
- Detect colon-truncated unfinished output and fix unattended-resume misfires on those turns.
- Keep todo cards live and stop stall flicker on long tasks.
Stats
- Commits: 122 commits in the full v0.3.9 → v0.3.10 window (2026-05-18 → 2026-05-25); ~30 of them touch the agenticx Python core listed above.
Full Changelog
AgenticX Enterprise v0.2.1
This release ships the enterprise control plane (admin-console, web-portal, gateway, DB) for self-hosted deployments.
Installation / Upgrade
Follow the upgrade steps in enterprise/README.md; for local dev:
bash enterprise/scripts/start-dev-with-infra.shThis release adds new gateway tables (channel relay, PAT, MCP hosting, WASM plugins, audit fields) — make sure to run pnpm -C enterprise db:migrate (and the legacy-runtime migrator) before starting the upgraded admin/portal/gateway processes.
Highlights
-
Enterprise Gateway
- New channel relay stack: upstream channels with per-key health, cooldown TTL, and key-level failover within a channel; admin console for channel/edit/probe and AC integration tests.
- Multi-protocol inbound/outbound: Claude Messages, Gemini
generateContent, OpenAI Responses (minimal), with reasoning-effort suffix and thinking-stream transform; unified error map and audit across all protocols. - Quota engine across tenant / department / user / PAT scopes for TPM, RPM, and concurrency.
- AI response cache with cache-token billing and observability hooks.
- Hosted MCP servers backed by OpenAPI: new DB schema with audit fields, gateway hosting runtime, and an admin console for managing MCP servers end-to-end.
- WASM plugin runtime for gateway: plugin manifests, ops hooks, structured error fingerprinting, and an admin UI surfacing plugins, errors, perf, and channel probes.
-
Enterprise Admin & Portal
- Personal Access Tokens (PATs) for gateway authentication, including the admin "API Tokens" page and registered PAT migrations.
- Gateway wired to admin PG model providers, with a unified "save model" UX between admin and gateway-resolved configurations.
- zh / en i18n rolled out across admin-console and web-portal.
Fixes & Improvements
-
Enterprise Gateway
- Resolve gateway token from the token file (no more relying on stale env-injected tokens).
- Centralize runtime legacy JSON → Postgres migration so admin / portal / CLI share the same path.
-
Enterprise Admin
- Repair the model-providers PG migration loop that could re-run on startup.
- Restore the API key reveal control on the models settings page.
- Stable, unique React keys in the WASM plugins list (no more list-key warnings / re-render glitches).
- Redirect to login when an admin session expires instead of silently failing API calls.
- Fill missing common i18n keys and trim nav session checks so navigation no longer flashes English placeholders.
- Refined command palette and sidebar chrome; polished admin dashboard shell visuals.
- New
Switchcomponent used on the admin cache page.
-
Enterprise Portal
- Chat works again when gateway is down (graceful failure instead of hard error); fixed local dev startup order so portal doesn't race ahead of gateway.
- Chat auth sync, IME composition guard on inputs, and proper code-block syntax highlighting in chat.
- Session sidebar order stays stable when switching sessions.
- Defer chat session persistence until the first user message — no more empty "新对话" placeholders polluting history.
- Show the active session model name when the user has no global model assignment.
-
Build & Deploy
- Break the
@agenticx/auth↔@agenticx/iam-corecycle that prevented Vercel turbo builds from succeeding. - Start local dev without turbo workspace discovery to avoid
set -u/ unbound-variable failures. - Pin Vercel install / build to pnpm 9 via npx for reproducible CI.
- Switch dev server to Turbopack for faster HMR; fixed workspace dep gaps that surfaced under Turbopack.
- Docker preflight & daemon-stuck troubleshooting runbook for local infra setup.
- Break the
Stats
- Commits: 51 enterprise commits over 7 days (2026-05-19 → 2026-05-25)
Full Changelog
Machi Desktop v0.2.1
Note: The Desktop app has been renamed from Machi to Near in this release. The on-disk package name (
@agenticx/desktop) and binary name remain unchanged; only the user-visible product name, window title, tray label, and meta-agent display name have changed.
Installation
Download the new build from GitHub Releases (no auto-update channel yet):
- macOS:
Near-0.2.1-arm64.dmg/Near-0.2.1-x64.dmg - Windows:
Near-Setup-0.2.1.exe(NSIS) - Linux:
Near-0.2.1.AppImage
Highlights
-
Branding: Machi → Near
- App, window title, and tray relabeled to Near; UI copy swapped to Near with legacy-name compatibility so existing sessions, avatars, and config keep working.
- Refreshed sidebar brand row with version badge.
-
Long-Task Resilience & Stall Recovery
- Surface long-task termination and compaction signals directly in chat, so users know when context was trimmed.
- WorkBuddy-style sticky task bar for long tasks, with anti-hallucinated tag rendering; works for sub-agents and history-loaded sessions.
- Local stall detection with execution-aware stop policy; new stall-recovery UI with auto-nudge, achieving Lite parity.
- Stall recovery routed through the unified session continue API and unattended UI, with the warning threshold exposed in Settings → 工具.
-
Context Budget Awareness
- Context stats chip (M5) showing per-session token usage, plus M4 anchor restrengthen to keep important early context alive across long runs.
- New
BudgetExceededCardwith resume-draft flow when the model exceeds the configured token budget; token budget limits configurable in Automation settings.
-
Knowledge Base / Code Index UI
- Settings panel for the multi-brain knowledge architecture, including draggable / resizable panel layout.
- Brain settings scope panel and code-index UX integrated into Desktop; Semble-backed code-search settings panel with
code_devprompt hints.
-
Chat UX
- Message queue composer: queue follow-up messages while the assistant is still streaming, instead of blocking input until the turn ends.
- Read-only Studio API surfaced as a Desktop panel for resuming long-running feature work (
project_state). - Knowledge-base toggle relocated to the top-right corner of the title bar for easier access.
Fixes & Improvements
-
Windows / Linux
- Fix main window appearing black / invisible on Windows startup.
- Remove the duplicate native title bar on Windows; hide native menu bar on Windows and Linux for a cleaner shell.
-
Chat & Rendering
- Normalize spaced LLM bold markers before Markdown render so
* * bold * *style output displays correctly. - Polish Markdown bold and context-budget notices in the message list; tighten vertical spacing in the Machi/Near message list.
- Close interrupted turns to prevent context bleed between aborted and new turns.
- Show
StreamingDotswhile Meta is in a pending-work state (no more "frozen" empty bubbles). - Detect colon-truncated unfinished output and fix unattended-resume misfires on those turns.
- Normalize spaced LLM bold markers before Markdown render so
-
Multi-Pane & Sessions
- Preserve the avatar pane's selected model on lazy session bind (no more silent model resets).
- Show the stop button in a sub-agent pane while its delegated task is still running.
- Keep todo cards live and stop stall flicker on long tasks; suppress ghost todo progress cards on document-only turns.
-
Settings & Panels
- Persist light/dark theme across app restarts.
- MCP settings page now lists configured servers even when there is no active session.
- Token dashboard sidebar and daily table UX refined; Gauge icon used for the token dashboard button.
- Improved stop-interrupt and stall-recovery UX.
- Silenced noisy
check_resourcestool progress events in the conversation. - Sticky task bar accent colors aligned with the active theme; long-task stall / resume split into nested sub-panels.
- Message queue composer visual polish; unified clock icon for scheduled tasks.
-
Runtime
- Bumped Electron to 34.5.8.
Stats
- Commits: 49 desktop commits over 7 days (2026-05-18 → 2026-05-25)