Settings \u2192 StoreGauge AI shows the most recent audit events. Entries are stored as private records in your own database and pruned automatically after 30 days. Developers can change retention with the storegauge_audit_retention_days<\/code> filter (set it to 0 to disable pruning).<\/p><\/dd>\nWhere are my conversations stored?<\/h3><\/dt>\nIn your own site's database \u2014 never on our servers and never in the cloud. Each wp-admin user sees their own conversation; it is trimmed to the last 50 messages and pruned after 30 days. The \"\uff0b\" button in the chat starts a fresh one.<\/p><\/dd>\n
Can it read images?<\/h3><\/dt>\nYes, when the selected model supports vision (look for the Vision badge in the model dropdown). Attach a product photo and ask for a description or alt text; plain-text files (.txt, .csv, .md, .json) are also supported.<\/p><\/dd>\n\n<\/dl>\n\n\n
0.8.9<\/h4>\n\n\n- Gross profit now also reports covered_revenue, the part of revenue that actually has a recorded cost. The margin is calculated from that figure, and the result now says so explicitly, so an assistant connecting over MCP cannot misread the margin as a share of total revenue.<\/li>\n<\/ul>\n\n
0.8.8<\/h4>\n\n\n- The setup reminder now also appears if you remove your last connected AI provider later, not only on a brand-new install.<\/li>\n<\/ul>\n\n
0.8.7<\/h4>\n\n\n- The chat assistant is now available as soon as you activate the plugin, and if no AI provider is connected yet it opens with a single button that takes you straight to the settings screen. Connecting an external AI agent over MCP is still opt-in.<\/li>\n<\/ul>\n\n
0.8.6<\/h4>\n\n\n- The installation instructions now spell out that the WordPress MCP Adapter is required only for connecting an external AI agent, that it can be added in one click from the settings screen, and that the chat assistant does not need it.<\/li>\n<\/ul>\n\n
0.8.5<\/h4>\n\n\n- Privacy fix: replies no longer cause WordPress to load emoji images from WordPress.org. The assistant writes emoji often, and WordPress was turning each one into a request to its own servers \u2014 one reply measured eleven of them, revealing the shop manager's IP address to a third party. Emoji still display, using your system's own characters. No images are loaded from anywhere outside your site.<\/li>\n<\/ul>\n\n
0.8.4<\/h4>\n\n\n- Replies render more of the formatting the assistant uses. Task lists (\"- [ ] add your costs\") now show real checkboxes instead of raw brackets, nested lists keep their structure instead of flattening, and a plain typed web address becomes a clickable link.<\/li>\n
- An image in a reply is shown as a normal link rather than loading the remote picture. This keeps the promise that StoreGauge makes no external requests from your admin.<\/li>\n<\/ul>\n\n
0.8.3<\/h4>\n\n\n- Fixed: raw markdown syntax showing in replies. A heading that the assistant ran onto the end of a sentence (\"I'll pull the data.## Best day\") displayed its ## markers instead of a heading, and a stray escaped asterisk (*) appeared literally when the assistant left emphasis unclosed. Headings are now recognised mid-line and stray escapes are cleaned up. Ordinary text containing a # is unaffected, and code is untouched.<\/li>\n<\/ul>\n\n
0.8.2<\/h4>\n\n\n- Fixed: the Copy for LLM prompt split the Windows Claude Desktop config path across a line break, so an assistant following it received a broken path. The prompt also now lists all 14 abilities including gross profit.<\/li>\n<\/ul>\n\n
0.8.1<\/h4>\n\n\n- Fixed: gross profit and the other period tools disagreed on revenue whenever a refund existed. Gross profit nets refunds, because a refunded sale is not revenue and WooCommerce does not rewrite the stored cost snapshot either, while the revenue, daily and category tools report revenue before refunds. Rather than leave two different revenue figures unexplained, every gross profit answer now also returns revenue_gross and refunded, so the two reconcile exactly.<\/li>\n<\/ul>\n\n
0.8.0<\/h4>\n\n\n- New: realised gross profit. The assistant can now report what the store actually made over a period, per month, using the cost (COGS) snapshot WooCommerce stores on each order when it is paid, rather than today's catalogue prices.<\/li>\n
- Profit is only ever calculated on order lines that have a recorded cost. Every answer carries a coverage percentage alongside the profit, and revenue on lines with no recorded cost is reported separately and excluded, because its cost is genuinely unknown. When no line has a cost, the assistant says the records are missing instead of reporting zero profit.<\/li>\n
- Coverage is assessed per order line rather than per order, so an order mixing a costed and an uncosted product is never counted as fully costed.<\/li>\n
- Refunds are netted out of both revenue and cost for the period.<\/li>\n<\/ul>\n\n
0.7.11<\/h4>\n\n\n- The assistant no longer invents totals it cannot support. Asked \"so what profit would that have been?\" it used to multiply a margin percentage by revenue and present the result as a rough estimate, and it could also subtract its way to a COGS figure. Both are now forbidden outright, even when labelled rough, ballpark or indicative: when the data cannot support a total, the assistant says so, names what is missing, and stops.<\/li>\n<\/ul>\n\n
0.7.10<\/h4>\n\n\n- Top sellers now accepts a day range like the other period tools (1-365, default 30). It previously reported 30-day numbers no matter what a client asked for, because the window was hardcoded and the parameter was not declared.<\/li>\n<\/ul>\n\n
0.7.9<\/h4>\n\n\n- The Copy for LLM prompt now states in one line that the endpoint also lists WordPress and WooCommerce abilities, so the 13 StoreGauge tools are never mistaken for the whole list.<\/li>\n<\/ul>\n\n
0.7.8<\/h4>\n\n\n- Fixed: all period tools (revenue, daily sales, categories, top sellers\/customers, refunds) now share one reporting window of N calendar days including today, so their totals always reconcile; previously the daily chart silently dropped orders paid on the partial first day of the window.<\/li>\n
- Fixed: the refund rate is now measured against PAID orders (the only ones that can be refunded); pending, on-hold and cancelled orders no longer dilute the base.<\/li>\n
- Improved: ability and tool descriptions now state their exact scope (for example inventory value covers stock-managed products only) so assistants do not read different tools as contradicting each other.<\/li>\n<\/ul>\n\n
0.7.7<\/h4>\n\n\n- The connect prompt now carries the hard-won details from a real OpenCode session: desktop CLI path, no hot reload (restart required), \"oauth\": false on remote entries, strip the spaces from the application password before base64, the correct verify command, and an honest inventory of everything the endpoint lists (13 read-only StoreGauge tools + WordPress\/WooCommerce abilities, whose write tools the endpoint refuses; a WordPress user without edit rights makes that permanent).<\/li>\n<\/ul>\n\n
0.7.6<\/h4>\n\n\n- Fixed: UI alignment polish \u2014 provider logos are now identical in size (the Google tile grew 2px from its border), action buttons line up across cards, icons sit centered in buttons and pills, and chat bubbles are exactly the same width.<\/li>\n<\/ul>\n\n
0.7.5<\/h4>\n\n\n- The connect wizard now uses clean, generic line icons (adapter, abilities, credential, actions) and a row of supported client names \u2014 no third-party logos are bundled, by design.<\/li>\n<\/ul>\n\n
0.7.4<\/h4>\n\n\n- The Copy for LLM prompt now also offers the direct Streamable HTTP route (for clients with native remote-MCP support and a custom Authorization header) before falling back to the official stdio proxy, ends with one concrete self-test call, and is shown on the page so you can read it before copying.<\/li>\n
- The wizard now lists what the assistant can do (13 read-only tools) and where each client config lives.<\/li>\n<\/ul>\n\n
0.7.3<\/h4>\n\n\n- Improved: the Copy for LLM prompt now targets the client it is pasted into (Claude Code, OpenCode, Claude Desktop, Cursor), follows each client official config location and CLI syntax, and prefers the user-scope file so the connection works in every project.<\/li>\n<\/ul>\n\n
0.7.2<\/h4>\n\n\n- Fixed: the Copy for LLM button now produces the full setup prompt (a copy error stopped it from working).<\/li>\n<\/ul>\n\n
0.7.1<\/h4>\n\n\n- New: product prices and recorded unit costs are now exposed to external MCP assistants (13th read-only ability).<\/li>\n
- The connect wizard follows the official MCP client configuration formats (one mcpServers config for Claude Desktop\/Claude Code\/Cursor + one for OpenCode), uses copy icons, and can copy a ready-to-paste setup prompt for other AI assistants \u2014 with the application password deliberately left as a placeholder so it never ends up in a chat.<\/li>\n
- The wizard explains that a lost application password can simply be replaced (old ones revoked from the profile).<\/li>\n<\/ul>\n\n
0.7.0<\/h4>\n\n\n- New: Connect AI assistants (MCP) wizard \u2014 one-click install of the official WordPress MCP Adapter, application-password creation, ready-to-paste client configuration for Claude Desktop, Claude Code and Cursor, and a connection test.<\/li>\n
- The wizard detects what is already set up and only asks for what is missing; every step is audit-logged.<\/li>\n<\/ul>\n\n
0.6.4<\/h4>\n\n\n- Fix: charts no longer break on long ranges \u2014 90-day views now render as clean weekly buckets with readable date labels, instead of hairline bars with clipped fragments.<\/li>\n<\/ul>\n\n
0.6.3<\/h4>\n\n\n- Fix: the settings page now shows the reason when a provider cannot be added (for example adding a provider that is already connected) instead of failing silently.<\/li>\n<\/ul>\n\n
0.6.2<\/h4>\n\n\n- New: provider model catalogs auto-refresh once a day when the chat opens \u2014 new provider models appear without a manual reload.<\/li>\n
- New: friendly guard against adding a connected provider twice as a custom provider.<\/li>\n
- Improvement: empty text files and unreadable images are now caught before sending, with clear warnings.<\/li>\n<\/ul>\n\n
0.6.1<\/h4>\n\n\n- New: margin insights \u2014 a 12th read-only ability computes per-product profit margins from recorded unit costs (COGS), with honest counts of products missing cost data and guidance to enable it.<\/li>\n<\/ul>\n\n
0.6.0<\/h4>\n\n\n- Renamed the plugin to StoreGauge AI for WooCommerce.<\/li>\n<\/ul>\n\n
0.5.6<\/h4>\n\n\n- Fix: attaching an unsupported file now shows a clear message about allowed file types instead of the generic API-key error.<\/li>\n<\/ul>\n\n
0.5.5<\/h4>\n\n\n- Fixed: math formulas sent by the AI now render as plain readable text instead of raw LaTeX code, and the assistant is instructed to avoid LaTeX markup altogether<\/li>\n<\/ul>\n\n
0.5.4<\/h4>\n\n\n- Fixed: text domain now matches the plugin slug and all database queries use identifier placeholders (full WordPress.org Plugin Check compliance)<\/li>\n
- Improved: clearer settings screen \u2014 the MCP\/API toggle now explains that an external MCP adapter plugin connects AI assistants, and every access is audit-logged; the chat toggle explains where conversations live<\/li>\n
- Improved: consistent button and input heights across the provider cards, and card action buttons optically aligned with the provider subtitle<\/li>\n
- Improved: the \"Load models from provider\" button now has a tooltip explaining it re-fetches the current list (run it again when a provider adds models)<\/li>\n<\/ul>\n\n
0.5.3<\/h4>\n\n\n- Fixed: removing a model in the settings now immediately removes it from the chat model picker (the picker re-fetches instead of using a page-old list)<\/li>\n
- Fixed: if your saved chat model is removed from its provider, the assistant falls back to another model of the same provider instead of silently using the removed one<\/li>\n
- Fixed: asking the AI to reveal a customer now gets a polite privacy explanation together with the masked data, instead of a bare refusal<\/li>\n
- Fixed: monetary amounts always follow the store currency set in WooCommerce (verified with EUR and USD)<\/li>\n<\/ul>\n\n
0.5.2<\/h4>\n\n\n- Fixed: the quick prompt chips are no longer cut off by their own scrollbar or squeezed on short screens<\/li>\n
- Fixed: wide tables and long date ranges no longer create a horizontal scrollbar that covers the last chat lines \u2014 tables wrap to fit and long ranges shrink the chart bars<\/li>\n<\/ul>\n\n
0.5.1<\/h4>\n\n\n- Fixed: the coupon usage ability silently reported \"no coupons\" on WooCommerce 11, where an API it relied on was removed \u2014 coupons are now listed correctly with their discount type and usage count<\/li>\n
- Fixed: charts now survive a page reload \u2014 the daily-sales series is stored with the message and redrawn on restore, for every provider and model<\/li>\n
- Fixed: replies now reliably follow the language you write in, even for small free models that previously drifted mid-conversation<\/li>\n
- Improved: conversation memory is now safe for every model \u2014 earlier assistant replies no longer re-enter the AI context (weak models copied stale numbers from them or drifted into another language); your questions stay in context and the assistant re-fetches live data for follow-ups<\/li>\n
- Improved: clearer custom-provider form examples (GMI Cloud endpoint) and a generic \"Model name\" hint, since model ids differ per provider<\/li>\n
- Improved: new server icon for custom providers (Lucide, ISC)<\/li>\n<\/ul>\n\n
0.5.0<\/h4>\n\n\n- New: 7 more read-only abilities \u2014 daily sales series (with automatic charts in the chat), top customers (masked), coupon usage, refund rate, review summaries, sales by category, inventory value. The assistant now answers trends, customers, coupons, refunds and inventory questions from real data<\/li>\n
- New: quick prompt chips above the input \u2014 one tap for revenue, sales trend, low stock, top sellers and pricing analysis<\/li>\n
- New: proactive daily briefing \u2014 a badge on the chat bubble shows deterministic findings (stuck orders, stock running out, revenue drops, refund spikes), each with a one-tap follow-up question; findings are computed locally from your database, never invented by the AI<\/li>\n
- Improved: the assistant is now explicitly instructed never to invent or estimate numbers \u2014 when data is missing it says exactly what it cannot see<\/li>\n<\/ul>\n\n
0.4.2<\/h4>\n\n\n- Improved: chat footer alignment \u2014 paperclip, input text and send arrow are now properly centered<\/li>\n<\/ul>\n\n
0.4.1<\/h4>\n\n\n- Improved: full visual redesign of the chat panel \u2014 purple brand header, restyled bubbles, model dropdown, badges, attachment chips with file size, and message timestamps<\/li>\n<\/ul>\n\n
0.4.0<\/h4>\n\n\n- New: multiple AI providers side by side \u2014 connect Google Gemini, OpenRouter and any custom OpenAI-compatible endpoint, each with its own API key<\/li>\n
- New: per-provider model lists \u2014 load the catalog automatically, remove models you don't want, or add models by hand<\/li>\n
- New: the chat model dropdown groups models under each connected provider<\/li>\n
- Improved: providers that disconnect and models the provider can't run are remembered and hidden<\/li>\n
- Improved: existing single-provider setups migrate automatically<\/li>\n<\/ul>\n\n
0.3.2<\/h4>\n\n\n- Improved: the whole chat UI now uses one consistent inline SVG icon set (Lucide, ISC license) \u2014 send\/stop, plus, paperclip, copy, close, chevron and check marks<\/li>\n<\/ul>\n\n
0.3.1<\/h4>\n\n\n- Fixed: models selected from the dropdown now work on providers whose \/models returns prefixed ids (e.g. \"models\/gemini-2.5-flash\")<\/li>\n
- Improved: answers render with smooth typewriter pacing so streaming is always visible, even with very fast models<\/li>\n
- Improved: model dropdown shows chat models first \u2014 non-chat models (TTS, music, robotics\u2026) hide behind \"show more\"<\/li>\n
- Improved: settings field renamed to \"Default model\" with clearer description<\/li>\n<\/ul>\n\n
0.3.0<\/h4>\n\n\n- New: streaming replies \u2014 answers appear live as the AI writes them, with a stop button<\/li>\n
- New: model dropdown in the chat header, with capability badges (Vision, Tools, context size) loaded from your provider's \/models endpoint \u2014 with OpenRouter, one key unlocks hundreds of models. Non-chat models (TTS, music, robotics\u2026) are tucked behind \"show more\"<\/li>\n
- New: attachments \u2014 product photos (vision models) and text files (.txt, .csv, .md, .json)<\/li>\n
- New: conversations persist in your own database, per wp-admin user, with \"new chat\" to clear<\/li>\n
- New: pricing analysis \u2014 the AI can read product prices, sale prices and unit costs (COGS, when recorded) to compute margins and suggest pricing<\/li>\n
- Fixed: customer PII masking now also enforced in the pricing ability<\/li>\n<\/ul>\n\n
0.2.2<\/h4>\n\n\n- New: full Markdown rendering in chat replies \u2014 headings, ordered\/unordered lists, tables, links, inline code, code blocks, blockquotes, bold\/italic\/strikethrough; raw markers never leak into the UI<\/li>\n
- Housekeeping: dev-only files moved out of the release build<\/li>\n<\/ul>\n\n
0.2.1<\/h4>\n\n\n- Security: permission-denied probes from anonymous visitors no longer write audit rows (prevents database flooding via the abilities REST endpoint)<\/li>\n
- Audit log is pruned automatically after 30 days (filterable via
storegauge_audit_retention_days<\/code>; 0 disables pruning)<\/li>\n- Abilities now declare explicit MCP exposure meta for the official MCP adapter<\/li>\n
- wp.org submission hardening: Requires PHP lowered to 7.2, directory-standard readme with external-services disclosure<\/li>\n<\/ul>\n\n
0.2.0<\/h4>\n\n\n- New: tool-calling chat \u2014 the AI requests store data itself with dynamic arguments (any date range 1\u2013365 days)<\/li>\n
- New: retry with backoff on transient provider errors (429\/500\/503)<\/li>\n
- New: markdown rendering (bold\/italic) in chat replies<\/li>\n
- New: replies always follow the language you write in<\/li>\n
- Improved: provider errors now fully logged to the audit trail<\/li>\n<\/ul>\n\n
0.1.0<\/h4>\n\n\n- Initial release: read-only store abilities, BYOK chat sidebar, audit log.<\/li>\n<\/ul>","raw_excerpt":"Bring-your-own-key AI assistant for WooCommerce. Chat with your live store data \u2014 read-only, audit-logged, with automatic charts.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/369117","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=369117"}],"author":[{"embeddable":true,"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/storesidekick"}],"wp:attachment":[{"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=369117"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=369117"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=369117"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=369117"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=369117"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/kab.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=369117"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}