@lacneu/wix-openclaw 0.0.1

package/dist/hooks/approval.js

@@ -0,0 +1,65 @@
+// `before_tool_call` hook for destructive Wix operations.
+//
+// Reads the `approvalRequired` set from resolved config and, when a tool
+// matches, returns a `requireApproval` directive. The OpenClaw runtime
+// surfaces this to the operator (Telegram inline button, Control UI, ...)
+// before the tool call proceeds.
+//
+// Notes on the SDK contract (see `node_modules/openclaw/dist/plugin-sdk/
+// src/plugins/types.d.ts`):
+//   - `severity` accepts "info" | "warning" | "critical" (NOT "high").
+//   - `timeoutBehavior` accepts "allow" | "deny".
+//   - `pluginId` is set automatically by the hook runner — do not set it
+//     yourself.
+const DEFAULT_TIMEOUT_MS = 600_000; // 10 minutes
+const PARAM_PREVIEW_CHARS = 600;
+/**
+ * Truncate the parameter snapshot so we never surface a wall of JSON to
+ * the operator. We strip `siteId` since it's covered by the config and
+ * adds noise to the prompt.
+ */
+function previewParams(params) {
+    const { siteId: _siteId, ...rest } = params; // eslint-disable-line @typescript-eslint/no-unused-vars
+    let json;
+    try {
+        json = JSON.stringify(rest, null, 2);
+    }
+    catch {
+        json = "<unserializable params>";
+    }
+    if (json.length <= PARAM_PREVIEW_CHARS)
+        return json;
+    return `${json.slice(0, PARAM_PREVIEW_CHARS)}…`;
+}
+/**
+ * Build a `before_tool_call` handler bound to a resolved Wix config.
+ * Extracted as a factory so tests can exercise it without a full plugin
+ * registration.
+ */
+export function createApprovalHook(config, logger) {
+    return function beforeToolCall(event) {
+        if (!config.enabled)
+            return undefined;
+        if (!config.approvalRequired.has(event.toolName))
+            return undefined;
+        const description = `Tool \`${event.toolName}\` is about to run with the following parameters:\n\n` +
+            "```json\n" +
+            previewParams(event.params) +
+            "\n```\n\n" +
+            "Approve to execute, deny to cancel. The call will deny automatically " +
+            "if no decision is made within 10 minutes.";
+        if (config.logLevel === "debug") {
+            logger.debug?.(`wix: requesting approval for ${event.toolName} (runId=${event.runId ?? "?"})`);
+        }
+        return {
+            requireApproval: {
+                title: `Wix: confirm ${event.toolName}`,
+                description,
+                severity: "critical",
+                timeoutMs: DEFAULT_TIMEOUT_MS,
+                timeoutBehavior: "deny",
+            },
+        };
+    };
+}
+//# sourceMappingURL=approval.js.map

package/dist/hooks/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../src/hooks/approval.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,iCAAiC;AACjC,EAAE;AACF,yEAAyE;AACzE,4BAA4B;AAC5B,uEAAuE;AACvE,kDAAkD;AAClD,yEAAyE;AACzE,gBAAgB;AA4BhB,MAAM,kBAAkB,GAAG,OAAO,CAAC,CAAC,aAAa;AACjD,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAA+B;IACpD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,wDAAwD;IACrG,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,yBAAyB,CAAC;IACnC,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,IAAI,mBAAmB;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,GAAG,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAyB,EACzB,MAAiB;IAEjB,OAAO,SAAS,cAAc,CAC5B,KAA0B;QAE1B,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAEnE,MAAM,WAAW,GACf,UAAU,KAAK,CAAC,QAAQ,uDAAuD;YAC/E,WAAW;YACX,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;YAC3B,WAAW;YACX,uEAAuE;YACvE,2CAA2C,CAAC;QAE9C,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,EAAE,CACZ,gCAAgC,KAAK,CAAC,QAAQ,WAAW,KAAK,CAAC,KAAK,IAAI,GAAG,GAAG,CAC/E,CAAC;QACJ,CAAC;QAED,OAAO;YACL,eAAe,EAAE;gBACf,KAAK,EAAE,gBAAgB,KAAK,CAAC,QAAQ,EAAE;gBACvC,WAAW;gBACX,QAAQ,EAAE,UAAU;gBACpB,SAAS,EAAE,kBAAkB;gBAC7B,eAAe,EAAE,MAAM;aACxB;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
+export { resolveConfig, resolveEnv } from "./config.js";
+export { createApprovalHook } from "./hooks/approval.js";
+export { WixClient, WixApiError, WixSiteNotAllowedError, } from "./wix-client.js";
+export type { ResolvedWixConfig, WixPluginConfig, WixRequestOptions, } from "./types.js";
+/**
+ * Register every Wix tool against the provided plugin API. Exposed so
+ * tests can drive the registration with a fake API surface.
+ */
+export declare function registerWixPlugin(api: OpenClawPluginApi): void;
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginConfigSchema;
+    register: NonNullable<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition["register"]>;
+} & Pick<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition, "kind" | "reload" | "nodeHostCommands" | "securityAuditCollectors">;
+export default _default;

package/dist/index.js

@@ -0,0 +1,97 @@
+// wix-openclaw — Wix REST API plugin for OpenClaw.
+//
+// Exposes ~50 tools spanning Blog, CMS Data, Forms, Contacts, Bookings,
+// Events, Reviews, FAQ, Multilingual, plus a `wix_design_brief` helper.
+//
+// Security model:
+//   1. Site whitelist — every site-scoped call is checked against
+//      `allowedSiteIds` before any HTTP request goes out. Calls to
+//      sites outside the list throw {@link WixSiteNotAllowedError} and
+//      surface as a tool failure to the model.
+//   2. Approval gating — destructive operations (publish, delete,
+//      cancel, moderate) trigger a `before_tool_call` approval prompt
+//      handled by OpenClaw's approval runtime.
+//   3. No secret in code — `apiKey` and `accountId` come from the
+//      plugin config (with `${ENV_VAR}` substitution), never from the
+//      LLM's parameter space.
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { resolveConfig } from "./config.js";
+import { createApprovalHook } from "./hooks/approval.js";
+import { buildBlogTools } from "./tools/blog.js";
+import { buildBookingsTools } from "./tools/bookings.js";
+import { buildContactsTools } from "./tools/contacts.js";
+import { buildDataTools } from "./tools/data.js";
+import { buildDesignTools } from "./tools/design.js";
+import { buildEventsTools } from "./tools/events.js";
+import { buildFaqTools } from "./tools/faq.js";
+import { buildFormsTools } from "./tools/forms.js";
+import { buildMediaTools } from "./tools/media.js";
+import { buildMultilingualTools } from "./tools/multilingual.js";
+import { buildReviewsTools } from "./tools/reviews.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
+// submodule, and so downstream packagers can depend on internals if they
+// need to (e.g. for an inspector tool).
+export { resolveConfig, resolveEnv } from "./config.js";
+export { createApprovalHook } from "./hooks/approval.js";
+export { WixClient, WixApiError, WixSiteNotAllowedError, } from "./wix-client.js";
+/**
+ * Register every Wix tool against the provided plugin API. Exposed so
+ * tests can drive the registration with a fake API surface.
+ */
+export function registerWixPlugin(api) {
+    const rawConfig = (api.pluginConfig ?? {});
+    const config = resolveConfig(rawConfig);
+    if (!config.enabled) {
+        api.logger.warn("wix-openclaw: disabled via config — no tools registered");
+        return;
+    }
+    if (!config.apiKey) {
+        api.logger.warn("wix-openclaw: apiKey is empty — plugin disabled (set plugins.entries.wix-openclaw.config.apiKey)");
+        return;
+    }
+    if (config.allowedSiteIds.length === 0) {
+        api.logger.warn("wix-openclaw: allowedSiteIds is empty — every site-scoped call will be rejected. Add at least one site UUID to enable.");
+    }
+    const client = new WixClient(config, api.logger);
+    // Order doesn't matter for tools — we group by domain for log clarity.
+    const allTools = [
+        ...buildBlogTools(client),
+        ...buildMediaTools(client),
+        ...buildSiteTools(client),
+        ...buildDataTools(client),
+        ...buildFormsTools(client),
+        ...buildContactsTools(client),
+        ...buildBookingsTools(client),
+        ...buildEventsTools(client),
+        ...buildReviewsTools(client),
+        ...buildFaqTools(client),
+        ...buildMultilingualTools(client),
+        ...buildDesignTools(client),
+    ];
+    for (const tool of allTools) {
+        // The SDK exposes `registerTool(tool: AnyAgentTool, opts?)`. Our
+        // factory output is shape-compatible (name, description, parameters,
+        // execute, label) but the precise `AnyAgentTool` type is inferred
+        // through several generics; we hand the runtime a structurally
+        // compatible object via an `unknown` widen.
+        api.registerTool(tool);
+    }
+    // Approval gating for destructive operations.
+    const approvalHandler = createApprovalHook(config, api.logger);
+    // The SDK's `api.on<K>` is strongly typed per hook name; cast at the
+    // boundary so we can keep our handler signature explicit.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    api.on("before_tool_call", approvalHandler);
+    api.logger.info(`wix-openclaw: ready — ${allTools.length} tools registered, ${config.approvalRequired.size} approval-gated, ${config.allowedSiteIds.length} allowed site(s)`);
+}
+export default definePluginEntry({
+    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",
+    register(api) {
+        registerWixPlugin(api);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/_factory.d.ts

@@ -0,0 +1,40 @@
+import type { Static, TSchema } from "@sinclair/typebox";
+import type { AgentToolResult } from "@mariozechner/pi-agent-core";
+import { type WixClient } from "../wix-client.js";
+/**
+ * Definition for a single Wix tool. Generic over the TypeBox schema so the
+ * `execute` body sees fully typed params.
+ *
+ * - `name` is the tool identifier exposed to the LLM. Convention:
+ *   `wix_<domain>_<verb>` (e.g. `wix_blog_create_draft`).
+ * - `description` is what the model sees. Keep it short and unambiguous;
+ *   mention any parameters the model is likely to forget (e.g. `richContent`
+ *   format for blog posts, `MEDIA_IMAGE` ref chaining, ...).
+ * - `parameters` is a TypeBox `Type.Object(...)` schema.
+ * - `run(params, client)` does the actual API call. Returning a value (any
+ *   JSON-serialisable shape) is enough — the factory wraps it as a text
+ *   tool result for the model.
+ */
+export interface WixToolDefinition<TSchema_ extends TSchema> {
+    name: string;
+    description: string;
+    parameters: TSchema_;
+    label?: string;
+    run: (params: Static<TSchema_>, client: WixClient, signal?: AbortSignal) => Promise<unknown>;
+}
+/**
+ * Wrap a {@link WixToolDefinition} into the `AgentTool` shape consumed by
+ * `api.registerTool`. Captured in a closure so `client` is bound once at
+ * plugin registration time.
+ */
+export declare function defineWixTool<TSchema_ extends TSchema>(def: WixToolDefinition<TSchema_>, client: WixClient): {
+    name: string;
+    description: string;
+    label: string;
+    parameters: TSchema_;
+    execute: (toolCallId: string, params: Static<TSchema_>, signal?: AbortSignal) => Promise<AgentToolResult<{
+        status: "ok" | "failed";
+        data?: unknown;
+        error?: string;
+    }>>;
+};

package/dist/tools/_factory.js

@@ -0,0 +1,69 @@
+// Tool factory shared across every Wix tool.
+//
+// The factory standardises:
+//   - JSON serialisation of the tool result via `payloadTextResult`
+//   - Error mapping (WixApiError, WixSiteNotAllowedError → tool failure)
+//   - The `execute(toolCallId, params, signal)` signature expected by the
+//     OpenClaw runtime
+//
+// Each domain file (blog, data, contacts, ...) declares its tools by
+// calling {@link defineWixTool} and exporting an array, which the entry
+// point collects and registers in bulk.
+import { WixApiError, WixSiteNotAllowedError } from "../wix-client.js";
+/**
+ * Wrap a {@link WixToolDefinition} into the `AgentTool` shape consumed by
+ * `api.registerTool`. Captured in a closure so `client` is bound once at
+ * plugin registration time.
+ */
+export function defineWixTool(def, client) {
+    const label = def.label ?? def.name;
+    return {
+        name: def.name,
+        description: def.description,
+        label,
+        parameters: def.parameters,
+        async execute(_toolCallId, params, signal) {
+            try {
+                const data = await def.run(params, client, signal);
+                const text = data === null || data === undefined
+                    ? "OK"
+                    : typeof data === "string"
+                        ? data
+                        : JSON.stringify(data, null, 2);
+                return {
+                    content: [{ type: "text", text }],
+                    details: { status: "ok", data },
+                };
+            }
+            catch (err) {
+                // Distinguish whitelist violations from generic Wix errors so the
+                // model can react accordingly (and so tests can assert).
+                if (err instanceof WixSiteNotAllowedError) {
+                    return {
+                        content: [
+                            { type: "text", text: `Refused: ${err.message}` },
+                        ],
+                        details: { status: "failed", error: err.message },
+                    };
+                }
+                if (err instanceof WixApiError) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Wix API error (${err.status}): ${err.bodyPreview.slice(0, 300)}`,
+                            },
+                        ],
+                        details: { status: "failed", error: err.message },
+                    };
+                }
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `Error: ${msg}` }],
+                    details: { status: "failed", error: msg },
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=_factory.js.map

package/dist/tools/_factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_factory.js","sourceRoot":"","sources":["../../src/tools/_factory.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,4BAA4B;AAC5B,oEAAoE;AACpE,yEAAyE;AACzE,0EAA0E;AAC1E,uBAAuB;AACvB,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AACxE,wCAAwC;AAKxC,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAkB,MAAM,kBAAkB,CAAC;AA4BvF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAgC,EAChC,MAAiB;IAYjB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,CAAC;IAEpC,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,KAAK;QACL,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM;YACvC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;gBACnD,MAAM,IAAI,GACR,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;oBACjC,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ;wBACxB,CAAC,CAAC,IAAI;wBACN,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACtC,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;oBACjC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;iBAChC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,kEAAkE;gBAClE,yDAAyD;gBACzD,IAAI,GAAG,YAAY,sBAAsB,EAAE,CAAC;oBAC1C,OAAO;wBACL,OAAO,EAAE;4BACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,OAAO,EAAE,EAAE;yBAClD;wBACD,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE;qBAClD,CAAC;gBACJ,CAAC;gBACD,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;oBAC/B,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,kBAAkB,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;6BACxE;yBACF;wBACD,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE;qBAClD,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC;oBAClD,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;iBAC1C,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/blog.d.ts

@@ -0,0 +1,140 @@
+import type { WixClient } from "../wix-client.js";
+export declare function buildBlogTools(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>;
+        draftPostId: import("@sinclair/typebox").TString;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        draftPostId: 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>;
+        title: import("@sinclair/typebox").TString;
+        richContent: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+        excerpt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        coverMedia: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            imageId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            displayed: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+            custom: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        }>>;
+        tagIds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        categoryIds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        slug: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        seoData: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        richContent?: unknown;
+        excerpt?: string | undefined;
+        coverMedia?: {
+            imageId?: string | undefined;
+            displayed?: boolean | undefined;
+            custom?: boolean | undefined;
+        } | undefined;
+        tagIds?: string[] | undefined;
+        categoryIds?: string[] | undefined;
+        slug?: string | undefined;
+        seoData?: unknown;
+        title: 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>;
+        draftPostId: import("@sinclair/typebox").TString;
+        title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        richContent: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+        excerpt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        tagIds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        categoryIds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        slug: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        seoData: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+        fieldMask: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        title?: string | undefined;
+        richContent?: unknown;
+        excerpt?: string | undefined;
+        tagIds?: string[] | undefined;
+        categoryIds?: string[] | undefined;
+        slug?: string | undefined;
+        seoData?: unknown;
+        fieldMask?: string[] | undefined;
+        draftPostId: 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>;
+        postId: import("@sinclair/typebox").TString;
+    }>;
+    execute: (toolCallId: string, params: {
+        siteId?: string | undefined;
+        postId: 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>;
+    }>;
+    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/blog.js

@@ -0,0 +1,191 @@
+// Wix Blog (`/blog/v3/...`) tools.
+//
+// Read endpoints (list drafts, list posts, list categories, list tags)
+// validated live against a real Ataraxis site. Write endpoints
+// (create/update/publish/unpublish/delete) are pattern-validated against
+// the published Wix Blog REST docs but were not exercised live to avoid
+// polluting the production blog.
+import { Type } from "@sinclair/typebox";
+import { defineWixTool } from "./_factory.js";
+const SiteIdParam = Type.Optional(Type.String({
+    description: "Wix site UUID. Optional — falls back to defaultSiteId when omitted. Must be in allowedSiteIds.",
+}));
+export function buildBlogTools(client) {
+    return [
+        // -------------------------------------------------------------------
+        // Drafts
+        // -------------------------------------------------------------------
+        defineWixTool({
+            name: "wix_blog_list_drafts",
+            description: "List blog draft posts (not yet published). Supports paging and basic filtering.",
+            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", "/blog/v3/draft-posts", {
+                siteId: params.siteId,
+                query: {
+                    "paging.limit": params.paging?.limit,
+                    "paging.offset": params.paging?.offset,
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_blog_get_draft",
+            description: "Fetch a single blog draft post by id.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                draftPostId: Type.String({ description: "Draft post id" }),
+            }),
+            run: (params) => client.request("GET", `/blog/v3/draft-posts/${encodeURIComponent(params.draftPostId)}`, { siteId: params.siteId }),
+        }, client),
+        defineWixTool({
+            name: "wix_blog_create_draft",
+            description: "Create a new blog draft post. `richContent` follows the Wix Ricos format. To embed an image, upload it first via wix_media_upload, then reference its `id` in a Ricos `image` node.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                title: Type.String(),
+                richContent: Type.Optional(Type.Unknown({
+                    description: "Ricos rich-content document. See https://dev.wix.com/docs/sdk/articles/working-with-the-sdk/working-with-ricos",
+                })),
+                excerpt: Type.Optional(Type.String()),
+                coverMedia: Type.Optional(Type.Object({
+                    imageId: Type.Optional(Type.String({
+                        description: "Wix Site Media image id returned by wix_media_upload",
+                    })),
+                    displayed: Type.Optional(Type.Boolean()),
+                    custom: Type.Optional(Type.Boolean()),
+                })),
+                tagIds: Type.Optional(Type.Array(Type.String())),
+                categoryIds: Type.Optional(Type.Array(Type.String())),
+                slug: Type.Optional(Type.String()),
+                seoData: Type.Optional(Type.Unknown()),
+            }),
+            run: (params) => client.request("POST", "/blog/v3/draft-posts", {
+                siteId: params.siteId,
+                body: {
+                    draftPost: {
+                        title: params.title,
+                        richContent: params.richContent,
+                        excerpt: params.excerpt,
+                        media: params.coverMedia,
+                        tagIds: params.tagIds,
+                        categoryIds: params.categoryIds,
+                        slug: params.slug,
+                        seoData: params.seoData,
+                    },
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_blog_update_draft",
+            description: "Update fields on an existing blog draft post (PATCH). Only the fields you pass are modified.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                draftPostId: Type.String(),
+                title: Type.Optional(Type.String()),
+                richContent: Type.Optional(Type.Unknown()),
+                excerpt: Type.Optional(Type.String()),
+                tagIds: Type.Optional(Type.Array(Type.String())),
+                categoryIds: Type.Optional(Type.Array(Type.String())),
+                slug: Type.Optional(Type.String()),
+                seoData: Type.Optional(Type.Unknown()),
+                fieldMask: Type.Optional(Type.Array(Type.String(), {
+                    description: "Optional list of paths to update (e.g. ['title', 'richContent']). Falls back to changed fields when omitted.",
+                })),
+            }),
+            run: (params) => {
+                const { siteId, draftPostId, fieldMask, ...rest } = params;
+                return client.request("PATCH", `/blog/v3/draft-posts/${encodeURIComponent(draftPostId)}`, {
+                    siteId,
+                    body: {
+                        draftPost: rest,
+                        ...(fieldMask ? { fieldMask: { paths: fieldMask } } : {}),
+                    },
+                });
+            },
+        }, client),
+        defineWixTool({
+            name: "wix_blog_publish_draft",
+            description: "Publish a draft blog post — makes it visible to site visitors. APPROVAL GATED.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                draftPostId: Type.String(),
+            }),
+            run: (params) => client.request("POST", `/blog/v3/draft-posts/${encodeURIComponent(params.draftPostId)}/publish`, { siteId: params.siteId, body: {} }),
+        }, client),
+        defineWixTool({
+            name: "wix_blog_delete_draft",
+            description: "Permanently delete a blog draft. APPROVAL GATED. Prefer wix_blog_unpublish for published posts (reversible).",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                draftPostId: Type.String(),
+            }),
+            run: (params) => client.request("DELETE", `/blog/v3/draft-posts/${encodeURIComponent(params.draftPostId)}`, { siteId: params.siteId }),
+        }, client),
+        // -------------------------------------------------------------------
+        // Published posts
+        // -------------------------------------------------------------------
+        defineWixTool({
+            name: "wix_blog_list_published",
+            description: "List published blog posts. Supports paging.",
+            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", "/blog/v3/posts", {
+                siteId: params.siteId,
+                query: {
+                    "paging.limit": params.paging?.limit,
+                    "paging.offset": params.paging?.offset,
+                },
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_blog_get_post",
+            description: "Fetch a single published blog post by id.",
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                postId: Type.String(),
+            }),
+            run: (params) => client.request("GET", `/blog/v3/posts/${encodeURIComponent(params.postId)}`, { siteId: params.siteId }),
+        }, client),
+        defineWixTool({
+            name: "wix_blog_unpublish",
+            description: "Move a published blog post back to drafts (reversible). APPROVAL GATED. Use this rather than delete to keep the post recoverable.",
+            // Endpoint shape pattern-validated against the public docs.
+            // Confirm live before promoting to production destructive use.
+            parameters: Type.Object({
+                siteId: SiteIdParam,
+                postId: Type.String(),
+            }),
+            run: (params) => client.request("POST", `/blog/v3/posts/${encodeURIComponent(params.postId)}/move-to-trash`, { siteId: params.siteId, body: {} }),
+        }, client),
+        // -------------------------------------------------------------------
+        // Taxonomy
+        // -------------------------------------------------------------------
+        defineWixTool({
+            name: "wix_blog_list_categories",
+            description: "List blog categories (used to classify posts).",
+            parameters: Type.Object({ siteId: SiteIdParam }),
+            run: (params) => client.request("GET", "/blog/v3/categories", {
+                siteId: params.siteId,
+            }),
+        }, client),
+        defineWixTool({
+            name: "wix_blog_list_tags",
+            description: "List blog tags.",
+            parameters: Type.Object({ siteId: SiteIdParam }),
+            run: (params) => client.request("GET", "/blog/v3/tags", {
+                siteId: params.siteId,
+            }),
+        }, client),
+    ];
+}
+//# sourceMappingURL=blog.js.map