@lacneu/wix-openclaw 0.0.1

package/dist/tools/data.d.ts

@@ -0,0 +1,114 @@
+import type { WixClient } from "../wix-client.js";
+export declare function buildDataTools(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>;
+        dataCollectionId: import("@sinclair/typebox").TString;
+        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>;
+        }>>;
+    }>;
+    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;
+        dataCollectionId: 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>;
+        dataCollectionId: import("@sinclair/typebox").TString;
+        dataItemId: import("@sinclair/typebox").TString;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        dataCollectionId: string;
+        dataItemId: 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>;
+        dataCollectionId: import("@sinclair/typebox").TString;
+        dataItem: import("@sinclair/typebox").TUnknown;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        dataCollectionId: string;
+        dataItem: unknown;
+    }, 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>;
+        dataCollectionId: import("@sinclair/typebox").TString;
+        dataItemId: import("@sinclair/typebox").TString;
+        dataItem: import("@sinclair/typebox").TUnknown;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        dataCollectionId: string;
+        dataItemId: string;
+        dataItem: unknown;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+})[];

package/dist/tools/data.js

@@ -0,0 +1,129 @@
+// Wix Data (`/wix-data/v2/...`) tools — CMS collection items.
+//
+// The Wix Data API exposes user-defined CMS collections. Queries use a
+// flexible `filter` object that maps to MongoDB-style query syntax (e.g.
+// `{ "title": { "$contains": "foo" } }`). We expose it raw rather than
+// trying to abstract it, since the LLM benefits from full flexibility.
+//
+// Requires Velo / Wix Code to be enabled on the target site
+// (Wix Editor → Velo → Enable Code). Without it, all `wix_data_*` calls
+// return HTTP 400 `WDE0110: Wix Code not enabled`. Endpoint paths
+// validated against the public docs but untested live (Velo not enabled
+// on the smoke-test site).
+import { Type } from "@sinclair/typebox";
+import { defineWixTool } from "./_factory.js";
+const SiteIdParam = Type.Optional(Type.String());
+export function buildDataTools(client) {
+    return [
+        defineWixTool({
+            name: "wix_data_list_collections",
+            description: "List CMS collections (and their schemas) defined for the site.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                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", "/wix-data/v2/collections", {
+                siteId: params.siteId,
+                query: {
+                    "paging.limit": params.paging?.limit,
+                    "paging.offset": params.paging?.offset,
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_data_query_items",
+            description: "Query items in a CMS collection. `filter` is a Mongo-style object (e.g. {\"status\": \"active\"}). Supports paging and sorting.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                dataCollectionId: Type.String(),
+                filter: Type.Optional(Type.Unknown({
+                    description: "Mongo-style filter object, e.g. {\"price\": {\"$gt\": 100}}",
+                })),
+                sort: Type.Optional(Type.Array(Type.Object({
+                    fieldName: Type.String(),
+                    order: Type.Optional(Type.Union([Type.Literal("ASC"), Type.Literal("DESC")])),
+                }))),
+                paging: Type.Optional(Type.Object({
+                    limit: Type.Optional(Type.Number({ minimum: 1, maximum: 1000 })),
+                    offset: Type.Optional(Type.Number({ minimum: 0 })),
+                })),
+            }),
+            run: (params) => client.request("POST", "/wix-data/v2/items/query", {
+                siteId: params.siteId,
+                body: {
+                    dataCollectionId: params.dataCollectionId,
+                    query: {
+                        filter: params.filter,
+                        sort: params.sort,
+                        paging: params.paging,
+                    },
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_data_get_item",
+            description: "Fetch a single CMS item by id.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                dataCollectionId: Type.String(),
+                dataItemId: Type.String(),
+            }),
+            run: (params) => client.request("GET", `/wix-data/v2/items/${encodeURIComponent(params.dataItemId)}`, {
+                siteId: params.siteId,
+                query: { dataCollectionId: params.dataCollectionId },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_data_insert_item",
+            description: "Insert a new item into a CMS collection.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                dataCollectionId: Type.String(),
+                dataItem: Type.Unknown({
+                    description: "Object whose keys match the collection's schema. The Wix API will reject unknown fields.",
+                }),
+            }),
+            run: (params) => client.request("POST", "/wix-data/v2/items", {
+                siteId: params.siteId,
+                body: {
+                    dataCollectionId: params.dataCollectionId,
+                    dataItem: { data: params.dataItem },
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_data_update_item",
+            description: "Update an existing CMS item.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                dataCollectionId: Type.String(),
+                dataItemId: Type.String(),
+                dataItem: Type.Unknown(),
+            }),
+            run: (params) => client.request("PATCH", `/wix-data/v2/items/${encodeURIComponent(params.dataItemId)}`, {
+                siteId: params.siteId,
+                body: {
+                    dataCollectionId: params.dataCollectionId,
+                    dataItem: { data: params.dataItem },
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_data_remove_item",
+            description: "Delete a CMS item. APPROVAL GATED.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                dataCollectionId: Type.String(),
+                dataItemId: Type.String(),
+            }),
+            run: (params) => client.request("DELETE", `/wix-data/v2/items/${encodeURIComponent(params.dataItemId)}`, {
+                siteId: params.siteId,
+                query: { dataCollectionId: params.dataCollectionId },
+            }),
+        }, client),
+    ];
+}
+//# sourceMappingURL=data.js.map

package/dist/tools/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/tools/data.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,uEAAuE;AACvE,yEAAyE;AACzE,uEAAuE;AACvE,uEAAuE;AACvE,EAAE;AACF,4DAA4D;AAC5D,wEAAwE;AACxE,kEAAkE;AAClE,wEAAwE;AACxE,2BAA2B;AAE3B,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,cAAc,CAAC,MAAiB;IAC9C,OAAO;QACL,aAAa,CACX;YACE,IAAI,EAAE,2BAA2B;YACjC,WAAW,EACT,gEAAgE;YAClE,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,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;oBAC/D,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,KAAK,EAAE,0BAA0B,EAAE;gBAChD,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE;oBACL,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK;oBACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM;iBACvC;aACF,CAAC;SACL,EACD,MAAM,CACP;QAED,aAAa,CACX;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EACT,iIAAiI;YACnI,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,WAAW;gBACnB,gBAAgB,EAAE,IAAI,CAAC,MAAM,EAAE;gBAC/B,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,OAAO,CAAC;oBACX,WAAW,EACT,6DAA6D;iBAChE,CAAC,CACH;gBACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,KAAK,CACR,IAAI,CAAC,MAAM,CAAC;oBACV,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;oBACxB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CACxD;iBACF,CAAC,CACH,CACF;gBACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;oBACV,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;oBAChE,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,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;oBACzC,KAAK,EAAE;wBACL,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB;iBACF;aACF,CAAC;SACL,EACD,MAAM,CACP;QAED,aAAa,CACX;YACE,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,gCAAgC;YAC7C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,WAAW;gBACnB,gBAAgB,EAAE,IAAI,CAAC,MAAM,EAAE;gBAC/B,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;aAC1B,CAAC;YACF,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,MAAM,CAAC,OAAO,CACZ,KAAK,EACL,sBAAsB,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAC7D;gBACE,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE;aACrD,CACF;SACJ,EACD,MAAM,CACP;QAED,aAAa,CACX;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,0CAA0C;YACvD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,WAAW;gBACnB,gBAAgB,EAAE,IAAI,CAAC,MAAM,EAAE;gBAC/B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC;oBACrB,WAAW,EACT,0FAA0F;iBAC7F,CAAC;aACH,CAAC;YACF,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE;gBAC3C,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE;oBACJ,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;oBACzC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;iBACpC;aACF,CAAC;SACL,EACD,MAAM,CACP;QAED,aAAa,CACX;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,8BAA8B;YAC3C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,WAAW;gBACnB,gBAAgB,EAAE,IAAI,CAAC,MAAM,EAAE;gBAC/B,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;gBACzB,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE;aACzB,CAAC;YACF,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,MAAM,CAAC,OAAO,CACZ,OAAO,EACP,sBAAsB,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAC7D;gBACE,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE;oBACJ,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;oBACzC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;iBACpC;aACF,CACF;SACJ,EACD,MAAM,CACP;QAED,aAAa,CACX;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,oCAAoC;YACjD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,WAAW;gBACnB,gBAAgB,EAAE,IAAI,CAAC,MAAM,EAAE;gBAC/B,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;aAC1B,CAAC;YACF,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,MAAM,CAAC,OAAO,CACZ,QAAQ,EACR,sBAAsB,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAC7D;gBACE,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE;aACrD,CACF;SACJ,EACD,MAAM,CACP;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/design.d.ts

@@ -0,0 +1,32 @@
+import type { WixClient } from "../wix-client.js";
+export declare function buildDesignTools(_client: WixClient): {
+    name: string;
+    description: string;
+    label: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        brief: import("@sinclair/typebox").TString;
+        mood: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        audience: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        references: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        primaryGoals: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        pages: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        brandPersonality: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        preferredColors: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        preferredFonts: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    }>;
+    execute: (toolCallId: string, params: {
+        mood?: string | undefined;
+        audience?: string | undefined;
+        references?: string[] | undefined;
+        primaryGoals?: string[] | undefined;
+        pages?: string[] | undefined;
+        brandPersonality?: string | undefined;
+        preferredColors?: string[] | undefined;
+        preferredFonts?: string[] | undefined;
+        brief: string;
+    }, signal?: AbortSignal) => Promise<import("@mariozechner/pi-agent-core").AgentToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+}[];

package/dist/tools/design.js

@@ -0,0 +1,165 @@
+// Wix Design Brief tool — pure prompt structurer, no API call.
+//
+// Generates a markdown brief the agent can hand to a designer (or to an
+// image-generation tool like `image_generate`) to produce mockups,
+// copywriting drafts, and palette/typography recommendations consistent
+// with the user's stated direction.
+//
+// The tool deliberately never touches the Wix API — its job is to turn a
+// loose textual brief into a structured artefact. This keeps the tool
+// safe to run unattended (no approval gating).
+import { Type } from "@sinclair/typebox";
+import { defineWixTool } from "./_factory.js";
+/**
+ * Pick a baseline palette by inspecting the brief's mood/personality
+ * heuristically. Deterministic — same input always produces the same
+ * output.
+ */
+function suggestPalette(input) {
+    if (input.preferredColors && input.preferredColors.length >= 3) {
+        return input.preferredColors.slice(0, 5).map((hex, idx) => ({
+            hex,
+            role: ["primary", "secondary", "accent", "background", "muted"][idx] ?? "extra",
+        }));
+    }
+    const mood = `${input.mood ?? ""} ${input.brandPersonality ?? ""}`.toLowerCase();
+    if (mood.includes("luxe") || mood.includes("luxury") || mood.includes("premium")) {
+        return [
+            { hex: "#1A1A1A", role: "primary (deep neutral)" },
+            { hex: "#C9A765", role: "secondary (gold accent)" },
+            { hex: "#F5F1E8", role: "background (warm off-white)" },
+            { hex: "#6E6E6E", role: "muted (mid grey)" },
+            { hex: "#FFFFFF", role: "canvas (pure white)" },
+        ];
+    }
+    if (mood.includes("nature") || mood.includes("eco") || mood.includes("organic")) {
+        return [
+            { hex: "#2E5A40", role: "primary (forest green)" },
+            { hex: "#A8C49B", role: "secondary (sage)" },
+            { hex: "#F4F1E8", role: "background (linen)" },
+            { hex: "#6B5B4F", role: "muted (warm brown)" },
+            { hex: "#FFFFFF", role: "canvas" },
+        ];
+    }
+    if (mood.includes("tech") || mood.includes("digital") || mood.includes("modern")) {
+        return [
+            { hex: "#0F172A", role: "primary (deep slate)" },
+            { hex: "#3B82F6", role: "secondary (electric blue)" },
+            { hex: "#F8FAFC", role: "background" },
+            { hex: "#64748B", role: "muted" },
+            { hex: "#FFFFFF", role: "canvas" },
+        ];
+    }
+    // Default — calm, professional, neutral.
+    return [
+        { hex: "#1F2937", role: "primary (charcoal)" },
+        { hex: "#3B82F6", role: "secondary (action blue)" },
+        { hex: "#FAFAFA", role: "background" },
+        { hex: "#6B7280", role: "muted" },
+        { hex: "#FFFFFF", role: "canvas" },
+    ];
+}
+function suggestTypography(input) {
+    if (input.preferredFonts && input.preferredFonts.length >= 2) {
+        return {
+            headings: input.preferredFonts[0],
+            body: input.preferredFonts[1],
+        };
+    }
+    const mood = `${input.mood ?? ""} ${input.brandPersonality ?? ""}`.toLowerCase();
+    if (mood.includes("luxe") || mood.includes("luxury") || mood.includes("editorial")) {
+        return { headings: "Playfair Display", body: "Inter" };
+    }
+    if (mood.includes("modern") || mood.includes("tech")) {
+        return { headings: "Inter", body: "Inter" };
+    }
+    if (mood.includes("warm") || mood.includes("nature")) {
+        return { headings: "Cormorant Garamond", body: "Source Sans 3" };
+    }
+    return { headings: "Inter Tight", body: "Inter" };
+}
+function renderBrief(input) {
+    const palette = suggestPalette(input);
+    const typo = suggestTypography(input);
+    const pages = input.pages ?? ["Home", "About", "Services", "Contact"];
+    const goals = input.primaryGoals ?? ["Communicate the offer clearly", "Generate qualified leads"];
+    const lines = [];
+    lines.push("# Design brief");
+    lines.push("");
+    lines.push("## Brief");
+    lines.push(input.brief);
+    if (input.mood)
+        lines.push(`\n**Mood:** ${input.mood}`);
+    if (input.audience)
+        lines.push(`**Audience:** ${input.audience}`);
+    if (input.brandPersonality)
+        lines.push(`**Brand personality:** ${input.brandPersonality}`);
+    lines.push("");
+    lines.push("## Goals");
+    for (const g of goals)
+        lines.push(`- ${g}`);
+    lines.push("");
+    lines.push("## Palette");
+    for (const c of palette)
+        lines.push(`- \`${c.hex}\` — ${c.role}`);
+    lines.push("");
+    lines.push("## Typography");
+    lines.push(`- Headings: **${typo.headings}**`);
+    lines.push(`- Body: **${typo.body}**`);
+    lines.push("");
+    lines.push("## Page sections (recommended)");
+    for (const p of pages) {
+        lines.push(`- **${p}** — sections: hero, value props, social proof, CTA`);
+    }
+    lines.push("");
+    lines.push("## Copy starters");
+    lines.push("- Hero headline: \"<Promise> for <audience>, in <timeframe>.\"");
+    lines.push("- Hero subhead: \"<Differentiator>. <Outcome>.\"");
+    lines.push("- Primary CTA: \"Réserver un appel\"");
+    lines.push("- Secondary CTA: \"En savoir plus\"");
+    lines.push("");
+    lines.push("## Image-generation prompts (for gpt-image-2 or similar)");
+    const baseStyle = `clean editorial photography, palette dominated by ${palette[0]?.hex} and ${palette[1]?.hex}, ` +
+        `${input.mood ?? "calm and professional"} mood, soft natural light, no text overlay`;
+    lines.push(`- **Hero:** "${pages[0] ?? "Homepage"} hero image — ${baseStyle}"`);
+    lines.push(`- **About:** "Editorial portrait suitable for an About page — ${baseStyle}"`);
+    lines.push(`- **Service tile:** "Square thumbnail illustrating <service> — ${baseStyle}"`);
+    if (input.references && input.references.length > 0) {
+        lines.push("");
+        lines.push("## References provided");
+        for (const r of input.references)
+            lines.push(`- ${r}`);
+    }
+    lines.push("");
+    lines.push("_This brief was generated by `wix_design_brief`. It is a starting point — adjust palette, typography, and copy with the brand owner before using for production work._");
+    return lines.join("\n");
+}
+export function buildDesignTools(_client) {
+    return [
+        defineWixTool({
+            name: "wix_design_brief",
+            description: "Turn a loose design brief into a structured markdown artefact: palette (HEX + roles), typography, recommended page sections, copy starters, and prompts for image-generation tools. Does NOT call the Wix API. Use as a starting point before creating draft posts or tweaking the site theme.",
+            parameters: Type.Object({
+                brief: Type.String({
+                    description: "Free-text description of the desired site/page direction.",
+                }),
+                mood: Type.Optional(Type.String()),
+                audience: Type.Optional(Type.String()),
+                references: Type.Optional(Type.Array(Type.String(), {
+                    description: "Optional list of reference URLs / inspirations for the designer to look at.",
+                })),
+                primaryGoals: Type.Optional(Type.Array(Type.String())),
+                pages: Type.Optional(Type.Array(Type.String())),
+                brandPersonality: Type.Optional(Type.String()),
+                preferredColors: Type.Optional(Type.Array(Type.String(), {
+                    description: "Optional pre-selected HEX colors (3-5).",
+                })),
+                preferredFonts: Type.Optional(Type.Array(Type.String(), {
+                    description: "Optional preferred font names. Index 0 = headings, 1 = body.",
+                })),
+            }),
+            run: async (params) => renderBrief(params),
+        }, _client),
+    ];
+}
+//# sourceMappingURL=design.js.map

package/dist/tools/design.js.map

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

package/dist/tools/events.d.ts

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

package/dist/tools/events.js

@@ -0,0 +1,70 @@
+// Wix Events (`/events/v3/...`) tools — read-only.
+//
+// Requires the Wix Events app to be installed on the target site.
+// Without it, calls return HTTP 428 `WIX_EVENTS_APP_NOT_INSTALLED`.
+// Endpoint paths pattern-validated against the public docs; untested
+// live (app not installed on the smoke-test site).
+import { Type } from "@sinclair/typebox";
+import { defineWixTool } from "./_factory.js";
+const SiteIdParam = Type.Optional(Type.String());
+export function buildEventsTools(client) {
+    return [
+        defineWixTool({
+            name: "wix_events_list",
+            description: "List events (Wix Events).",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                status: Type.Optional(Type.Union([
+                    Type.Literal("UPCOMING"),
+                    Type.Literal("STARTED"),
+                    Type.Literal("ENDED"),
+                    Type.Literal("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", "/events/v3/events/query", {
+                siteId: params.siteId,
+                body: {
+                    query: {
+                        filter: params.status ? { status: params.status } : undefined,
+                        paging: params.paging,
+                    },
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_events_get",
+            description: "Fetch a single event by id.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                eventId: Type.String(),
+            }),
+            run: (params) => client.request("GET", `/events/v3/events/${encodeURIComponent(params.eventId)}`, { siteId: params.siteId }),
+        }, client),
+        defineWixTool({
+            name: "wix_events_list_guests",
+            description: "List guests / RSVPs / orders for an event.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                eventId: 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("POST", "/events/v3/event-guests/query", {
+                siteId: params.siteId,
+                body: {
+                    query: {
+                        filter: { eventId: params.eventId },
+                        paging: params.paging,
+                    },
+                },
+            }),
+        }, client),
+    ];
+}
+//# sourceMappingURL=events.js.map

package/dist/tools/events.js.map

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