@lacneu/wix-openclaw 0.1.1 → 0.2.1

package/dist/tools/reviews.d.ts

@@ -4,19 +4,39 @@ export declare function buildReviewsTools(client: WixClient): ({
     description: string;
     label: string;
     parameters: import("@sinclair/typebox").TObject<{
-        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        moderationStatus: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"PENDING">, import("@sinclair/typebox").TLiteral<"APPROVED">, import("@sinclair/typebox").TLiteral<"REJECTED">]>>;
+        filter: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+        sort: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<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">]>>;
+        }>>>;
         paging: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
             limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
             offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
         }>>;
+        cursorPaging: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            cursor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        }>>;
+        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        moderationStatus: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"PENDING">, import("@sinclair/typebox").TLiteral<"APPROVED">, import("@sinclair/typebox").TLiteral<"REJECTED">]>>;
     }>;
     execute: (toolCallId: string, params: {
+        sort?: {
+            order?: "ASC" | "DESC" | undefined;
+            fieldName: string;
+        }[] | undefined;
+        filter?: unknown;
         siteId?: string | undefined;
         paging?: {
             limit?: number | undefined;
             offset?: number | undefined;
         } | undefined;
+        cursorPaging?: {
+            limit?: number | undefined;
+            cursor?: string | undefined;
+        } | undefined;
+        fields?: string[] | undefined;
         moderationStatus?: "PENDING" | "APPROVED" | "REJECTED" | undefined;
     }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
         status: "ok" | "failed";

package/dist/tools/reviews.js

@@ -4,14 +4,20 @@
 // Without it, calls return HTTP 428 `APP_NOT_INSTALLED`. Endpoint paths
 // pattern-validated against the public docs; untested live (app not
 // installed on the smoke-test site).
+//
+// `wix_reviews_list` is a POST `/query` and accepts the standard Wix
+// query envelope.
 import { Type } from "@sinclair/typebox";
 import { defineWixTool } from "./_factory.js";
+import { WixQueryBodyEnvelopeSchema, buildQueryBody, } from "./_query.js";
 const SiteIdParam = Type.Optional(Type.String());
 export function buildReviewsTools(client) {
     return [
         defineWixTool({
             name: "wix_reviews_list",
-            description: "List reviews. Filter by moderation status if needed.",
+            description: "List reviews. Pass `moderationStatus` for the common case or " +
+                "`filter` for finer queries (rating ranges, productId, " +
+                "createdDate, ...). Accepts the standard Wix query envelope.",
             parameters: Type.Object({
                 siteId: SiteIdParam,
                 moderationStatus: Type.Optional(Type.Union([
@@ -19,22 +25,18 @@ export function buildReviewsTools(client) {
                     Type.Literal("APPROVED"),
                     Type.Literal("REJECTED"),
                 ])),
-                paging: Type.Optional(Type.Object({
-                    limit: Type.Optional(Type.Number({ minimum: 1, maximum: 100 })),
-                    offset: Type.Optional(Type.Number({ minimum: 0 })),
-                })),
-            }),
-            run: (params) => client.request("POST", "/reviews/v1/reviews/query", {
-                siteId: params.siteId,
-                body: {
-                    query: {
-                        filter: params.moderationStatus
-                            ? { moderationStatus: params.moderationStatus }
-                            : undefined,
-                        paging: params.paging,
-                    },
-                },
+                ...WixQueryBodyEnvelopeSchema.properties,
             }),
+            run: (params) => {
+                const { siteId, moderationStatus, ...envelope } = params;
+                const extra = moderationStatus
+                    ? { moderationStatus: { $eq: moderationStatus } }
+                    : undefined;
+                return client.request("POST", "/reviews/v1/reviews/query", {
+                    siteId,
+                    body: buildQueryBody(envelope, extra),
+                });
+            },
         }, client),
         defineWixTool({
             name: "wix_reviews_get",

package/dist/tools/reviews.js.map

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

package/dist/tools/site.d.ts

@@ -4,16 +4,36 @@ export declare function buildSiteTools(client: WixClient): ({
     description: string;
     label: string;
     parameters: import("@sinclair/typebox").TObject<{
+        filter: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+        sort: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<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">]>>;
+        }>>>;
         paging: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
             limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
             offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
         }>>;
+        cursorPaging: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            cursor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        }>>;
+        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     }>;
     execute: (toolCallId: string, params: {
+        sort?: {
+            order?: "ASC" | "DESC" | undefined;
+            fieldName: string;
+        }[] | undefined;
+        filter?: unknown;
         paging?: {
             limit?: number | undefined;
             offset?: number | undefined;
         } | undefined;
+        cursorPaging?: {
+            limit?: number | undefined;
+            cursor?: string | undefined;
+        } | undefined;
+        fields?: string[] | undefined;
     }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
         status: "ok" | "failed";
         data?: unknown;

package/dist/tools/site.js

@@ -1,40 +1,34 @@
 // Wix Sites + Site Properties tools (read-only).
 //
 // `wix_sites_list` and `wix_site_url_get` are account-scoped — they hit
-// the Site List API and Published Site URLs API and require the
-// `wix-account-id` header (siteScoped: false).
+// the Site List API and require the `wix-account-id` header
+// (siteScoped: false). The query endpoint accepts the full Wix query
+// envelope (filter on `metaSiteId`, `displayName`, `published`, ...).
+//
 // `wix_business_info_get` reads from the Site Properties API and is
-// site-scoped.
+// site-scoped (flat GET, no filter envelope).
 //
 // Verified against:
 //   - https://dev.wix.com/docs/rest/account-level/sites/sites/query-sites
-//   - https://dev.wix.com/docs/api-reference/business-management/site-urls/published-site-urls/list-published-site-urls
 //   - https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties
 import { Type } from "@sinclair/typebox";
 import { defineWixTool } from "./_factory.js";
+import { WixQueryBodyEnvelopeSchema, buildQueryBody, } from "./_query.js";
 export function buildSiteTools(client) {
     return [
         defineWixTool({
             name: "wix_sites_list",
-            description: "Query Wix sites under the configured account. Account-scoped — no site id required. Returns up to 1,000 sites.",
+            description: "Query Wix sites under the configured account. Account-scoped " +
+                "— no site id required. Accepts the standard Wix query envelope" +
+                "(filter on `metaSiteId`, `displayName`, `published`, " +
+                "`domainConnected`; sort; offset paging up to 1,000 sites; " +
+                "field projection).",
             parameters: Type.Object({
-                paging: Type.Optional(Type.Object({
-                    limit: Type.Optional(Type.Number({ minimum: 1, maximum: 1000 })),
-                    offset: Type.Optional(Type.Number({ minimum: 0 })),
-                })),
+                ...WixQueryBodyEnvelopeSchema.properties,
             }),
             run: (params) => client.request("POST", "/site-list/v2/sites/query", {
                 siteScoped: false,
-                body: {
-                    query: {
-                        paging: params.paging
-                            ? {
-                                limit: params.paging.limit,
-                                offset: params.paging.offset,
-                            }
-                            : undefined,
-                    },
-                },
+                body: buildQueryBody(params),
             }),
         }, client),
         defineWixTool({
@@ -57,12 +51,10 @@ export function buildSiteTools(client) {
                 }
                 const resp = await client.request("POST", "/site-list/v2/sites/query", {
                     siteScoped: false,
-                    body: {
-                        query: {
-                            filter: { metaSiteId: targetId },
-                            paging: { limit: 1 },
-                        },
-                    },
+                    body: buildQueryBody({
+                        filter: { metaSiteId: { $eq: targetId } },
+                        paging: { limit: 1 },
+                    }),
                 });
                 const site = resp?.sites?.[0];
                 if (!site) {

package/dist/tools/site.js.map

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

package/examples/recommended-skill.md

@@ -0,0 +1,188 @@
+---
+name: wix
+description: Site officiel <YOUR_SITE_NAME> (<your-site.com>) sur Wix — articles de blog, brouillons, médias, formulaires/leads, RDV, services, FAQ, avis. Utilise ce skill quand l'utilisateur dit "publier un article", "brouillon de blog", "ajouter une image au site", "voir les leads", "soumissions de formulaire", "modifier les services", "répondre à un avis", "FAQ", "<your-site.com>", "site officiel".
+user-invocable: true
+---
+
+# Wix — Recommended skill template
+
+> **This is a template** — copy it to your workspace
+> (`~/.openclaw/workspace-<agent>/skills/wix/SKILL.md`), then replace every
+> `<PLACEHOLDER>` with values specific to your site and organisation.
+> Skills are loaded per workspace, so duplicate the file for each agent
+> that should benefit from it.
+
+This skill gives an OpenClaw agent the business context, recipes and
+behavioural guardrails it needs to operate the
+[`@lacneu/wix-openclaw`](https://www.npmjs.com/package/@lacneu/wix-openclaw)
+plugin correctly. The plugin itself ships generic tools; this skill wraps
+them into your specific site, voice and audience.
+
+## Business context (replace with yours)
+
+`<ORGANIZATION>` is `<short pitch — what you do, who you serve>`. The
+public site `<your-site.com>` runs on **Wix Editor classic** (the plugin
+also targets Wix Studio sites — adjust if relevant). It is locked at the
+plugin level to a single `siteId` (set in `allowedSiteIds`).
+
+**Tone for site content** — `<sober / playful / formal / informal>`,
+`<language>`, `<audience>`. Preserve the voice of the human contributors
+when they dictate or proofread; do not normalize their phrasing.
+
+**Site language** — `<fr / en / ...>`.
+
+**Human contributors / collaborators** — list them with their role:
+
+- `<Name 1>` — `<role>`
+- `<Name 2>` — `<role>`
+- `<...>`
+
+## Conversational triggers (when this skill is relevant)
+
+- "Publish an article about X" / "Publier un article sur X"
+- "Prepare a draft about Y" / "Prépare un brouillon sur Y"
+- "Add this image to the site" / "Ajoute cette image au site"
+- "How many leads this week?" / "Combien de leads cette semaine ?"
+- "Update this service" / "Mets à jour ce service"
+- "What appointments today?" / "Quels RDV aujourd'hui ?"
+- "Reply to this review" / "Réponds à cet avis"
+- "Add this FAQ entry" / "Ajoute cette question à la FAQ"
+- Any mention of `<your-site.com>`, "Wix", "official site", "site officiel"
+
+## When this skill does NOT apply
+
+The plugin **cannot** modify the site's design (Wix Editor classic does
+not expose this through any public API):
+
+- Colours, typography, page layout
+- Individual graphic components (buttons, sections, backgrounds)
+- Page structure (navigation, header, footer)
+
+Pure-design requests should be redirected to the **(e) Design request**
+recipe below.
+
+## Usage patterns
+
+### (a) Draft and publish a blog article
+
+1. **Cover image** — if the user provides a URL (or asks for an
+   AI-generated image): use `wix_media_upload` to push it into Wix Media
+   Manager. Capture the returned `id` for step 2.
+2. **Create draft** — `wix_blog_create_draft` with:
+   - `title`
+   - `richContent` (Wix Ricos format — Wix Blog's native rich-text)
+   - `coverMedia.imageId` from step 1
+   - `tagIds`, `categoryIds` if appropriate (look them up first via
+     `wix_blog_list_tags` / `wix_blog_list_categories`)
+3. **User-facing recap** — show this in plain business language, NEVER
+   mention tool names or HTTP details:
+
+   > Draft ready:
+   > **Title**: <title>
+   > **Lead paragraph**: <first ~80 words>
+   > **Cover image**: <displayName or short description>
+   > **Tags**: <readable list>
+   >
+   > Reply `publish` to go live, or tell me what to adjust.
+
+4. **Publish on explicit confirmation only** — `wix_blog_publish_draft`
+   with the draft id. OpenClaw approval-gates this call; the recap above
+   helps the human decide knowingly.
+
+### (b) List actual drafts (not the published-post snapshots)
+
+Wix Blog v3 quirk: `wix_blog_list_drafts` without filter returns mirror
+drafts for already-published posts (auto-snapshots).
+
+To see only **drafts being actively written**: pass `status: "UNPUBLISHED"`.
+Other useful values: `IN_REVIEW`, `SCHEDULED`.
+
+If the user asks "how many drafts do I have?" and the unfiltered count
+looks unexpectedly large, explain in plain words ("some are mirror
+copies of published articles") and re-query with `status: "UNPUBLISHED"`.
+
+### (c) Read form submissions / leads
+
+- `wix_forms_list_submissions` with:
+  - `namespace: "wix.form_app.form"` (default — keep unless using a
+    custom forms app)
+  - `paging.limit: 20` (or more)
+  - `sort` to put recent first when supported
+
+Present leads in business language (name, email, message, date). Do not
+expose technical `id`s.
+
+### (d) Manage bookings
+
+- `wix_bookings_services_list` — list bookable services
+- `wix_bookings_query_bookings` with a `startDate` filter (e.g.
+  `$gt: "2026-01-01T00:00:00Z"`) for upcoming bookings
+- `wix_bookings_cancel` / `wix_bookings_reschedule` — both gated; ask for
+  explicit confirmation before invoking.
+
+### (e) Design request (assumed limitation)
+
+If the user asks for a visual change (colour, layout, styled button…),
+respond along these lines:
+
+> I can't change the site's visual components directly (Wix Editor
+> classic doesn't expose that via API). I can however prepare a design
+> brief (palette, typography, suggested copy) and generate a mockup
+> image — you'll then apply it manually in the Wix editor. Want to go
+> that route?
+
+If yes: use `wix_design_brief` to structure the brief, then
+`image_generate` (or your preferred image-gen tool) for the mockup.
+
+## Behavioural guardrails
+
+1. **Before any publication** (`wix_blog_publish_draft`, modifying
+   `wix_bookings_*`, public review replies) — always show a business
+   recap and wait for explicit confirmation. OpenClaw gates the HTTP
+   call already; the recap helps the human decide.
+2. **"App not installed" / `428` / `404` / "Wix Code not enabled"** — do
+   not insist or retry. Explain in plain terms that the relevant Wix app
+   must be activated in the
+   [Wix App Market](https://www.wix.com/app-market). Apps concerned: Wix
+   Events, Wix Reviews, Wix FAQ, Wix Multilingual, Velo (for
+   `wix_data_*`).
+3. **Site whitelist** — the plugin is locked to `<your_site_id>`. Any
+   other `siteId` is rejected before reaching Wix. Do not try to bypass.
+4. **PII / sensitive data** — form submissions and contacts contain
+   names, emails, phone numbers, sometimes confidential messages. **Do
+   not log, do not embed in long-term knowledge stores** (vector DB,
+   shared memory) without explicit user consent. Surface only what is
+   asked.
+
+## Available tools (short mapping)
+
+- **Blog** — drafts (create, list, update, publish), posts, categories,
+  tags
+- **Media** — upload, list
+- **Site** — `sites_list`, `url_get`, `business_info`
+- **CMS / Wix Data** — collections, items CRUD (requires Velo enabled)
+- **Forms** — `submissions` (list, get)
+- **Contacts** — CRUD + labels + search
+- **Bookings** — services, bookings (CRUD, cancel, reschedule)
+- **Events** (requires Wix Events app)
+- **Reviews** (requires Wix Reviews app) — moderation, replies
+- **FAQ** (requires Wix FAQ app)
+- **Multilingual** (requires Wix Multilingual app)
+- **Design** — `wix_design_brief`
+
+Full reference and live signatures:
+<https://github.com/OlivierNeu/wix-openclaw-plugin#tools>
+
+## Operating rules
+
+1. **Voice of `<ORGANIZATION>` first** — preserve phrasings dictated by
+   `<contributors>`, do not normalize them.
+2. **No technical jargon to end-users** — never expose tool names
+   (`wix_*`), Wix object ids, or HTTP error codes. Rephrase in business
+   terms.
+3. **Explicit confirmation** before any public-facing publication or
+   modification.
+4. **Single source of truth** — the official site at `<your-site.com>`.
+   Do not attempt other `siteId`s.
+5. **Unexpected behaviour** — escalate to the operator (admin agent /
+   maintainer) in a separate session, not in the user-facing channel.

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "wix-openclaw",
   "name": "Wix",
   "description": "Wix REST API plugin for OpenClaw — manage blog, CMS data, forms, bookings, contacts, events, FAQ on a single Wix site with site_id whitelist and approval gating on destructive ops",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lacneu/wix-openclaw",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "type": "module",
   "description": "Wix REST API plugin for OpenClaw — manage blog, CMS data, forms, bookings, contacts, events, FAQ on a single Wix site with site_id whitelist and approval gating on destructive ops",
   "license": "MIT",
@@ -29,6 +29,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "examples",
     "openclaw.plugin.json",
     "README.md",
     "CHANGELOG.md",