@lacneu/wix-openclaw 0.0.1

package/dist/tools/faq.d.ts

@@ -0,0 +1,98 @@
+import type { WixClient } from "../wix-client.js";
+export declare function buildFaqTools(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("@mariozechner/pi-agent-core").AgentToolResult<{
+        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>;
+        categoryId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        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>;
+        }>>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        paging?: {
+            limit?: number | undefined;
+            offset?: number | undefined;
+        } | undefined;
+        categoryId?: string | undefined;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        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>;
+        question: import("@sinclair/typebox").TString;
+        answer: import("@sinclair/typebox").TString;
+        categoryId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        categoryId?: string | undefined;
+        question: string;
+        answer: string;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        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>;
+        questionId: import("@sinclair/typebox").TString;
+        question: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        answer: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        categoryId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        categoryId?: string | undefined;
+        question?: string | undefined;
+        answer?: string | undefined;
+        questionId: string;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        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>;
+        questionId: import("@sinclair/typebox").TString;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        questionId: string;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+})[];

package/dist/tools/faq.js

@@ -0,0 +1,90 @@
+// Wix FAQ tools.
+//
+// Requires the Wix FAQ app to be installed on the target site. Without
+// it, calls return HTTP 400 `App is not installed`. Endpoint paths
+// pattern-validated against the public docs; untested live (app not
+// installed on the smoke-test site). For older sites that store FAQ
+// data in a CMS collection (`FAQ` / `FAQCategories`), fall back to
+// `wix_data_*` tools.
+import { Type } from "@sinclair/typebox";
+import { defineWixTool } from "./_factory.js";
+const SiteIdParam = Type.Optional(Type.String());
+export function buildFaqTools(client) {
+    return [
+        defineWixTool({
+            name: "wix_faq_list_categories",
+            description: "List FAQ categories.",
+            parameters: Type.Object({ siteId: SiteIdParam }),
+            run: (params) => client.request("GET", "/faq/v1/categories", {
+                siteId: params.siteId,
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_faq_list_questions",
+            description: "List FAQ questions, optionally filtered by category.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                categoryId: Type.Optional(Type.String()),
+                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("GET", "/faq/v1/questions", {
+                siteId: params.siteId,
+                query: {
+                    categoryId: params.categoryId,
+                    "paging.limit": params.paging?.limit,
+                    "paging.offset": params.paging?.offset,
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_faq_create_question",
+            description: "Create a new FAQ question.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                question: Type.String(),
+                answer: Type.String({
+                    description: "Plain text or rich content. The Wix FAQ app accepts Ricos rich content for the answer body.",
+                }),
+                categoryId: Type.Optional(Type.String()),
+            }),
+            run: (params) => client.request("POST", "/faq/v1/questions", {
+                siteId: params.siteId,
+                body: {
+                    question: {
+                        question: params.question,
+                        answer: params.answer,
+                        categoryId: params.categoryId,
+                    },
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_faq_update_question",
+            description: "Update an existing FAQ question.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                questionId: Type.String(),
+                question: Type.Optional(Type.String()),
+                answer: Type.Optional(Type.String()),
+                categoryId: Type.Optional(Type.String()),
+            }),
+            run: (params) => {
+                const { siteId, questionId, ...rest } = params;
+                return client.request("PATCH", `/faq/v1/questions/${encodeURIComponent(questionId)}`, { siteId, body: { question: rest } });
+            },
+        }, client),
+        defineWixTool({
+            name: "wix_faq_delete_question",
+            description: "Delete an FAQ question. APPROVAL GATED.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                questionId: Type.String(),
+            }),
+            run: (params) => client.request("DELETE", `/faq/v1/questions/${encodeURIComponent(params.questionId)}`, { siteId: params.siteId }),
+        }, client),
+    ];
+}
+//# sourceMappingURL=faq.js.map

package/dist/tools/faq.js.map

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

package/dist/tools/forms.d.ts

@@ -0,0 +1,46 @@
+import type { WixClient } from "../wix-client.js";
+export declare function buildFormsTools(client: WixClient): ({
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        namespace: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        formId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"PENDING">, import("@sinclair/typebox").TLiteral<"CONFIRMED">, import("@sinclair/typebox").TLiteral<"PAYMENT_WAITING">, import("@sinclair/typebox").TLiteral<"PAYMENT_CANCELED">]>>;
+        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>;
+        }>>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        paging?: {
+            limit?: number | undefined;
+            offset?: number | undefined;
+        } | undefined;
+        status?: "PENDING" | "CONFIRMED" | "PAYMENT_WAITING" | "PAYMENT_CANCELED" | undefined;
+        namespace?: string | undefined;
+        formId?: string | undefined;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        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>;
+        submissionId: import("@sinclair/typebox").TString;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        submissionId: string;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+})[];

package/dist/tools/forms.js

@@ -0,0 +1,63 @@
+// Wix Forms submissions tools.
+//
+// Submissions live under `/form-submissions/v4/...` and the listing
+// endpoint is `query-submissions-by-namespace` — Wix REQUIRES a namespace
+// filter, otherwise the call fails with a validation error. The default
+// namespace for native Wix forms is `wix.form_app.form` (a.k.a.
+// `wix_forms`); apps can register their own namespaces.
+//
+// Verified against:
+//   - https://dev.wix.com/docs/rest/crm/forms/form-submissions/query-submissions-by-namespace
+import { Type } from "@sinclair/typebox";
+import { defineWixTool } from "./_factory.js";
+const SiteIdParam = Type.Optional(Type.String());
+export function buildFormsTools(client) {
+    return [
+        defineWixTool({
+            name: "wix_forms_list_submissions",
+            description: "List form submissions (leads/contacts captured by site forms). Supports filtering by form id and time range.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                namespace: Type.Optional(Type.String({
+                    default: "wix.form_app.form",
+                    description: "Namespace of the app that owns the submissions. Defaults to native Wix Forms (`wix.form_app.form`). REQUIRED by Wix on the filter.",
+                })),
+                formId: Type.Optional(Type.String()),
+                status: Type.Optional(Type.Union([
+                    Type.Literal("PENDING"),
+                    Type.Literal("CONFIRMED"),
+                    Type.Literal("PAYMENT_WAITING"),
+                    Type.Literal("PAYMENT_CANCELED"),
+                ])),
+                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", "/form-submission-service/v4/submissions/namespace/query", {
+                siteId: params.siteId,
+                body: {
+                    query: {
+                        filter: {
+                            namespace: { $eq: params.namespace ?? "wix.form_app.form" },
+                            ...(params.formId ? { formId: { $eq: params.formId } } : {}),
+                            ...(params.status ? { status: { $eq: params.status } } : {}),
+                        },
+                        limit: params.paging?.limit,
+                        offset: params.paging?.offset,
+                    },
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_forms_get_submission",
+            description: "Fetch a single form submission by id.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                submissionId: Type.String(),
+            }),
+            run: (params) => client.request("GET", `/form-submission-service/v4/submissions/${encodeURIComponent(params.submissionId)}`, { siteId: params.siteId }),
+        }, client),
+    ];
+}
+//# sourceMappingURL=forms.js.map

package/dist/tools/forms.js.map

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

package/dist/tools/media.d.ts

@@ -0,0 +1,50 @@
+import type { WixClient } from "../wix-client.js";
+export declare function buildMediaTools(client: WixClient): ({
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        url: import("@sinclair/typebox").TString;
+        displayName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        mimeType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        parentFolderId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        labels: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        displayName?: string | undefined;
+        mimeType?: string | undefined;
+        parentFolderId?: string | undefined;
+        labels?: string[] | undefined;
+        url: string;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        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>;
+        parentFolderId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        paging: 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>;
+        }>>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        paging?: {
+            limit?: number | undefined;
+            cursor?: string | undefined;
+        } | undefined;
+        parentFolderId?: string | undefined;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+})[];

package/dist/tools/media.js

@@ -0,0 +1,75 @@
+// Wix Site Media (`/site-media/v1/...`) tools.
+//
+// The Wix Site Media upload flow is a 3-step dance:
+//   1. POST /site-media/v1/files/generate-upload-url → returns `uploadUrl`
+//   2. PUT or POST <uploadUrl> with the binary content → returns file metadata
+//   3. The returned `id` (or `displayName`) can then be referenced from a
+//      blog post's `media.imageId` or any other place expecting a Wix
+//      MEDIA_IMAGE.
+//
+// `wix_media_upload` here exposes step 1 only — the agent passes the URL
+// of an already-hosted image (e.g. an OpenClaw-generated image stored in
+// `media:` storage), and we let Wix import it directly. This avoids
+// streaming binary blobs through the LLM tool channel.
+//
+// `wix_media_list` validated live. `wix_media_upload` body shape comes
+// from public docs — confirm against the live API before relying on it
+// to chain into rich-content blog posts.
+import { Type } from "@sinclair/typebox";
+import { defineWixTool } from "./_factory.js";
+const SiteIdParam = Type.Optional(Type.String());
+export function buildMediaTools(client) {
+    return [
+        defineWixTool({
+            name: "wix_media_upload",
+            description: "Import an image into the Wix Site Media library by URL. Returns the file metadata including `id`, which can be passed to wix_blog_create_draft as `coverMedia.imageId` or embedded into Ricos rich content. Prefer this to streaming binary content.",
+            // The import-by-URL flow uses POST /site-media/v1/files/import.
+            // Confirm response shape against your account before chaining it.
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                url: Type.String({
+                    description: "Publicly reachable URL of the image to import",
+                }),
+                displayName: Type.Optional(Type.String({
+                    description: "File display name in the Wix media library",
+                })),
+                mimeType: Type.Optional(Type.String({
+                    description: "Optional MIME type. Wix auto-detects from URL extension when omitted.",
+                })),
+                parentFolderId: Type.Optional(Type.String()),
+                labels: Type.Optional(Type.Array(Type.String())),
+            }),
+            run: (params) => client.request("POST", "/site-media/v1/files/import", {
+                siteId: params.siteId,
+                body: {
+                    url: params.url,
+                    displayName: params.displayName,
+                    mimeType: params.mimeType,
+                    parentFolderId: params.parentFolderId,
+                    labels: params.labels,
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_media_list",
+            description: "List files in the Wix Site Media library.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                parentFolderId: Type.Optional(Type.String()),
+                paging: Type.Optional(Type.Object({
+                    limit: Type.Optional(Type.Number({ minimum: 1, maximum: 100 })),
+                    cursor: Type.Optional(Type.String()),
+                })),
+            }),
+            run: (params) => client.request("GET", "/site-media/v1/files", {
+                siteId: params.siteId,
+                query: {
+                    parentFolderId: params.parentFolderId,
+                    "paging.limit": params.paging?.limit,
+                    "paging.cursor": params.paging?.cursor,
+                },
+            }),
+        }, client),
+    ];
+}
+//# sourceMappingURL=media.js.map

package/dist/tools/media.js.map

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

package/dist/tools/multilingual.d.ts

@@ -0,0 +1,38 @@
+import type { WixClient } from "../wix-client.js";
+export declare function buildMultilingualTools(client: WixClient): ({
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        siteId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        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>;
+        }>>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        paging?: {
+            limit?: number | undefined;
+            offset?: number | undefined;
+        } | undefined;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        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>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+})[];

package/dist/tools/multilingual.js

@@ -0,0 +1,48 @@
+// Wix Multilingual tools — read-only in V1.
+//
+// Wix splits multilingual into two product surfaces:
+//   - Locales API (`/locales/v2/...`) for languages configured on a site
+//   - Translation Schema API (`/multilingual/translation/v3/...`) for
+//     per-app translation entries
+//
+// The Locales API is the right place to read which languages a site
+// supports. Per-key translation reading lives in the Translation Schema
+// API and requires a `schemaKey` + `entityId` rather than a flat key —
+// hence the parameter shift on `wix_multilingual_get_translation`.
+//
+// Verified against:
+//   - https://dev.wix.com/docs/rest/business-management/multilingual/locales/locales/introduction
+//   - https://dev.wix.com/docs/rest/business-management/multilingual/translation/translation-schema/introduction
+import { Type } from "@sinclair/typebox";
+import { defineWixTool } from "./_factory.js";
+const SiteIdParam = Type.Optional(Type.String());
+export function buildMultilingualTools(client) {
+    return [
+        defineWixTool({
+            name: "wix_multilingual_list_languages",
+            description: "Query configured locales on the site (language code, country, primary flag, status). Returns up to 200 locales.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                paging: Type.Optional(Type.Object({
+                    limit: Type.Optional(Type.Number({ minimum: 1, maximum: 200 })),
+                    offset: Type.Optional(Type.Number({ minimum: 0 })),
+                })),
+            }),
+            run: (params) => client.request("POST", "/locales/v2/locale/query", {
+                siteId: params.siteId,
+                body: {
+                    query: {
+                        paging: params.paging,
+                    },
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_multilingual_list_schemas",
+            description: "List the translation schemas registered on the site, regardless of which app created them.",
+            parameters: Type.Object({ siteId: SiteIdParam }),
+            run: (params) => client.request("GET", "/translation-schema/v1/schemas/site", { siteId: params.siteId }),
+        }, client),
+    ];
+}
+//# sourceMappingURL=multilingual.js.map

package/dist/tools/multilingual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multilingual.js","sourceRoot":"","sources":["../../src/tools/multilingual.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,qDAAqD;AACrD,yEAAyE;AACzE,sEAAsE;AACtE,kCAAkC;AAClC,EAAE;AACF,oEAAoE;AACpE,wEAAwE;AACxE,uEAAuE;AACvE,mEAAmE;AACnE,EAAE;AACF,oBAAoB;AACpB,kGAAkG;AAClG,iHAAiH;AAEjH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAEjD,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,OAAO;QACL,aAAa,CACX;YACE,IAAI,EAAE,iCAAiC;YACvC,WAAW,EACT,iHAAiH;YACnH,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;oBACV,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAC1C;oBACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;iBACnD,CAAC,CACH;aACF,CAAC;YACF,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,0BAA0B,EAAE;gBACjD,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE;oBACJ,KAAK,EAAE;wBACL,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB;iBACF;aACF,CAAC;SACL,EACD,MAAM,CACP;QAED,aAAa,CACX;YACE,IAAI,EAAE,+BAA+B;YACrC,WAAW,EACT,4FAA4F;YAC9F,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YAChD,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,MAAM,CAAC,OAAO,CACZ,KAAK,EACL,qCAAqC,EACrC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAC1B;SACJ,EACD,MAAM,CACP;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/reviews.d.ts

@@ -0,0 +1,62 @@
+import type { WixClient } from "../wix-client.js";
+export declare function buildReviewsTools(client: WixClient): ({
+    name: string;
+    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">]>>;
+        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>;
+        }>>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        paging?: {
+            limit?: number | undefined;
+            offset?: number | undefined;
+        } | undefined;
+        moderationStatus?: "PENDING" | "APPROVED" | "REJECTED" | undefined;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        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>;
+        reviewId: import("@sinclair/typebox").TString;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        reviewId: string;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        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>;
+        reviewId: import("@sinclair/typebox").TString;
+        decision: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"APPROVED">, import("@sinclair/typebox").TLiteral<"REJECTED">]>;
+        reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        reason?: string | undefined;
+        reviewId: string;
+        decision: "APPROVED" | "REJECTED";
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+})[];