webfaCeMEdia

DELETE a Sanity document by _id. Destructive — only restorable via Sanity's revision history within the retention window. Requires confirmDelete: true.

Delete a draft, approved or failed social post. Scheduled and published posts are refused — those are handled in the dashboard. Confirm with the owner before deleting something they wrote or approved.

Which client a domain (or an email sender's address) belongs to, matched against the client portfolio's site domain (www-insensitive; subdomains and agent domains also match). webfaCeMEdia's operator account searches every client; any other account searches only its own. Returns { domain, scope, found, client: null | { slug, displayName, siteDomain, agentDomain, type: 'full'|'site-only', status: 'active'|'inactive' }, matchedBy: 'exact'|'subdomain'|'agent_domain', deploymentHealth: null | { status: 'up'|'down'|'degraded', checkedAt, httpStatus, latencyMs, error } (latest 15-minute uptime probe) }.

Generate an image, logo, icon, or illustration for a client via Creative Studio. Optionally uploads to Sanity. Best for: hero images, service cards, blog covers, favicons, social post imagery.

Operator-only (admin). Generate the full 3-variant design-preview SET for a planner project page — mixed variantModels, a distinct palette/reference per variant, all behind ONE preview token — the same engine the redesign intake uses. Via the WebFacePress Next operator route. Body: projectId (required), optional pageKey (defaults to the project's homepage), variantModels (1–3 of 'anthropic' (Claude Opus) | 'zai' (GLM) | 'grok' (Grok 4.5) | 'openai' (GPT-5.6 Sol) | 'gemini' (Gemini 3.1 Pro); OpenRouter-routed models require OPENROUTER_API_KEY on the planner deployment; defaults to the configured mix), requireApproval (defaults to project/global default), userId (defaults to the project's own owner). Returns { setToken, bundleIds, previewUrl, pageKey }; the set is held pending_approval by default. Poll list_lab_bundles until each bundle's status == 'completed'. Returns a clean not_enabled response if operatorBaseUrl / operatorApiSecret are unset.

Return contact count, pending drafts, recent runs, and AI config for a client's agent.

Return one Insights site's metadata, last 30 days of daily rollups, and last 100 raw events for debug.

READ how a project's brand guide is built: the live branding fields (all colors incl. dark/footer, fonts, wordmark, logo URLs, theme), the full curated palette library (28 palettes × 14 industry kinds), and the Lab taste-pack vocabulary (palette archetypes + references with fit tags). Use it to author a brand block for create_project or targeted update_project_branding edits. Read-only.

Website chat conversations with a visitor who gave this email address (typed it in the chat, submitted it in a chat form, or it was captured by the chat's lead form), newest first, up to 5. Scoped to your own sites (webfaCeMEdia's operator account sees every site on the platform). Returns { email, scope, found, totalMatches, chats: [{ sessionId, siteId, siteHost, startedAt, lastMessageAt (ISO), summary (the stored AI summary, else the visitor's first message), summarySource, messageCount, matchedBy, transcriptUrl (null: no per-conversation link yet) }] }.

Get detailed information for a single client including config, contact count, and recent agent runs.

Look up ONE CRM contact by email address (case-insensitive) — the CRM card for an email sender. Returns { found, contact: null | { id, name, firstName, lastName, company, email, status, source, lastContactDate, nextStep, nextStepAt, notes (last 500 chars), starred, staleScore, engagement: { score, lastOpened, lastClicked, unsubscribed } }, recentReplies: last 5 inbound campaign replies { id, from, subject, snippet, receivedAt } }. Use contact.id with update_contact.

Fleet-level health summary across all client deployments. Each entry separates LIVENESS from HEALTH: `reachable` is the endpoint ping; `agentHealthy` is derived from the agent's runs (NOT the ping) — a deployment whose syncs complete is healthy even if unreachable. `online` is a back-compat alias of `reachable`. Counts (`contacts`, `lastRunAt`) come from the same source as `get_agent_stats`. CRITICAL for unattended use: read `statsSource` before trusting counts — `'live'` = fresh, `'cache'` = last-known (also `stale:true`), `'unavailable'` = unknown (`contacts` is `null`, NEVER `0` — do not treat as zero). `summary` buckets: `healthy` (reachable + agentHealthy), `unreachable` (syncing but ping failed), `failing` (agentHealthy=false ONLY), `unknown` (stats unresolved), `siteOnly`. Each entry has `kind: 'full' | 'site-only'`; site-only deployments (no Convex agent) are pinged via their site URL and counted in `summary.siteOnly`, never `failing`.

Fetch a single Sanity document by _id, regardless of type. Returns the full document JSON with image references preserved as _ref strings (not dereferenced URLs) so they can be reused in patch_document.

Fetch a point-in-time SNAPSHOT of a Sanity document at a given revision (from list_document_history) or ISO time. Returns the document as it existed then. Returns 'no_history_in_range' when outside the retention window. Read-only — does not modify anything.

The business's Facebook, Instagram and Google ads at a glance: its ad accounts (spent this month, monthly limit), each campaign and its status (running, paused, waiting for your approval — with the review link), changes waiting for the owner's yes, and how many campaigns webfaCeMEdia is preparing. Start here for any ads question.

How the ads are doing over the last N days (default 30): spend, impressions, clicks, leads and cost per lead, compared with the period before, per platform and per campaign. Numbers refresh every hour. Explain them plainly; pair with get_my_website_leads.

Fetch header, footer, and social navigation for a client via site singleton references. Read-only.

Fetch a single page's full module content by slug or id. Read-only.

Read a project's BUILT homepage content so you can QC the build against the prospect's real offering BEFORE sending — the preview link is held for approval, so this is the way to inspect output programmatically. Returns { businessName, industry, brand, brief:{industry,offerings,differentiator,goal}, homepage:{ slug, title, modules:[{type,heading,subheading,items[]}] }, pages:[{slug,title,moduleTypes[]}] }. Compare `homepage` against `brief` (and the prospect's real site): does the hero lead with their actual offering? Are the services in the right order? Did a stale template positioning leak in? Owner-scoped on the public connector. not_enabled if the operator API is unset.

Poll a project's build + preview status — use after create_project build:'full' or batch_create_projects to know when the build is done and to get the shareable preview link. Returns { buildStatus, buildError, hasPreview, previewUrl, previewStatus, sentTo, variants:[{bundleId,status}] }. The build is complete when buildStatus is 'generated' (or hasPreview is true); then open previewUrl to review the redesign before sending. Owner-scoped on the public connector. not_enabled if the operator API is unset.

Inspect a site's content schema BEFORE writing. With { client }, returns that client's actually-DEPLOYED Sanity schema (source: 'server') or the bundled template (source: 'template-fallback') if none is deployed — field support differs from site to site (e.g. some sites have i18n fields, different module sets). With { client, type }, returns that type's allowed fields and which are multilingual (i18nFields). Without { client }, returns the generic template baseline (advisory only). Use this to learn valid fields before create_document / patch_document so writes aren't rejected by the schema gate.

Generic singleton fetcher for whitelisted document IDs (site, pricing, shop-settings, etc.). Read-only.

Fetch the site singleton (title, blurb, logo, announcements, CTAs, copyright, personalization) for a client. Read-only.

Read one social post in full (captions, assets, status, schedule, publish results) by postId.

Paginated raw event log for one site (debug / verification). Pass `dayBucket` (UTC ISO date) to scope.

List every site registered in the webfaCeMEdia Insights Convex deployment, with last-7-day pageview/visitor counts and archive status.

The curated brand-palette library (28 hand-picked, WCAG-checked palettes grouped by 14 industry kinds — each with accent/primary/secondary/canvas/ink + dark & footer colors). Pick one and pass its colors into create_project's brand block or update_project_branding. Read-only, no arguments.

List Brevo email campaigns for a client, optionally filtered by status.

List all managed client deployments with online status, Convex URL, agent domain, and timezone. Archived clients (archive_project) are hidden unless includeArchived is true.

List contacts for a client, optionally filtered by score bucket or free-text search.

List the revision history of a Sanity document, NEWEST-FIRST: [{ rev, timestamp, author }]. Use to find a revision to inspect or roll back to. Returns status 'no_history_in_range' (not an error) when the document is older than the plan's history retention window. Read-only.

Discover which Sanity document types exist in a client's dataset. Returns each _type with a count. Use this first to find non-page types (portfolio, testimonial, blog.post, etc.) before listing or fetching documents.

List documents of a specific Sanity _type with pagination. Returns _id, _type, _updatedAt, title, slug by default (override with `fields`). Use list_document_types first to discover what types exist.

List outreach drafts for a client, optionally filtered by status.

List inbound email replies recorded for an address (replies to campaigns/sequences, newest first). Returns { replyCount, replies: [{ id, from, subject, snippet, receivedAt (ISO) }] }.

List raw uploaded assets from a client's Sanity media library (images/files), newest first, with filename + asset ref. Use this to find uploaded photos to place via copy_asset or patch_card_image. Distinct from list_generated_assets (Creative Studio AI-generated assets only). Works for site-only clients.

List all pages in a client's SanityPress CMS with module metadata and counts. Read-only.

Every design-preview SET ever generated for a planner project (newest first) — nothing is deleted when you regenerate, this is how you find the older ones. Each set: token, previewUrl, status, label, createdAt, createdVia, costUsd, kept/canonical/latest flags, and per-slot { index, model, tastePackIdentifier, selectedPaletteName, selectedReferenceName, status, costUsd, htmlAssetUrl }. Optional pageKey filter. Read-only. not_enabled if the operator API is unset.

List Brevo email sequences (automations) for a client with step count and active contact count.

List this business's social posts (drafts, scheduled queue, published, failed) with full captions, times and postIds. Call this BEFORE writing new posts so you can see what was said recently and avoid repeating an angle, and to find postIds for schedule/reschedule/delete. Newest first.