v0.9.5 - AI Autonomous Tools, Threads Modernisation & Template Refinements
Highlights
docmd v0.9.5 delivers autonomous AI assistant agent tools with an expanded 200k context window, a complete redesign of the collaborative Threads plugin with right-docked handle and inline comment previews, template UI refinements across Summer and Default templates, and OpenAPI multi-project workspace path resolution.
AI Assistant Agent Tools & Extended Context Window (@docmd/plugin-ai & docmd-assistant)
- Autonomous MCP Tool Suite: Integrated five client-side autonomous tools directly into the browser assistant runtime:
get_site_structure: Inspects the site’s complete version trees (current and historical), supported locales, project boundaries, and page hierarchy.search_documentation: Queries documentation pages with full-text keyword matching and optional semantic vector search.read_documentation_page: Fetches and reads clean, structured Markdown prose from any page across workspace boundaries.navigate_to_page: Smoothly navigates visitors directly to relevant documentation chapters and subsections.copy_code_snippet: Extracts code blocks and command snippets directly to the visitor’s clipboard with visual feedback.
- Uncapped Context Window (200k Default): Eliminated hardcoded 15,000 and 40,000 character truncation bottlenecks. The engine now passes full retrieved documentation context (up to 200,000 characters by default) for comprehensive technical explanations and complete configuration examples.
- Configurable
contextWindow: Added optionalcontextWindow(orcontextLimit) option toplugins.aiconfiguration, allowing projects to tailor context sizes for specific token quotas or cost optimisation. - Enhanced Code Block UI: Refined assistant markdown code rendering with syntax highlighting, language badges, and one-click copy buttons.
- Cloud Relay Telemetry & Query Analytics Fixes: Fixed an issue where multi-turn autonomous tool execution repeatedly logged internal follow-up turns in Cloud analytics, and fixed stray quote prefixes on longer queries.
Threads Collaborative Discussion Plugin (@docmd/plugin-threads)
- Card Persistence on Sidebar Reopen: Replaced mutable DOM node re-parenting with decoupled in-memory rendering and CSS-driven preview toggling (
body.tc-panel-open .threads-thread--inline). Thread cards remain permanently visible and persistent across open/close/reopen cycles. - Zero-Reload Commenting & Replying: Adding new threads, replying, and resolving now operate strictly in-place with immediate UI updates, eliminating full-page browser reloads.
- Redesigned Inline Comment Preview: Sleek inline preview card below highlighted text featuring an anchor quote badge (
"...") and an “Open in sidebar” link that smooth-scrolls and highlights the thread in the panel. - Right-Docked Slide Tab: Moved
.threads-fabto a slide tab docked attop: 50%; right: 0, completely avoiding collisions with.summer-totopand the bottom AI prompt trigger. - Modern Stroke Iconography: Overhauled plugin icons to match docmd’s core aesthetic with Lucide/Feather stroke SVGs (
messages-square,quote,external-link,reply,trash,plus,check,x). - Summer & Default Template Styling: First-class design token inheritance across Default and Summer templates (
--summer-surface,--summer-border,--summer-accent, etc.). - Hover-Revealed Heading Actions: Redesigned the “+ New Thread” button on section headings to reveal smoothly upon heading hover or keyboard focus, eliminating visual clutter.
OpenAPI Plugin Enhancements (@docmd/plugin-openapi)
- Multi-Project Workspace Resolution: Resolved specification file lookup in complex workspaces and subprojects (e.g.
assets/docmd-api.jsonwithin sub-site directories). The plugin now checks the active markdown file’s directory, project boundary root, and workspace root automatically. - Download Button Respects Config: Fixed the OpenAPI download button to honour
download: trueand emit root-relative download links. - Inline OpenAPI Specifications: Fenced blocks tagged with
```openapinow directly accept raw JSON or YAML OpenAPI specifications embedded in the markdown file without requiring a separate external file. - Robust Error Diagnostics: Missing or invalid spec paths now surface clear, contextual
.oa-errorcallouts in development builds instead of silent rendering fallbacks.
Live Server Manifest Capability & Universal Runtime Detection (@docmd/api)
requiresLiveServerManifest Capability: Plugins that depend on an active live development server RPC bridge (such as collaborative editing, hot file persistence, or live commenting like@docmd/plugin-threads) can now declarerequiresLiveServer: truein their plugin descriptor (PluginDescriptor) and package manifest (package.json#docmd.requiresLiveServer).- Zero-Overhead Static Builds: During static production builds (
docmd build), docmd automatically omits client-side scripts, meta tags, and style assets for live-only plugins while keeping markdown container and syntax parsing intact. Static production sites remain completely lightweight, zero-overhead, and error-free without missing markdown formatting. - Universal Live Server Detection (
docmd.isLive()&docmd.ping()): Added built-in live server status checking to the@docmd/apibrowser client and dev server RPC bridge. Client plugins can calldocmd.isLive()for synchronous WebSocket connectivity status, orawait docmd.ping()for an end-to-end heartbeat with the server’s built-insystem:pingaction handler.