Changelog

v0.3.4

All notable changes to @syncagent/js and @syncagent/react.

v0.3.4

latestMay 14, 2026

Bug fixes, new features across all SDKs, and Vue/Angular version alignment

FixbaseUrl config was ignored — always used hardcoded URL. Now correctly respects user-provided baseUrl for development/self-hosted setups.
FixReact Provider useMemo only tracked apiKey/connectionString — now detects changes to filter, operations, language, and all other config options.
FixVue composable mutated placeholder message object directly — now uses separate streaming variable for clean reactivity.
FixReact hook stale isLoading closure could allow double-sends — now uses ref to check current value.
Newcontext field added to ChatOptions type — TypeScript users now get autocomplete for context in chat options.
NewonMessage callback in ChatOptions — fires for each complete message, useful for logging/analytics.
NewgetSchema() now retries once on network errors — matches the retry behavior of chat().
NewConnection string validation — warns on unrecognized format at construction time (doesn't throw, just console.warn).
NewsetMessages exposed from React useSyncAgent and Vue useSyncAgent — lets users hydrate conversation history from their own backend.
NewAngular: isConfigured signal — templates can disable inputs until configure() is called.
NewAngular: onError and onStatus callbacks in SyncAgentServiceConfig — log errors to Sentry/etc without subscribing to observables.
NewVue: onStatus callback in useSyncAgent options — react to status changes without watching the ref.
NewdetectPageContext() now exported from all framework packages (@syncagent/react, @syncagent/vue, @syncagent/angular, @syncagent/nextjs).
ImprovedDeduplicated request body construction in JS SDK — extracted buildRequestBody() helper to prevent drift between retry paths.
ImprovedVue and Angular packages bumped from 0.1.0 to 0.3.4 — all packages now share the same version number.
ImprovedAll package.json files now include homepage and repository fields for better npm discoverability.
ImprovedREADME files updated across all packages with Get Your API Key section, pricing table, supported databases, and links to docs.

v0.3.3

April 15, 2026

System instructions, write confirmation, language, maxResults, sensitive fields, middleware hooks & bug fixes

NewsystemInstruction config — customize the agent's personality, tone, domain rules. Prepended to system prompt with priority.
NewconfirmWrites config — agent describes write operations and waits for explicit user confirmation before executing
Newlanguage config — agent responds entirely in the specified language (French, Spanish, Japanese, etc.). Field names stay in English.
NewmaxResults config — configurable default query limit (default 50). Set lower for mobile, higher for dashboards.
NewsensitiveFields config — specify which fields the agent masks. Default: password, token, secret.
NewonBeforeToolCall / onAfterToolCall middleware hooks — intercept client tool calls for logging, audit, or dynamic blocking
NewVanilla JS widget now supports filter, context, systemInstruction, language, and confirmWrites
Fixdatabase_overview now always counts live from DB instead of using stale cached schema counts
FixReact hook streaming no longer mutates state objects directly — uses ref-based accumulator
NewAutomatic retry on network errors — 1 retry with 1s delay on fetch failures (not on HTTP errors or aborts)

v0.3.2

April 8, 2026

Auto page detection, structured context, and multi-tenant filter fixes

NewAuto page detection — SDK automatically detects currentPage, currentPath, currentRecordId, and query params from window.location on every message
NewdetectPageContext() exported from @syncagent/js — works in React, Vue, Angular, Next.js, and vanilla JS (SSR-safe)
NewautoDetectPage config option (default: true) — set false to disable auto-detection
NewContext sent as dedicated field in request body and injected into AI system prompt as structured USER CONTEXT section
FixMongoDB parseFilter now converts ALL ObjectId-like strings (not just _id) — fixes multi-tenant filters returning 0 results
FixMongoDB aggregate now parses ObjectId strings in $match stages — fixes scoped aggregations returning empty
FixAll SQL connectors (PostgreSQL, MySQL, SQLite, MSSQL, Supabase) now apply $match stages as WHERE clauses in aggregations
FixSupabase count now handles operator filters ($gt, $lt, etc.) instead of silently dropping them
Fix7 advanced tools now respect mandatory filter — field_distribution, find_duplicates, sample_data, collection_stats, database_overview, get_distinct_values, copy_collection
Fixraw_query and rename_collection disabled in multi-tenant mode — they bypassed tenant scoping
Fixcross_search no longer uses $regex (broke SQL connectors) — uses universal scoped approach
FixDead code bug: __sa_data emission was after a return statement — onData callback now fires correctly

v0.3.1

April 5, 2026

Tools-only mode — use the agent with only your custom tools, no database required

NewtoolsOnly config option — disables all built-in database tools so the agent only calls your custom tools
NewconnectionString is now optional when toolsOnly is enabled — no DB connection needed
NewDedicated tools-only system prompt that instructs the agent to exclusively use client-provided tools
NewServer skips DB connection, schema discovery, and schema refresh entirely in tools-only mode
ImprovedEdge case handling — toolsOnly without tools gracefully falls back to requiring connectionString
ImprovedDocumentation updated across all SDK READMEs and the docs page with tools-only examples

v0.3.0

April 2, 2026

TypeScript intellisense fix & package exports

FixTypeScript intellisense — full autocomplete and Go-to-Definition now works out of the box
Fixpackage.json exports pointing to wrong file paths (.cjs → .js to match tsup output)
NewtypesVersions fallback for all moduleResolution settings (node, node16, nodenext, bundler)
NewConditional types in exports — separate .d.mts for ESM and .d.ts for CJS
ImprovedSchema cache TTL reduced from 1 hour to 5 minutes for faster schema change detection
NewAuto schema refresh — when a tool hits a 'collection not found' error, the agent automatically re-discovers the schema and retries

v0.2.9

April 2, 2026

Modern UI overhaul for the chat widget

NewTables with accent-colored headers, zebra striping, rounded corners, and hover highlights
NewCode blocks with language label header and inline copy button
NewBar chart with value labels, gradient bars, grow animation, and total count
NewStatus bar with SVG spinner, shimmer animation, and orchestrator event badges (retrying, healing, recovered, failed)
NewRedesigned welcome screen with 2×2 capability cards
NewActionBtn component for consistent action button styling
NewError banner with gradient background, icon box, and two-line layout
NewRounded square FAB with stronger shadow and spring animation
ImprovedMarkdown renderer: proper numbered lists, accent-colored bullet points, blockquotes with tint
ImprovedTypography: better heading sizes, link hover effects, improved line height

v0.2.8

April 2, 2026

Token management & empty response prevention

NewServer-side token estimation — auto-compacts conversation when context exceeds ~27k tokens
NewEmpty response detection with automatic retry using trimmed context
NewonAction callback in JS SDK for context_warning, context_compacted, force_compact events
NewClient-side Compact History button wired to server-driven alerts
Fixraw_query params schema — z.any() replaced with explicit union type for OpenAI validation
FixRemoved dynamic tools that caused OpenAI schema validation 400 errors
FixEmpty response detection was checking protocol prefixes in plain text stream

v0.2.7

April 2, 2026

Power tools, self-healing orchestrator & autonomous agent

New18 advanced database tools: bulk ops, index management, field analysis, cross-search, data health check, and more
NewSelf-healing orchestrator — auto-retries failed tools, uses AI to analyze errors and return recovery hints
NewMongoDB, PostgreSQL, MySQL connectors upgraded with rawQuery, listIndexes, createIndex, bulkDelete, findDuplicates, and more
NewAutonomous agent system prompt — chains tools, never stops on errors, uses power tools aggressively
ImprovedStep limit increased from 50 to 80 for longer tool chains
ImprovedAdvanced tools receive mandatoryFilter for multi-tenant scoping

v0.2.6

April 2, 2026

SDK updates & documentation improvements

NewUpdated SDK packages with latest agent improvements
ImprovedDocumentation page code examples with view/copy functionality
FixCode block display on docs page

v0.2.4

April 1, 2026

Multi-database connector support

NewSQLite connector with WAL mode support
NewMSSQL (SQL Server) connector with parameterized queries
NewSupabase connector via REST API with two connection string formats
ImprovedConnector factory pattern — createConnector() auto-selects the right driver

v0.2.3

April 1, 2026

Widget endpoint & SDK packaging fixes

NewWidget API endpoint (/api/v1/widget) for embeddable chat
FixSDK build output and packaging issues

v0.2.2

April 1, 2026

Documentation & SDK refinements

ImprovedDocumentation page with Quick Start, React SDK, JS SDK, Node.js, Custom Tools, and REST API sections
ImprovedSDK README files with usage examples

v0.2.1

April 1, 2026

New features & agent improvements

NewWebhook system for real-time event notifications
NewTeam management with role-based access
NewAnalytics panel with request logging
ImprovedAgent query handling and response quality

v0.2.0

March 31, 2026

Major feature release — chat widget, multi-tenant filter, client tools

NewFloating chat widget with slash commands, suggestions, history, and pinned messages
NewMandatory filter support — scope all queries to a tenant (multi-tenant SaaS)
NewClient-side custom tools — define tools that execute in the user's browser
NewOperations restriction — limit agent to read/create/update/delete per session
NewStructured data streaming (__sa_data events) for charts and tables
NewStatus streaming (__sa_status events) for real-time progress indicators

v0.1.9

March 31, 2026

Schema caching & agent prompt improvements

NewSchema caching — 1-hour TTL, reduces discovery overhead on every request
ImprovedSystem prompt with date context, business metric patterns, and smart field mapping
ImprovedAggregation pipeline support for MongoDB with $group, $sort, $limit, $lookup

v0.1.8

March 31, 2026

React SDK chat component

NewSyncAgentChat React component with floating and inline modes
NewuseSyncAgent hook for custom chat UIs
NewSyncAgentProvider context for shared client instance
NewMarkdown rendering with tables, code blocks, lists, and headings

v0.1.7

March 31, 2026

Advanced agent features

NewAdvanced tools: bulk_insert, bulk_update, explain_query, get_distinct_values, sample_data, validate_query, get_collection_stats
NewDatabase-specific query guides (MongoDB, PostgreSQL, MySQL, SQLite, MSSQL)
ImprovedSystem prompt with self-healing strategies and error recovery instructions

v0.1.6

March 31, 2026

Agent prompt & clear cache

NewClear schema cache action for forcing re-discovery
ImprovedAgent system prompt with conversation continuity, pagination, and proactive insights
ImprovedNumber and currency formatting in agent responses

v0.1.5

March 31, 2026

Prompt improvements

ImprovedAgent prompt with smart field name mapping and relationship inference
ImprovedBetter handling of ambiguous boolean/status values
ImprovedData validation before write operations

v0.1.4

March 31, 2026

Agent prompt refinements

ImprovedSystem prompt with bulk operation safety, cross-collection search, and schema-aware suggestions
ImprovedError recovery with 5 fallback strategies

v0.1.3

March 31, 2026

Database connection fix

FixDatabase connection error when connection string was missing database name
NewMongoDB auto-database selection — scans all databases to find the right one

v0.1.2

March 31, 2026

Error handling improvements

FixVarious connection and query error handling improvements
ImprovedBetter error messages for common failure scenarios

v0.1.1

March 31, 2026

Initial bug fixes

FixSDK build configuration and export paths
FixStream parsing for status and data events

v0.1.0

March 31, 2026

Initial release

NewSyncAgent platform — AI-powered database agent as a service
NewDashboard with project management, API key generation, and usage analytics
NewChat API endpoint (/api/v1/chat) with streaming responses
NewMongoDB connector with schema discovery, CRUD operations, and aggregation
NewPostgreSQL connector with parameterized queries and aggregation translation
NewMySQL connector with full CRUD and aggregation support
New@syncagent/js — JavaScript SDK with streaming chat client
New@syncagent/react — React SDK with provider, hook, and chat component
NewAI agent with tool-calling: query, count, aggregate, create, update, delete
NewCollection-level access control (allowed/blocked collections)
NewOperation-level permissions (read, create, update, delete)
NewAPI key authentication with request logging
NewPaystack billing integration with subscription plans
NewRate limiting — 5 concurrent requests per API key
NewConnection pooling with 2-minute cache TTL
NewLanding page, pricing, docs, privacy policy, terms of service, and contact page