@lacneu/wix-openclaw 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -7,6 +7,85 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-08-30
+
+Four analytics tools, off by default behind their own switch. The plugin could
+correct a site's SEO, check it for accessibility issues, and say nothing about
+whether anyone was visiting. This closes that.
+
+Two very different surfaces sit behind it: a **discoverable** query surface,
+where the models, measures and dimensions belong to the site and are read at
+runtime rather than assumed, and the legacy site-wide counters with their two
+hard bounds attached.
+
+### Added — Analytics: a discoverable query surface, plus one legacy endpoint
+
+> Off by default behind **its own** switch, `enableAnalyticsTools`. Nothing here
+> writes to the site. The switch is separate because the family needs a
+> permission of its own — `SCOPE.DC-ANALYTICS-AND-REPORTS.READ-SITE-ANALYTICS`
+> ("Site Analytics - read"), named by the reference on all four methods — which
+> neither the SEO nor the accessibility scope grants. Note that
+> `NO_ACCOUNT_IDENTITY` is **not** how a missing scope shows up: the reference
+> classifies it as HTTP 401 / UNAUTHENTICATED, so the refusal sends the operator
+> to the credentials first and names the scope as a separate prerequisite.
+
+Four tools: `wix_analytics_list_semantic_models`,
+`wix_analytics_get_semantic_model`, `wix_analytics_query_semantic_model` and
+`wix_analytics_get_data`.
+
+### A third kind of danger: the answer is shorter than the question
+
+The SEO writes destroyed the previous value of what they wrote. The
+accessibility scans could call an unchecked site clean. Here nothing is
+destroyed and nothing is scanned — what goes wrong is quieter. Wix states it on
+the `fields` parameter itself: a field whose `dependencies` are not also in the
+query is **silently omitted from the results**. No error, no empty column; the
+key is simply absent from the rows. A report can be missing an entire measure
+and look finished.
+
+So `wix_analytics_query_semantic_model` compares what was asked for against what
+arrived, names every field that did not come back, and — by re-reading the
+model's schema **only when something is missing** — says which dependency to
+add. It refuses to blame the dependency rule when a dependency *was* present:
+that case is reported as an incomplete result rather than explained away.
+
+Two more of the same shape. A query returns at most 1000 rows and Wix's own
+default page size is **50**, so the tool always sends an explicit limit — "did
+this fill the page" is then an exact question rather than one asked against an
+assumed default. It asks for **100** by default rather than Wix's ceiling,
+because the whole response is serialised into the model's context and 1000 rows
+across up to 60 fields would swamp it. A full page is reported as **possibly** truncated: exactly
+`limit` rows may be the whole answer, and nothing in the response settles it, so
+claiming it was cut short would be the same false certainty pointed the other
+way. And an absent `totals` row is reported as "not requested", never as a zero.
+
+### What the contract leaves open, the answer leaves open
+
+Two conventions are simply not documented, and neither is guessed: whether the
+semantic `interval` end bound is inclusive — Wix's own reference example ends a
+period at `…T23:59:59.000Z` rather than at the next midnight — and what timezone
+applies when none is passed. The query echoes the interval it sent and says the
+day boundaries are unknown when the timezone was left out, instead of naming a
+default nothing states.
+
+### What the models expose belongs to the site, not to this plugin
+
+Measures, dimensions and parameters are discovered through
+`wix_analytics_get_semantic_model`. That includes the question everyone asks
+first — whether a per-page or per-URL breakdown exists at all. Neither the code
+nor the README answers it in either direction: run the tool against the site.
+
+### The legacy counters, with their bounds attached
+
+Six site-level measurement types and nothing per page. Wix keeps **62 days**,
+and a `startDate` further back is refused with a *"Do not have data for this
+start date"* message — prose, not an error code, so it is matched and turned
+into a retention answer instead of reaching the caller as a broken query. And
+`endDate` is **exclusive**: `2026-08-01 → 2026-08-08` covers the 1st through the
+7th, so the tool reports the days it actually covered. An unknown measurement
+type is refused with the whole set of six in the message, because a typo would
+otherwise come back as an empty series that reads like "no activity".
+
 ## [0.5.1] - 2026-08-29
 
 Two corrections to the accessibility family, both in the one thing it exists to

package/README.md

@@ -18,9 +18,10 @@
 through the official Wix REST API. It registers **50 tools by default** across a
 dozen Wix products (Blog, CMS Data, Forms, Bookings, Contacts, Events, Reviews,
 FAQ, Multilingual, Sites, Site Media), plus a `wix_design_brief` helper that
-turns loose textual briefs into structured markdown artefacts. Two families are
-opt-in and add to that: SEO (`enableSeoTools`, 19 tools) and accessibility
-(`enableAccessibilityTools`, 6 tools) — **75 with both**.
+turns loose textual briefs into structured markdown artefacts. Three families
+are opt-in and add to that: SEO (`enableSeoTools`, 19 tools), accessibility
+(`enableAccessibilityTools`, 6 tools) and analytics (`enableAnalyticsTools`,
+4 tools) — **79 with all three**.
 
 Every tool funnels through a single authenticated HTTP client that:
 
@@ -204,6 +205,18 @@ the target site:
   `403` / `PERMISSION_DENIED` otherwise — which the tools surface as a
   permission problem, never as an empty site.
 
+- [ ] **Site Analytics - read** (`SCOPE.DC-ANALYTICS-AND-REPORTS.READ-SITE-ANALYTICS`)
+  — **only if you set `enableAnalyticsTools: true`**, which registers four
+  read-only tools. The reference names this same scope on all four methods
+  (`ListSemanticModels`, `GetSemanticModel`, `QuerySemanticModelData` and
+  `GetAnalyticsData`), so one permission covers the whole family and grants
+  nothing but reading. Note what `NO_ACCOUNT_IDENTITY` does and does not mean:
+  the reference classifies it as **HTTP 401 / UNAUTHENTICATED** — "the caller
+  isn't authenticated" — so it points at the credentials, not at this scope,
+  and it is never evidence of a site with no traffic. The separate
+  `SCOPE.DC-ANALYTICS-AND-REPORTS.MANAGE-SESSIONS` scope covers the Sessions
+  API, which this plugin deliberately does not expose.
+
 - [ ] **Pricing Plans** — if you sell subscription packages
 - [ ] **Wix Stores** + **Wix eCommerce** — if you sell physical/digital
   products. Without these, the `wix_*` tools that touch e-commerce
@@ -256,6 +269,7 @@ columns and remove the matching tools from your agent's allow-list.
 | `wix_multilingual_*` | Multilingual Translation Schema Read | Translation reads |
 | `wix_seo_*` (all nineteen) | Manage SEO (`SCOPE.PROMOTE.MANAGE-SEO`) | SEO audit **and** redirect changes — Wix has no read-only SEO scope, so this one permission covers both |
 | `wix_a11y_*` (all six) | Manage Accessibility Scans (identifier not published — read it off the Wix permissions page) | Starting a scan. Reading collections or stored results does not imply it |
+| `wix_analytics_*` (all four) | Site Analytics - read (`SCOPE.DC-ANALYTICS-AND-REPORTS.READ-SITE-ANALYTICS`) | Reading analytics. `NO_ACCOUNT_IDENTITY` is a 401 about the credentials, not about this scope — and never an empty site |
 | `wix_design_brief` | _(none — no API call)_ | Always |
 
 ### Wix app installation requirements
@@ -639,6 +653,78 @@ its latest saved version — the opposite way round from the SEO tag reads above
 
 ---
 
+### Analytics
+
+> **OFF by default, behind its own switch.** Nothing here writes to the site.
+> The switch is separate because the family needs a permission of its own —
+> `SCOPE.DC-ANALYTICS-AND-REPORTS.READ-SITE-ANALYTICS`, which the SEO and
+> accessibility scopes do not grant — so an install that opted into either of
+> those has decided nothing here. Set `enableAnalyticsTools: true` to opt in.
+> _Contract read from the public Introductions and from the published SDK
+> packages `@wix/auto_sdk_analytics-semantic-model_analytics-semantic-model`
+> and `@wix/auto_sdk_analytics-data_analytics-data`, whose host mappings give
+> the REST prefixes `/analytics/semantic-model/v3/semantic-models` and
+> `/analytics-ng/v2/site-analytics/data` verbatim — verified 2026-08-29._
+
+| Tool | What it does | Approval | Validated |
+|---|---|---|---|
+| `wix_analytics_list_semantic_models` | The analytics subject areas this site exposes | — | schema |
+| `wix_analytics_get_semantic_model` | One model's schema: measures, dimensions, parameters, and each field's `dependencies` | — | schema |
+| `wix_analytics_query_semantic_model` | Query a model over an interval; reports every requested field that did not come back | — | schema |
+| `wix_analytics_get_data` | The six legacy site-wide counters over a date range | — | schema |
+
+**The answer can be shorter than the question.** Wix states it on the `fields`
+parameter itself: a field whose `dependencies` are not also in the query is
+**silently omitted from the results**. No error, no empty column — the key is
+simply absent from the rows, so a report can be missing an entire measure and
+look finished. `wix_analytics_query_semantic_model` therefore compares what was
+asked for against what arrived, names every field that did not come back, and —
+by re-reading the model's schema only when something is missing — says which
+dependency to add.
+
+**What the models expose is a property of the site, not of this plugin.**
+Measures, dimensions and parameters are discovered through
+`wix_analytics_get_semantic_model`. That includes the question people ask first:
+whether a per-page or per-URL dimension exists at all. This README does not
+answer it in either direction — run the tool against the site and read the
+schema.
+
+**The legacy counters are site-level, and short-lived.** Six measurement types
+(`TOTAL_SESSIONS`, `TOTAL_UNIQUE_VISITORS`, `TOTAL_ORDERS`, `TOTAL_SALES`,
+`TOTAL_FORMS_SUBMITTED`, `CLICKS_TO_CONTACT`), no per-page breakdown, and Wix
+keeps **62 days**: a `startDate` more than 61 days back is refused with a
+*"Do not have data for this start date"* message — a retention limit, not an
+empty site. `endDate` is **exclusive**, so the tool reports the days it actually
+covered rather than leaving an off-by-one to be discovered later.
+
+**A bound this lot does not resolve.** These calls go out site-scoped, so the
+client sends `wix-site-id` — which is what the site whitelist is enforced on —
+and not `wix-account-id`. The error is named `NO_ACCOUNT_IDENTITY`, so it is
+possible that some of these endpoints want the account header instead; switching
+would remove the whitelist from this family on nothing better than an error
+name, while the reference calls the scope "Site Analytics" and classifies the
+error as a credentials 401. If a live call with a valid, correctly scoped key
+still answers `NO_ACCOUNT_IDENTITY`, that settles it. **That experiment has not
+been run.**
+
+**A query returns at most 1000 rows, and Wix's own default page size is 50.**
+The tool always sends an explicit limit, so "did this fill the page" is an exact
+question rather than one asked against an assumed default — and it defaults to
+**100**, not to Wix's ceiling: the whole response is serialised into the model's
+context, where 1000 rows across up to 60 fields would swamp it. Raise `limit`
+deliberately when you need more. A full page is
+reported as **possibly** truncated — exactly `limit` rows may be the whole
+answer, and nothing in the response settles it — so the caveat says to page
+before summing rather than asserting the result was cut short.
+
+**Two conventions the contract does not state**, both surfaced rather than
+guessed: whether the semantic `interval` end bound is inclusive (Wix's own
+reference example ends a period at `…T23:59:59.000Z` rather than at the next
+midnight), and what timezone applies when none is passed. The query echoes the
+interval it sent and says plainly when the timezone was left unset.
+
+---
+
 ### Design
 
 | Tool | What it does | Approval | Validated |

package/dist/config.js

@@ -79,6 +79,12 @@ export function resolveConfig(cfg = {}) {
         // decided anything about this, and folding the two together would enable a
         // family of calls that would only fail with 403.
         enableAccessibilityTools: cfg.enableAccessibilityTools === true,
+        // A THIRD SWITCH, for the same reason as the second: its own permission.
+        // All four methods require SCOPE.DC-ANALYTICS-AND-REPORTS.READ-SITE-ANALYTICS,
+        // which neither the SEO nor the accessibility scope grants — so an install
+        // that opted into either has decided nothing here, and would get a family
+        // of calls that can only answer NO_ACCOUNT_IDENTITY.
+        enableAnalyticsTools: cfg.enableAnalyticsTools === true,
         apiKey,
         accountId,
         allowedSiteIds,

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,EAAE;AACF,2EAA2E;AAC3E,6DAA6D;AAQ7D;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAI,KAAQ;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QACvD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC,CAAiB,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,wBAAwB;IACxB,oBAAoB;IACpB,uBAAuB;IACvB,sBAAsB;IACtB,qBAAqB;IACrB,yBAAyB;IACzB,qBAAqB;IACrB,sBAAsB;IACtB,yBAAyB;IACzB,sEAAsE;IACtE,6EAA6E;IAC7E,2EAA2E;IAC3E,6EAA6E;IAC7E,6DAA6D;IAC7D,yBAAyB;IACzB,yBAAyB;IACzB,+BAA+B;IAC/B,+BAA+B;IAC/B,uEAAuE;IACvE,wEAAwE;IACxE,uBAAuB;IACvB,4BAA4B;IAC5B,yBAAyB;IACzB,uBAAuB;IACvB,qBAAqB;IACrB,wBAAwB;IACxB,uBAAuB;CACxB,CAAC;AAEF,MAAM,gBAAgB,GAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3E;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAuB,EAAE;IAEzB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,aAAa,GACjB,eAAe,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,IAAI,yBAAyB,CAAC;IAE3E,MAAM,QAAQ,GAAgB,gBAAgB,CAAC,QAAQ,CACrD,GAAG,CAAC,QAAuB,CAC5B;QACC,CAAC,CAAE,GAAG,CAAC,QAAwB;QAC/B,CAAC,CAAC,MAAM,CAAC;IAEX,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,KAAK;QAC9B,sEAAsE;QACtE,mEAAmE;QACnE,sEAAsE;QACtE,0EAA0E;QAC1E,0EAA0E;QAC1E,cAAc,EAAE,GAAG,CAAC,cAAc,KAAK,IAAI;QAC3C,wEAAwE;QACxE,yEAAyE;QACzE,0EAA0E;QAC1E,2EAA2E;QAC3E,iDAAiD;QACjD,wBAAwB,EAAE,GAAG,CAAC,wBAAwB,KAAK,IAAI;QAC/D,MAAM;QACN,SAAS;QACT,cAAc;QACd,aAAa;QACb,gBAAgB,EAAE,IAAI,GAAG,CAAC,gBAAgB,CAAC;QAC3C,QAAQ;KACT,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,EAAE;AACF,2EAA2E;AAC3E,6DAA6D;AAQ7D;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAI,KAAQ;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QACvD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC,CAAiB,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,wBAAwB;IACxB,oBAAoB;IACpB,uBAAuB;IACvB,sBAAsB;IACtB,qBAAqB;IACrB,yBAAyB;IACzB,qBAAqB;IACrB,sBAAsB;IACtB,yBAAyB;IACzB,sEAAsE;IACtE,6EAA6E;IAC7E,2EAA2E;IAC3E,6EAA6E;IAC7E,6DAA6D;IAC7D,yBAAyB;IACzB,yBAAyB;IACzB,+BAA+B;IAC/B,+BAA+B;IAC/B,uEAAuE;IACvE,wEAAwE;IACxE,uBAAuB;IACvB,4BAA4B;IAC5B,yBAAyB;IACzB,uBAAuB;IACvB,qBAAqB;IACrB,wBAAwB;IACxB,uBAAuB;CACxB,CAAC;AAEF,MAAM,gBAAgB,GAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3E;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAuB,EAAE;IAEzB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,aAAa,GACjB,eAAe,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,IAAI,yBAAyB,CAAC;IAE3E,MAAM,QAAQ,GAAgB,gBAAgB,CAAC,QAAQ,CACrD,GAAG,CAAC,QAAuB,CAC5B;QACC,CAAC,CAAE,GAAG,CAAC,QAAwB;QAC/B,CAAC,CAAC,MAAM,CAAC;IAEX,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,KAAK;QAC9B,sEAAsE;QACtE,mEAAmE;QACnE,sEAAsE;QACtE,0EAA0E;QAC1E,0EAA0E;QAC1E,cAAc,EAAE,GAAG,CAAC,cAAc,KAAK,IAAI;QAC3C,wEAAwE;QACxE,yEAAyE;QACzE,0EAA0E;QAC1E,2EAA2E;QAC3E,iDAAiD;QACjD,wBAAwB,EAAE,GAAG,CAAC,wBAAwB,KAAK,IAAI;QAC/D,yEAAyE;QACzE,+EAA+E;QAC/E,2EAA2E;QAC3E,0EAA0E;QAC1E,qDAAqD;QACrD,oBAAoB,EAAE,GAAG,CAAC,oBAAoB,KAAK,IAAI;QACvD,MAAM;QACN,SAAS;QACT,cAAc;QACd,aAAa;QACb,gBAAgB,EAAE,IAAI,GAAG,CAAC,gBAAgB,CAAC;QAC3C,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -19,6 +19,7 @@ export type { ResolvedWixConfig, WixPluginConfig, WixRequestOptions, } from "./t
 export declare function buildAllTools(client: WixClient, options?: {
     seo?: boolean;
     accessibility?: boolean;
+    analytics?: boolean;
 }): ({
     name: string;
     description: string;
@@ -1677,6 +1678,98 @@ export declare function buildAllTools(client: WixClient, options?: {
         data?: unknown;
         error?: string;
     }>>;
+} | {
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        semanticModelId: import("@sinclair/typebox").TString;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        semanticModelId: string;
+    }, signal?: AbortSignal) => Promise<import("./tools/_factory.js").WixToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+} | {
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        semanticModelId: import("@sinclair/typebox").TString;
+        fields: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        start: import("@sinclair/typebox").TString;
+        end: import("@sinclair/typebox").TString;
+        timezone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        totalsIncluded: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        sort: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            fieldName: import("@sinclair/typebox").TString;
+            order: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ASC">, import("@sinclair/typebox").TLiteral<"DESC">]>>;
+            nullsLast: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        }>>;
+        filters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            field: import("@sinclair/typebox").TString;
+            values: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            condition: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"EQUAL">, import("@sinclair/typebox").TLiteral<"GREATER_THAN">, import("@sinclair/typebox").TLiteral<"GREATER_THAN_OR_EQUAL">, import("@sinclair/typebox").TLiteral<"LESS_THAN">, import("@sinclair/typebox").TLiteral<"LESS_THAN_OR_EQUAL">, import("@sinclair/typebox").TLiteral<"NULL">, import("@sinclair/typebox").TLiteral<"EMPTY">, import("@sinclair/typebox").TLiteral<"START_WITH">, import("@sinclair/typebox").TLiteral<"END_WITH">, import("@sinclair/typebox").TLiteral<"CONTAINS_ANY">, import("@sinclair/typebox").TLiteral<"CONTAINS_ALL">, import("@sinclair/typebox").TLiteral<"RANGE_II">, import("@sinclair/typebox").TLiteral<"RANGE_IE">, import("@sinclair/typebox").TLiteral<"RANGE_EI">, import("@sinclair/typebox").TLiteral<"RANGE_EE">]>>;
+            prefix: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"IS">, import("@sinclair/typebox").TLiteral<"NOT">]>>;
+        }>>>;
+        formattingEnabled: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    }>;
+    execute: (toolCallId: string, params: {
+        sort?: {
+            order?: "ASC" | "DESC" | undefined;
+            nullsLast?: boolean | undefined;
+            fieldName: string;
+        } | undefined;
+        siteId?: string | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+        timezone?: string | undefined;
+        totalsIncluded?: boolean | undefined;
+        filters?: {
+            condition?: "EQUAL" | "GREATER_THAN" | "GREATER_THAN_OR_EQUAL" | "LESS_THAN" | "LESS_THAN_OR_EQUAL" | "NULL" | "EMPTY" | "START_WITH" | "END_WITH" | "CONTAINS_ANY" | "CONTAINS_ALL" | "RANGE_II" | "RANGE_IE" | "RANGE_EI" | "RANGE_EE" | undefined;
+            prefix?: "IS" | "NOT" | undefined;
+            values: string[];
+            field: string;
+        }[] | undefined;
+        formattingEnabled?: boolean | undefined;
+        fields: string[];
+        semanticModelId: string;
+        start: string;
+        end: string;
+    }, signal?: AbortSignal) => Promise<import("./tools/_factory.js").WixToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+} | {
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        startDate: import("@sinclair/typebox").TString;
+        endDate: import("@sinclair/typebox").TString;
+        measurementTypes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        timeZone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        timeZone?: string | undefined;
+        startDate: string;
+        endDate: string;
+        measurementTypes: string[];
+    }, signal?: AbortSignal) => Promise<import("./tools/_factory.js").WixToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
 } | {
     name: string;
     description: string;

package/dist/index.js

@@ -31,6 +31,7 @@ import { buildMultilingualTools } from "./tools/multilingual.js";
 import { buildReviewsTools } from "./tools/reviews.js";
 import { buildSeoTools } from "./tools/seo.js";
 import { buildAccessibilityTools } from "./tools/accessibility.js";
+import { buildAnalyticsTools } from "./tools/analytics.js";
 import { buildSiteTools } from "./tools/site.js";
 import { WixClient } from "./wix-client.js";
 // Re-export helpers so tests can pull them without re-importing every
@@ -70,6 +71,9 @@ export function buildAllTools(client, options = {}) {
         // exists because starting a scan needs a permission of its own, and
         // because the endpoints may change without notice.
         ...(options.accessibility === true ? buildAccessibilityTools(client) : []),
+        // Read-only too, and behind its own switch: these endpoints want an
+        // account-level identity, not a site-scoped one.
+        ...(options.analytics === true ? buildAnalyticsTools(client) : []),
         ...buildDesignTools(client),
     ];
 }
@@ -95,6 +99,7 @@ export function registerWixPlugin(api) {
     const allTools = buildAllTools(client, {
         seo: config.enableSeoTools,
         accessibility: config.enableAccessibilityTools,
+        analytics: config.enableAnalyticsTools,
     });
     if (!config.enableAccessibilityTools) {
         api.logger.info("wix-openclaw: accessibility tools not registered — the Wix Accessibility " +
@@ -102,6 +107,11 @@ export function registerWixPlugin(api) {
             "Wix `Manage Accessibility Scans` permission. Set " +
             "config.enableAccessibilityTools to true to opt in.");
     }
+    if (!config.enableAnalyticsTools) {
+        api.logger.info("wix-openclaw: analytics tools not registered — these endpoints need an " +
+            "account-level Wix identity. Set config.enableAnalyticsTools to true " +
+            "to opt in.");
+    }
     if (!config.enableSeoTools) {
         api.logger.info("wix-openclaw: SEO tools not registered — the Wix SEO endpoints are in " +
             "Developer Preview and may change without notice. Set " +

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/analytics.d.ts

@@ -0,0 +1,124 @@
+import { type WixClient } from "../wix-client.js";
+export declare function buildAnalyticsTools(client: WixClient): ({
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+    }, signal?: AbortSignal) => Promise<import("./_factory.js").WixToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error
+        /** An abort is not a failed read. Swallowed by a general `catch`, a cancelled
+         *  call carried on and answered `ok` with a generic explanation — the caller
+         *  had already given up, and got an answer that looked like a result. */
+        ?: string;
+    }>>;
+} | {
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        semanticModelId: import("@sinclair/typebox").TString;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        semanticModelId: string;
+    }, signal?: AbortSignal) => Promise<import("./_factory.js").WixToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error
+        /** An abort is not a failed read. Swallowed by a general `catch`, a cancelled
+         *  call carried on and answered `ok` with a generic explanation — the caller
+         *  had already given up, and got an answer that looked like a result. */
+        ?: string;
+    }>>;
+} | {
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        semanticModelId: import("@sinclair/typebox").TString;
+        fields: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        start: import("@sinclair/typebox").TString;
+        end: import("@sinclair/typebox").TString;
+        timezone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        totalsIncluded: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        sort: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            fieldName: import("@sinclair/typebox").TString;
+            order: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ASC">, import("@sinclair/typebox").TLiteral<"DESC">]>>;
+            nullsLast: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        }>>;
+        filters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            field: import("@sinclair/typebox").TString;
+            values: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            condition: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"EQUAL">, import("@sinclair/typebox").TLiteral<"GREATER_THAN">, import("@sinclair/typebox").TLiteral<"GREATER_THAN_OR_EQUAL">, import("@sinclair/typebox").TLiteral<"LESS_THAN">, import("@sinclair/typebox").TLiteral<"LESS_THAN_OR_EQUAL">, import("@sinclair/typebox").TLiteral<"NULL">, import("@sinclair/typebox").TLiteral<"EMPTY">, import("@sinclair/typebox").TLiteral<"START_WITH">, import("@sinclair/typebox").TLiteral<"END_WITH">, import("@sinclair/typebox").TLiteral<"CONTAINS_ANY">, import("@sinclair/typebox").TLiteral<"CONTAINS_ALL">, import("@sinclair/typebox").TLiteral<"RANGE_II">, import("@sinclair/typebox").TLiteral<"RANGE_IE">, import("@sinclair/typebox").TLiteral<"RANGE_EI">, import("@sinclair/typebox").TLiteral<"RANGE_EE">]>>;
+            prefix: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"IS">, import("@sinclair/typebox").TLiteral<"NOT">]>>;
+        }>>>;
+        formattingEnabled: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    }>;
+    execute: (toolCallId: string, params: {
+        sort?: {
+            order?: "ASC" | "DESC" | undefined;
+            nullsLast?: boolean | undefined;
+            fieldName: string;
+        } | undefined;
+        siteId?: string | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+        timezone?: string | undefined;
+        totalsIncluded?: boolean | undefined;
+        filters?: {
+            condition?: "EQUAL" | "GREATER_THAN" | "GREATER_THAN_OR_EQUAL" | "LESS_THAN" | "LESS_THAN_OR_EQUAL" | "NULL" | "EMPTY" | "START_WITH" | "END_WITH" | "CONTAINS_ANY" | "CONTAINS_ALL" | "RANGE_II" | "RANGE_IE" | "RANGE_EI" | "RANGE_EE" | undefined;
+            prefix?: "IS" | "NOT" | undefined;
+            values: string[];
+            field: string;
+        }[] | undefined;
+        formattingEnabled?: boolean | undefined;
+        fields: string[];
+        semanticModelId: string;
+        start: string;
+        end: string;
+    }, signal?: AbortSignal) => Promise<import("./_factory.js").WixToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error
+        /** An abort is not a failed read. Swallowed by a general `catch`, a cancelled
+         *  call carried on and answered `ok` with a generic explanation — the caller
+         *  had already given up, and got an answer that looked like a result. */
+        ?: string;
+    }>>;
+} | {
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        startDate: import("@sinclair/typebox").TString;
+        endDate: import("@sinclair/typebox").TString;
+        measurementTypes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        timeZone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        timeZone?: string | undefined;
+        startDate: string;
+        endDate: string;
+        measurementTypes: string[];
+    }, signal?: AbortSignal) => Promise<import("./_factory.js").WixToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error
+        /** An abort is not a failed read. Swallowed by a general `catch`, a cancelled
+         *  call carried on and answered `ok` with a generic explanation — the caller
+         *  had already given up, and got an answer that looked like a result. */
+        ?: string;
+    }>>;
+})[];