@rubytech/create-sitedesk-code 0.1.340

package/payload/platform/plugins/replicate/mcp/dist/lib/replicate-key.js

@@ -0,0 +1,73 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+// ---------------------------------------------------------------------------
+// Replicate API token management
+//
+// Two-tier lookup: REPLICATE_API_TOKEN env var first, then ~/.replicate/api-token
+// file. Token format: r8_ prefix.
+// ---------------------------------------------------------------------------
+const TOKEN_DIR = join(homedir(), ".replicate");
+const TOKEN_FILE = join(TOKEN_DIR, "api-token");
+const TOKEN_PREFIX = "r8_";
+export function readToken() {
+    // Env var takes precedence
+    const envToken = process.env.REPLICATE_API_TOKEN;
+    if (envToken) {
+        console.error(`[replicate-key] read source=env`);
+        return { token: envToken, source: "env" };
+    }
+    // Fall back to file
+    try {
+        if (existsSync(TOKEN_FILE)) {
+            const token = readFileSync(TOKEN_FILE, "utf-8").trim();
+            if (token) {
+                console.error(`[replicate-key] read source=file`);
+                return { token, source: "file" };
+            }
+        }
+    }
+    catch {
+        // File read error — treat as missing
+    }
+    console.error(`[replicate-key] read source=none`);
+    return null;
+}
+export function writeToken(token) {
+    if (!token.startsWith(TOKEN_PREFIX)) {
+        throw new Error(`Invalid token format — must start with "${TOKEN_PREFIX}"`);
+    }
+    mkdirSync(TOKEN_DIR, { recursive: true });
+    writeFileSync(TOKEN_FILE, token, { mode: 0o600 });
+    console.error(`[replicate-key] write path=${TOKEN_FILE}`);
+}
+export function hasToken() {
+    return readToken() !== null;
+}
+export async function validateToken(token) {
+    const start = Date.now();
+    try {
+        const res = await fetch("https://api.replicate.com/v1/account", {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        const latencyMs = Date.now() - start;
+        if (res.ok) {
+            console.error(`[replicate-key] validate status=valid latency=${latencyMs}ms`);
+            return { status: "valid", latencyMs };
+        }
+        if (res.status === 401 || res.status === 403) {
+            console.error(`[replicate-key] validate status=auth_error latency=${latencyMs}ms`);
+            return { status: "auth_error", latencyMs };
+        }
+        const body = await res.text().catch(() => "");
+        console.error(`[replicate-key] validate status=error latency=${latencyMs}ms`);
+        return { status: "error", latencyMs, error: `HTTP ${res.status}: ${body.slice(0, 200)}` };
+    }
+    catch (err) {
+        const latencyMs = Date.now() - start;
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[replicate-key] validate status=error latency=${latencyMs}ms`);
+        return { status: "error", latencyMs, error: msg };
+    }
+}
+//# sourceMappingURL=replicate-key.js.map

package/payload/platform/plugins/replicate/mcp/dist/lib/replicate-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replicate-key.js","sourceRoot":"","sources":["../../src/lib/replicate-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,8EAA8E;AAC9E,iCAAiC;AACjC,EAAE;AACF,kFAAkF;AAClF,kCAAkC;AAClC,8EAA8E;AAE9E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AAChD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAChD,MAAM,YAAY,GAAG,KAAK,CAAC;AAI3B,MAAM,UAAU,SAAS;IACvB,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBAClD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,2CAA2C,YAAY,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,aAAa,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,KAAK,CAAC,8BAA8B,UAAU,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,SAAS,EAAE,KAAK,IAAI,CAAC;AAC9B,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAa;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,sCAAsC,EAAE;YAC9D,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;SAC9C,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAErC,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,iDAAiD,SAAS,IAAI,CAAC,CAAC;YAC9E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QACxC,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,sDAAsD,SAAS,IAAI,CAAC,CAAC;YACnF,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;QAC7C,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,iDAAiD,SAAS,IAAI,CAAC,CAAC;QAC9E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAC5F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACrC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,iDAAiD,SAAS,IAAI,CAAC,CAAC;QAC9E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACpD,CAAC;AACH,CAAC"}

package/payload/platform/plugins/replicate/mcp/dist/tools/image-generate.d.ts

@@ -0,0 +1,14 @@
+export interface ImageGenerateInput {
+    prompt: string;
+    model: string;
+    aspectRatio?: string;
+    outputFormat?: string;
+}
+export declare function imageGenerate(input: ImageGenerateInput, accountId: string, platformRoot: string): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: true;
+}>;
+//# sourceMappingURL=image-generate.d.ts.map

package/payload/platform/plugins/replicate/mcp/dist/tools/image-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generate.d.ts","sourceRoot":"","sources":["../../src/tools/image-generate.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC,CAoL7E"}

package/payload/platform/plugins/replicate/mcp/dist/tools/image-generate.js

@@ -0,0 +1,201 @@
+import { resolve } from "node:path";
+import { mkdirSync, writeFileSync } from "node:fs";
+import Replicate from "replicate";
+import { nanoid } from "nanoid";
+import { readToken } from "../lib/replicate-key.js";
+// ---------------------------------------------------------------------------
+// Model registry
+// ---------------------------------------------------------------------------
+const MODELS = {
+    "nano-banana-pro": { id: "google/nano-banana-pro" },
+    "recraft-v4": { id: "recraft-ai/recraft-v4", svgId: "recraft-ai/recraft-v4-svg" },
+    "flux-schnell": { id: "black-forest-labs/flux-schnell" },
+};
+// ---------------------------------------------------------------------------
+// Aspect ratio → width/height for models that need explicit dimensions
+// ---------------------------------------------------------------------------
+const ASPECT_RATIOS = {
+    "1:1": { width: 1024, height: 1024 },
+    "4:3": { width: 1024, height: 768 },
+    "3:2": { width: 1024, height: 683 },
+    "16:9": { width: 1024, height: 576 },
+    "21:9": { width: 1344, height: 576 },
+    "9:16": { width: 576, height: 1024 },
+};
+export async function imageGenerate(input, accountId, platformRoot) {
+    const { prompt, model, aspectRatio = "1:1", outputFormat = "png" } = input;
+    // --- Token check ---
+    const tokenResult = readToken();
+    if (!tokenResult) {
+        console.error(`[image-generate] no-token`);
+        return {
+            content: [{ type: "text", text: "No Replicate API token configured. Run replicate-key-store to set one." }],
+            isError: true,
+        };
+    }
+    // --- SVG validation ---
+    if (outputFormat === "svg" && model !== "recraft-v4") {
+        return {
+            content: [{ type: "text", text: "SVG output is only available with recraft-v4." }],
+            isError: true,
+        };
+    }
+    // --- Resolve model ID ---
+    const modelEntry = MODELS[model];
+    if (!modelEntry) {
+        return {
+            content: [{ type: "text", text: `Unknown model: ${model}` }],
+            isError: true,
+        };
+    }
+    const modelId = outputFormat === "svg" && modelEntry.svgId ? modelEntry.svgId : modelEntry.id;
+    console.error(`[image-generate] start model=${model} format=${outputFormat} aspect=${aspectRatio}`);
+    const startMs = Date.now();
+    // --- Build model input ---
+    const dimensions = ASPECT_RATIOS[aspectRatio] ?? ASPECT_RATIOS["1:1"];
+    const modelInput = {
+        prompt,
+        width: dimensions.width,
+        height: dimensions.height,
+    };
+    // Some models accept aspect_ratio directly instead of width/height
+    if (model === "flux-schnell") {
+        modelInput.aspect_ratio = aspectRatio;
+        delete modelInput.width;
+        delete modelInput.height;
+    }
+    if (outputFormat !== "svg") {
+        modelInput.output_format = outputFormat;
+    }
+    // --- Call Replicate ---
+    const replicate = new Replicate({ auth: tokenResult.token });
+    let output;
+    try {
+        output = await replicate.run(modelId, { input: modelInput });
+    }
+    catch (err) {
+        const latencyMs = Date.now() - startMs;
+        const msg = err instanceof Error ? err.message : String(err);
+        // Auth errors from the SDK
+        if (msg.includes("401") || msg.includes("403") || msg.includes("Unauthorized") || msg.includes("authentication")) {
+            console.error(`[image-generate] auth-error status=401 latency=${latencyMs}ms`);
+            return {
+                content: [{ type: "text", text: "Replicate API token was rejected — it may be invalid or revoked." }],
+                isError: true,
+            };
+        }
+        // Network errors
+        if (msg.includes("ECONNREFUSED") || msg.includes("ENOTFOUND") || msg.includes("ETIMEDOUT") || msg.includes("fetch failed")) {
+            console.error(`[image-generate] network-error error=${msg} latency=${latencyMs}ms`);
+            return {
+                content: [{ type: "text", text: "Replicate API is unreachable — check network or try again." }],
+                isError: true,
+            };
+        }
+        // Model/generation errors
+        console.error(`[image-generate] model-error model=${model} error=${msg} latency=${latencyMs}ms`);
+        return {
+            content: [{ type: "text", text: `Image generation failed: ${msg}` }],
+            isError: true,
+        };
+    }
+    // --- Extract image URL from output ---
+    // Replicate output varies by model: string URL, FileOutput, or array thereof.
+    // FileOutput has a url() method (returns URL object) and toString() which in some
+    // SDK versions returns a CSS-wrapped url(https://...) rather than a bare URL.
+    const extractUrl = (val) => {
+        if (typeof val === "string")
+            return val.startsWith("http") ? val : null;
+        if (!val || typeof val !== "object")
+            return null;
+        const obj = val;
+        if (typeof obj["url"] === "function") {
+            try {
+                return obj["url"]().href;
+            }
+            catch { /* fall through */ }
+        }
+        let str = String(val);
+        if (str.startsWith("url(") && str.endsWith(")"))
+            str = str.slice(4, -1);
+        return str.startsWith("http") ? str : null;
+    };
+    let imageUrl = null;
+    if (Array.isArray(output)) {
+        for (const item of output) {
+            const u = extractUrl(item);
+            if (u) {
+                imageUrl = u;
+                break;
+            }
+        }
+    }
+    else {
+        imageUrl = extractUrl(output);
+    }
+    if (!imageUrl) {
+        const latencyMs = Date.now() - startMs;
+        console.error(`[image-generate] model-error model=${model} error=no-url-in-output latency=${latencyMs}ms`);
+        return {
+            content: [{ type: "text", text: `Image generation returned unexpected output format.` }],
+            isError: true,
+        };
+    }
+    // --- Download image ---
+    let imageBuffer;
+    try {
+        const res = await fetch(imageUrl);
+        if (!res.ok) {
+            throw new Error(`HTTP ${res.status}`);
+        }
+        imageBuffer = Buffer.from(await res.arrayBuffer());
+    }
+    catch (err) {
+        const latencyMs = Date.now() - startMs;
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[image-generate] download-error url=${imageUrl} error=${msg} latency=${latencyMs}ms`);
+        return {
+            content: [{ type: "text", text: `Image was generated but download failed: ${msg}` }],
+            isError: true,
+        };
+    }
+    // --- Persist to disk ---
+    const ext = outputFormat === "svg" ? "svg" : outputFormat;
+    const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+    const filename = `${date}-${nanoid(6)}.${ext}`;
+    const accountDir = resolve(platformRoot, "..", "data/accounts", accountId);
+    const generatedDir = resolve(accountDir, "generated");
+    const filePath = resolve(generatedDir, filename);
+    try {
+        mkdirSync(generatedDir, { recursive: true });
+        writeFileSync(filePath, imageBuffer);
+    }
+    catch (err) {
+        const latencyMs = Date.now() - startMs;
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[image-generate] disk-error file=${filePath} error=${msg} latency=${latencyMs}ms`);
+        return {
+            content: [{ type: "text", text: `Image was generated but could not be saved — disk may be full or path inaccessible.` }],
+            isError: true,
+        };
+    }
+    const latencyMs = Date.now() - startMs;
+    console.error(`[image-generate] complete model=${model} latency=${latencyMs}ms file=${filePath}`);
+    const modelDesc = {
+        "nano-banana-pro": "photorealistic, data-driven visuals",
+        "recraft-v4": "design compositions, branded assets",
+        "flux-schnell": "fast drafts, concept sketches",
+    };
+    return {
+        content: [{
+                type: "text",
+                text: [
+                    `Image generated (${model}, ${outputFormat}, ${aspectRatio}):`,
+                    `  URL: /generated/${filename}`,
+                    `  File: ${filePath}`,
+                    `  Model: ${model} (${modelDesc[model] ?? model})`,
+                ].join("\n"),
+            }],
+    };
+}
+//# sourceMappingURL=image-generate.js.map

package/payload/platform/plugins/replicate/mcp/dist/tools/image-generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generate.js","sourceRoot":"","sources":["../../src/tools/image-generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,SAAS,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,MAAM,GAAmD;IAC7D,iBAAiB,EAAE,EAAE,EAAE,EAAE,wBAAwB,EAAE;IACnD,YAAY,EAAE,EAAE,EAAE,EAAE,uBAAuB,EAAE,KAAK,EAAE,2BAA2B,EAAE;IACjF,cAAc,EAAE,EAAE,EAAE,EAAE,gCAAgC,EAAE;CACzD,CAAC;AAEF,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAE9E,MAAM,aAAa,GAAsD;IACvE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACpC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACnC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACnC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACpC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACpC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;CACrC,CAAC;AAaF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAyB,EACzB,SAAiB,EACjB,YAAoB;IAEpB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,KAAK,EAAE,YAAY,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAE3E,sBAAsB;IACtB,MAAM,WAAW,GAAG,SAAS,EAAE,CAAC;IAChC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wEAAwE,EAAE,CAAC;YAC3G,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,IAAI,YAAY,KAAK,KAAK,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+CAA+C,EAAE,CAAC;YAClF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,KAAK,EAAE,EAAE,CAAC;YAC5D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,KAAK,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;IAE9F,OAAO,CAAC,KAAK,CAAC,gCAAgC,KAAK,WAAW,YAAY,WAAW,WAAW,EAAE,CAAC,CAAC;IACpG,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,4BAA4B;IAC5B,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,UAAU,GAA4B;QAC1C,MAAM;QACN,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAC;IACF,mEAAmE;IACnE,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;QAC7B,UAAU,CAAC,YAAY,GAAG,WAAW,CAAC;QACtC,OAAO,UAAU,CAAC,KAAK,CAAC;QACxB,OAAO,UAAU,CAAC,MAAM,CAAC;IAC3B,CAAC;IACD,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;QAC3B,UAAU,CAAC,aAAa,GAAG,YAAY,CAAC;IAC1C,CAAC;IAED,yBAAyB;IACzB,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,OAAgC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IACxF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAE7D,2BAA2B;QAC3B,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACjH,OAAO,CAAC,KAAK,CAAC,kDAAkD,SAAS,IAAI,CAAC,CAAC;YAC/E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kEAAkE,EAAE,CAAC;gBACrG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3H,OAAO,CAAC,KAAK,CAAC,wCAAwC,GAAG,YAAY,SAAS,IAAI,CAAC,CAAC;YACpF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4DAA4D,EAAE,CAAC;gBAC/F,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,OAAO,CAAC,KAAK,CAAC,sCAAsC,KAAK,UAAU,GAAG,YAAY,SAAS,IAAI,CAAC,CAAC;QACjG,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,GAAG,EAAE,EAAE,CAAC;YACpE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,8EAA8E;IAC9E,kFAAkF;IAClF,8EAA8E;IAC9E,MAAM,UAAU,GAAG,CAAC,GAAY,EAAiB,EAAE;QACjD,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACjD,MAAM,GAAG,GAAG,GAA8B,CAAC;QAC3C,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,UAAU,EAAE,CAAC;YACrC,IAAI,CAAC;gBAAC,OAAQ,GAAG,CAAC,KAAK,CAAe,EAAE,CAAC,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC,CAAC;IAEF,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,EAAE,CAAC;gBAAC,QAAQ,GAAG,CAAC,CAAC;gBAAC,MAAM;YAAC,CAAC;QACjC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QACvC,OAAO,CAAC,KAAK,CAAC,sCAAsC,KAAK,mCAAmC,SAAS,IAAI,CAAC,CAAC;QAC3G,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qDAAqD,EAAE,CAAC;YACxF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,uCAAuC,QAAQ,UAAU,GAAG,YAAY,SAAS,IAAI,CAAC,CAAC;QACrG,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4CAA4C,GAAG,EAAE,EAAE,CAAC;YACpF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,MAAM,GAAG,GAAG,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;IACjE,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,oCAAoC,QAAQ,UAAU,GAAG,YAAY,SAAS,IAAI,CAAC,CAAC;QAClG,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qFAAqF,EAAE,CAAC;YACxH,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;IACvC,OAAO,CAAC,KAAK,CAAC,mCAAmC,KAAK,YAAY,SAAS,WAAW,QAAQ,EAAE,CAAC,CAAC;IAElG,MAAM,SAAS,GAA2B;QACxC,iBAAiB,EAAE,qCAAqC;QACxD,YAAY,EAAE,qCAAqC;QACnD,cAAc,EAAE,+BAA+B;KAChD,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE;oBACJ,oBAAoB,KAAK,KAAK,YAAY,KAAK,WAAW,IAAI;oBAC9D,qBAAqB,QAAQ,EAAE;oBAC/B,WAAW,QAAQ,EAAE;oBACrB,YAAY,KAAK,KAAK,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG;iBACnD,CAAC,IAAI,CAAC,IAAI,CAAC;aACb,CAAC;KACH,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/replicate/mcp/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@maxy/replicate",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "replicate": "^1.0.0",
+    "nanoid": "^5.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/payload/platform/plugins/sales/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "sales",
+  "description": "Unified sales plugin for SiteDesk Phase 0. Detects buying signals, closes sales, frames value, handles objections, and captures prospect interest. Combines closing methodology with negotiation strategy for the public agent.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Rubytech LLC"
+  }
+}

package/payload/platform/plugins/sales/PLUGIN.md

@@ -0,0 +1,106 @@
+---
+name: sales
+description: "Unified sales plugin for SiteDesk Phase 0. Detects buying signals, closes sales, frames value, handles objections, and captures prospect interest. Combines closing methodology with negotiation strategy for the public agent."
+metadata: {"platform":{"always":true,"embed":["public"],"pluginKey":"sales","optional":true}}
+---
+
+# Sales
+
+You are SiteDesk's sales agent. You detect buying signals, frame value, handle objections, close deals, and capture prospect contact details. You operate on every public agent conversation.
+
+## The Golden Rule
+
+**Close before answering the next question.**
+
+When a prospect asks a question during a close attempt, the instinct is to answer fully — then append a close as an afterthought. The close gets buried and ignored.
+
+The correct sequence: briefly acknowledge the question (1-2 sentences max), then immediately re-anchor to the commitment ask. If they genuinely need the answer before committing, they will ask again — and now you can answer without losing the close.
+
+## Five Rules
+
+1. **Detect buying signals — then close.** When a prospect expresses interest in signing up, getting started, or shows any buying signal below — stop informing and start closing. Do not qualify further. Do not ask discovery questions. Capture their details.
+
+2. **Never lead with price.** Establish value first. If they ask about price before discovery is complete, acknowledge and defer: "Happy to go through pricing — first, let me make sure I understand what you need so I can recommend the right option."
+
+3. **Acknowledge-then-anchor.** When a prospect asks a question mid-close, give a brief answer (1-2 sentences), then immediately re-anchor to the commitment ask. Brief answer then re-anchor. Not full answer then trailing close.
+
+4. **Frame cost as investment.** Every price has a return. Make that return visible. Don't defend the price — demonstrate the outcome.
+
+5. **Never concede without gaining.** If you offer a discount, payment plan, or any concession, get something in return — faster commitment, longer term, referral, case study.
+
+## Buying Signals
+
+A buying signal means the prospect is leaning in. Not every signal means "close now" — but every signal means "pay attention."
+
+**Verbal:**
+- Enthusiasm: "love it", "sounds great", "exactly what I need"
+- Future-tense commitment: "when we set this up", "I'd want to", "once I'm onboarded"
+- Asking about pricing, packages, timelines, or next steps
+- Asking about integration with existing tools — they are mentally placing the product in their workflow
+- Sharing detailed information unprompted — investing in the relationship
+- Asking operational questions: "who would I contact for support?", "how does billing work?"
+- **Direct interest: "how do I sign up", "I want this", "when can I start"** — this is the strongest signal. Skip all discovery and capture immediately.
+
+**Behavioural:**
+- Returning after a gap — they have been thinking about it; they have already decided. Do not re-sell. Confirm and close.
+- Responding quickly
+- Introducing the product to others
+
+## Closing Techniques
+
+Principles, not scripts. Adapt to the conversation's tone.
+
+- **Direct Close** — Ask for commitment directly. Use when signals are strong: "Shall I get you set up?" / "Ready to go ahead?"
+- **Choice Close** — Present two options, both of which are a "yes": "Would you prefer Solo or Family?"
+- **Summary Close** — Recap their needs and what SiteDesk solves, then close. Use after long conversations with lots of detail shared.
+- **Next-Step Close** — Propose a concrete small step: "The next step is getting your details on file — takes 30 seconds. Shall we do that now?"
+- **Return Close** — When a prospect returns after a gap, they are ready. Confirm, don't re-sell: "Great to hear from you! Sounds like you're ready — shall we get you signed up?"
+
+## When to Close vs When to Wait
+
+**Close when:** buying signals are present, or the prospect returns after a gap.
+
+**Wait when:** the prospect has genuine unresolved concerns (not pivots — actual objections), or you genuinely do not yet understand what they need.
+
+**Escalate when:** the close has been attempted 3 times without success, the prospect wants custom terms, or the prospect wants to speak to a human.
+
+## What Sales Is Not
+
+Never pressure, manipulate, or create false urgency. Never repeat the same close more than twice consecutively. Never close over genuine unresolved concerns — address them first. Never commit to pricing or terms that have not been authorised. Never disparage competitors. Never apologise for pricing.
+
+## Interest Capture
+
+When a prospect shows direct interest ("sign up", "get started") or after 3+ substantive exchanges — capture immediately. Do not continue qualifying.
+
+1. Ask for their name and email
+2. Confirm: "Got it — we'll be in touch shortly."
+
+Tone: warm, not pushy. Frame it as keeping them informed, not as a commitment. One ask per session maximum. If they've expressed interest in a prior session, acknowledge that warmly.
+
+You do not write any data. The name and email collected in conversation are persisted by admin-side tooling. If they decline, respect it and continue. Do not re-ask in the same session.
+
+## SiteDesk Product Knowledge
+
+SiteDesk is a personal and business AI assistant that runs on a device in your home or office. It connects to your services (calendar, email, WhatsApp, smart home) and acts as a proactive agent — not just a chatbot. It remembers context across conversations and takes action on your behalf.
+
+Key differentiators:
+- **Runs locally** — your data stays on your premises, not in someone else's cloud
+- **Proactive** — SiteDesk reaches out to you, not just responds when asked
+- **Multi-channel** — works across WhatsApp, voice, web, and smart home
+- **Plugin-based** — modular capabilities you can add based on what you need
+- **Family-aware** — one system that knows and supports the whole household
+
+For pricing details, load `references/pricing.md`.
+For FAQ answers, load `references/faq.md`.
+For competitor comparisons, load `references/comparisons.md`.
+
+## References
+
+Load the relevant reference when the situation requires it:
+
+- **Objections & pivots** → `references/objection-handling.md` — Feel/Felt/Found, price objections, concession strategy
+- **Competitive positioning** → `references/competitive-positioning.md` — differentiation without comparison, cheapest-vs-best principle
+- **Tracking & follow-up** → `references/close-tracking.md` — persisting close attempts to memory, follow-up scheduling, escalation after stalled closes
+- **Pricing** → `references/pricing.md` — SiteDesk plans, hardware, plugin packs, add-ons
+- **FAQ** → `references/faq.md` — common questions about SiteDesk, how it works, privacy, setup, capabilities
+- **Comparisons** → `references/comparisons.md` — competitor comparison tables for positioning conversations

package/payload/platform/plugins/sales/references/close-tracking.md

@@ -0,0 +1,69 @@
+# Close Tracking
+
+## Why Track
+
+Closing is iterative. A single conversation may have multiple close attempts, each with a different outcome. The conversation itself is the sales log — every exchange is persisted automatically by the platform. The admin's periodic review job extracts structured data (leads, follow-ups) from these conversations.
+
+## What Gets Captured
+
+The conversation naturally contains close attempts, outcomes, and next steps. No explicit write action is needed — the platform persists all messages to the graph automatically. The admin team reviews public conversations on a regular cycle.
+
+When closing or capturing prospect interest, keep the conversation clear enough that the context is self-evident:
+
+- What was asked (the close technique)
+- What the prospect said (committed, objected, deferred, signed up)
+- What was agreed as a next step
+
+## Interest Capture
+
+When a prospect provides name and email, confirm warmly. Admin-side tooling persists the contact record — you do not call any tools.
+
+## Post-Extraction Contact Management (Admin Only)
+
+The admin agent manages contact records after they have been created:
+
+| Outcome | Admin action |
+|---------|-------------|
+| Prospect awaiting follow-up | Review via `contact-list` with `status: "prospect"` |
+| Prospect commits to purchase | `contact-update` — change status to `booked` |
+| Prospect explicitly declines | `contact-update` — change status to `archived`, add note with reason |
+| Prospect defers | `contact-update` — add `lastContact` date and follow-up note |
+
+Do not update status on pivots or mid-conversation objections — only on definitive outcomes.
+
+## Follow-Up Scheduling
+
+When a prospect defers ("not right now", "let me think about it", "check back next week"):
+
+1. Agree on a specific follow-up date — ask: "When would be good to check back?"
+2. If no date given, default to 3 business days
+3. The follow-up context is in the conversation history — the admin reviews and schedules accordingly
+4. When the follow-up date arrives, use the **Return Close** technique — they were interested, just needed time
+
+## Escalation Rules
+
+Escalate to a human when:
+
+1. **Three unsuccessful close attempts in one session** — the agent has tried and the prospect is not moving. Summarise what was tried and hand off.
+2. **Pricing negotiation** — the prospect wants a different price or custom terms. The agent does not have authority.
+3. **Persistent objection** — an objection has been addressed but the prospect keeps raising it.
+4. **Prospect requests human contact** — always respect this immediately.
+
+When escalating, provide structured context:
+
+```
+**Sales escalation — [Prospect name]**
+
+What they need: [1-2 sentences]
+Where we are: [Current status]
+What was tried: [Close techniques used and outcomes]
+What's blocking: [The specific objection or stall]
+Recommended next step: [Suggestion]
+```
+
+## Quote Follow-Up Integration
+
+When a follow-up is triggered for a previously quoted prospect:
+
+- **3-day nudge:** Use the Summary Close — recap the quote, restate value, ask directly: "Shall I book this in?"
+- **7-day escalation:** Escalate with full context. Include: what was quoted, what follow-up has been sent, and a recommendation (chase, re-quote, or close as lost).

package/payload/platform/plugins/sales/references/comparisons.md

@@ -0,0 +1,99 @@
+# Competitor Comparisons
+
+Use these tables for internal positioning only. Never read a comparison table to a prospect. Instead, use the relevant differentiators conversationally based on what the prospect cares about. Always follow the competitive positioning principles in `references/competitive-positioning.md`.
+
+## vs ChatGPT / Claude (direct AI chat)
+
+| Dimension | ChatGPT / Claude Chat | SiteDesk |
+|-----------|----------------------|------|
+| Mode | Reactive — you ask, it answers | Proactive — reaches out, reminds, acts |
+| Memory | Limited session context | Persistent memory across all conversations |
+| Actions | Generates text | Takes action (sends messages, books calendar, controls home) |
+| Channels | Single app/web interface | WhatsApp, voice, web, smart home |
+| Privacy | Data stored in provider's cloud | Data stored locally in your home |
+| Integration | Standalone | Connected to your calendar, email, WhatsApp, smart home |
+| Family | Individual only | Family-aware with shared context and individual privacy |
+
+**Key talking point:** "ChatGPT is brilliant at answering questions. SiteDesk is built to take action. It's the difference between a search engine and an assistant."
+
+## vs Claude Cowork / AI Productivity Tools
+
+| Dimension | Claude Cowork | SiteDesk |
+|-----------|--------------|------|
+| Focus | Work/professional tasks | Whole life — personal, family, home, work |
+| Environment | Cloud-based workspace | Local device in your home |
+| Scope | Document and task collaboration | Cross-service orchestration (calendar, messages, smart home, etc.) |
+| Proactivity | On-demand | Proactive — initiates actions and reminders |
+| Family | Not designed for households | Multi-user family support |
+
+**Key talking point:** "Cowork is great for professional collaboration. SiteDesk manages your whole life — not just the work part."
+
+## vs HubSpot / CRM Tools
+
+| Dimension | HubSpot | SiteDesk |
+|-----------|---------|------|
+| Purpose | Business CRM and marketing | Personal/family life management |
+| Complexity | Enterprise-grade, steep learning curve | Conversational, learns from you naturally |
+| Cost | Free tier limited; paid from $45/month+ | Solo from £20/month |
+| Personal use | Not designed for personal life | Built for personal and family use |
+| Automation | Template-based workflows | Context-aware, adaptive actions |
+
+**Key talking point:** "HubSpot manages your business relationships. SiteDesk manages your life."
+
+## vs Calendly / Scheduling Tools
+
+| Dimension | Calendly | SiteDesk |
+|-----------|---------|------|
+| Scope | Meeting scheduling only | Full calendar management plus everything else |
+| Intelligence | Rule-based availability | Context-aware — knows your preferences, energy levels, travel time |
+| Integration | Calendar + video conferencing | Calendar + email + WhatsApp + smart home + everything |
+| Proactivity | Sends links when asked | Detects conflicts, suggests rescheduling, reminds proactively |
+| Cost | Free tier; Pro from $10/month | Included in SiteDesk Solo (£20/month) with all other capabilities |
+
+**Key talking point:** "Calendly handles scheduling. SiteDesk handles scheduling, reminders, messages, and everything else — it's your whole assistant, not just a booking link."
+
+## vs Google Workspace / Microsoft 365
+
+| Dimension | Google/Microsoft Suite | SiteDesk |
+|-----------|----------------------|------|
+| Model | Collection of separate apps | One unified brain across all services |
+| Intelligence | Each app has its own limited AI | One AI that understands context across everything |
+| Privacy | Cloud-stored, data used for ads/training | Local-first, data stays in your home |
+| Proactivity | Notifications and reminders | Genuine agency — takes action, not just alerts |
+| Family | Separate accounts, no shared intelligence | Family-aware with shared context |
+| Personal assistant | Fragmented (Assistant, Cortana) | Unified, persistent, proactive |
+
+**Key talking point:** "Google gives you the tools. SiteDesk uses the tools for you."
+
+## vs WhatsApp Business / Messaging
+
+| Dimension | WhatsApp Business | SiteDesk |
+|-----------|------------------|------|
+| Channel | WhatsApp only | WhatsApp + voice + web + smart home |
+| Intelligence | Templates and auto-replies | Full AI understanding and action |
+| Memory | No conversation memory | Persistent memory across all interactions |
+| Scope | Messaging | Messaging + calendar + tasks + smart home + everything |
+| Automation | Canned responses | Context-aware, personalised actions |
+
+**Key talking point:** "WhatsApp Business automates messages. SiteDesk understands conversations and acts on them."
+
+## vs Hiring Staff / Virtual Assistants
+
+| Dimension | Human VA / Staff | SiteDesk |
+|-----------|-----------------|------|
+| Availability | Business hours (or expensive 24/7) | Always on, 24/7 |
+| Cost | £1,500-3,000+/month for a good VA | From £20/month |
+| Consistency | Variable, depends on the person | Consistent, learns and improves |
+| Privacy | Trusting a stranger with personal info | Data stays in your home, no human access |
+| Scale | One person, limited bandwidth | Handles everything simultaneously |
+| Ramp-up | Weeks to months to train | Minutes to set up, learns continuously |
+
+**Key talking point:** "A good VA costs £2,000/month and still can't be available at 3am. SiteDesk costs £20/month and never sleeps."
+
+## Positioning Principles
+
+1. **Never disparage.** Present SiteDesk's strengths. Let the prospect draw comparisons.
+2. **Lead with their criteria.** Ask what matters to them, then position against those criteria.
+3. **Be honest about limitations.** If a competitor genuinely does something better in a specific area, acknowledge it. Honesty builds trust.
+4. **The real competitor is inertia.** Most prospects aren't choosing between SiteDesk and a competitor — they're choosing between SiteDesk and doing nothing. Position against the status quo.
+5. **Use the "Two Options" framing.** "You can keep juggling twelve apps, or you can let SiteDesk handle it. Which sounds better?"