@awesomate/hosting-mcp 0.68.0 → 0.70.0

package/dist/index.js

@@ -39861,6 +39861,7 @@ var TOOL_FEATURE = {
   awesomate_crm_queries: "contacts",
   awesomate_crm_recipes: "contacts",
   awesomate_crm_email: "email",
+  awesomate_bookings: "bookings",
   awesomate_knowledge_status: "knowledge",
   awesomate_knowledge_provision: "knowledge",
   awesomate_knowledge_sources: "knowledge",
@@ -40320,7 +40321,7 @@ async function filesAction(config3, args) {
       const out = await hubPost(config3, "/api/files/move", { from, to: swapTopFolder(from, "private") });
       return {
         ...out,
-        note: `Moved from ${from}. Its public address no longer serves it, but Cloudflare can keep showing the last copy for up to 4 hours, and a copy someone already downloaded is not recalled. Any workflow, page or app that used it needs changing.`
+        note: `Moved from ${from}. Its public address stops serving it within seconds; a browser that already opened it may show its own copy for a while, and a copy someone downloaded is not recalled. Any workflow, page or app that used it needs changing.`
       };
     }
     case "delete": {
@@ -41578,6 +41579,7 @@ var TITLES = {
   awesomate_crm_assistant: "Set up the AI in your app's conversations",
   awesomate_crm_notifications: "Email people when someone replies in your app",
   awesomate_crm_hooks: "Send record changes to your n8n",
+  awesomate_bookings: "Your booking diary and booking box",
   awesomate_crm_email: "Draft an email to a contact list"
 };
 function annotate(name, kind) {
@@ -42988,7 +42990,7 @@ server.registerTool(
   "awesomate_files",
   {
     annotations: annotate("awesomate_files", DESTRUCTIVE),
-    description: `The account's Files: the folders on their automation account (n8n) that workflows read and write, and that the hub shows at Knowledge, Files. Three top folders: public/ (every file has a public_url anyone can open with no login: images for a site or email, downloads, media a workflow made), private/ (only the account, its workflows and the hub) and temp/ (scratch space). Support Plus, Pro and Embedded; the owner must also have switched on "Open your automation account's file folders" in Settings, Privacy. Paths are relative to the files folder and start with the top folder, e.g. public/images/logo.png. action 'status': whether Files is on, why not, and storage used against the plan's limit: call this first. 'list' {path?}: one folder (no path = the top folders); files in public/ carry public_url. 'search' {q?, top?, exts?}: find files by name across the folders (first 200 matches; truncated:true means narrow it). 'download' {path, to?, overwrite?}: save a file to THIS computer (to = a local file or folder, default the working directory); never overwrites without overwrite:true. 'upload' {localPath, path, overwrite?}: send a file from this computer (max 50 MB each); path is the target file, or a folder ending in / to keep the name. Upload into public/ only when the user wants it publicly reachable. 'mkdir' {path}. 'move' {path, to}: rename or move; moving into public/ needs confirm:true. 'make_public' {path, confirm:true}: moves private/ or temp/ to the same place under public/ and returns its public_url: ASK the user first, anyone with the address can read it. 'make_private' {path}: moves it out of public/, so its public address stops serving it; Cloudflare can keep showing the last copy for up to 4 hours (also after a delete or a replace of a public file), so never promise it is gone at once. 'delete' {path, confirm:true}: moves to the trash (not erased); ask first. Moving or renaming changes the path, so tell the user any workflow, page or app using the old path or address needs the new one. Contents stream between this computer and the hub: never paste a file's contents into the conversation to move it. A 507 files_storage_full means the plan's Files allowance is used: say how much, offer to find large or old files to remove, and leave any plan change to the user.`,
+    description: `The account's Files: the folders on their automation account (n8n) that workflows read and write, and that the hub shows at Knowledge, Files. Three top folders: public/ (every file has a public_url anyone can open with no login: images for a site or email, downloads, media a workflow made), private/ (only the account, its workflows and the hub) and temp/ (scratch space). Support Plus, Pro and Embedded; the owner must also have switched on "Open your automation account's file folders" in Settings, Privacy. Paths are relative to the files folder and start with the top folder, e.g. public/images/logo.png. action 'status': whether Files is on, why not, and storage used against the plan's limit: call this first. 'list' {path?}: one folder (no path = the top folders); files in public/ carry public_url. 'search' {q?, top?, exts?}: find files by name across the folders (first 200 matches; truncated:true means narrow it). 'download' {path, to?, overwrite?}: save a file to THIS computer (to = a local file or folder, default the working directory); never overwrites without overwrite:true. 'upload' {localPath, path, overwrite?}: send a file from this computer (max 50 MB each); path is the target file, or a folder ending in / to keep the name. Upload into public/ only when the user wants it publicly reachable. 'mkdir' {path}. 'move' {path, to}: rename or move; moving into public/ needs confirm:true. 'make_public' {path, confirm:true}: moves private/ or temp/ to the same place under public/ and returns its public_url: ASK the user first, anyone with the address can read it. 'make_private' {path}: moves it out of public/; its public address stops serving it within seconds (the hub clears Cloudflare's copy, and does the same after a delete or a replace), though a browser that already opened it may show its own copy until it expires, and a downloaded copy is not recalled. 'delete' {path, confirm:true}: moves to the trash (not erased); ask first. Moving or renaming changes the path, so tell the user any workflow, page or app using the old path or address needs the new one. Contents stream between this computer and the hub: never paste a file's contents into the conversation to move it. A 507 files_storage_full means the plan's Files allowance is used: say how much, offer to find large or old files to remove, and leave any plan change to the user.`,
     inputSchema: {
       action: external_exports.enum(FILES_ACTIONS),
       path: external_exports.string().max(1024).optional().describe("A path in Files, starting public/, private/ or temp/. For upload, the target (a folder ending in / keeps the local name)."),
@@ -43436,6 +43438,109 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_bookings",
+  {
+    annotations: annotate("awesomate_bookings", MUTATING),
+    description: `The business's own booking diary: customers book appointments or classes on the business's website, get an email with an invite and a link to change or cancel, and each booking lands in Contacts linked to the person. Read the awesomate-bookings skill first. Reading is every plan; every action that changes something needs Support Plus or above (on Essentials the hub answers upgrade_required: tell the owner they can do it in the hub under Contacts, Bookings, and do not retry). action 'setup': calendars, services, and this month's website bookings against the plan's limit. 'save_calendar' {key, name, timezone, hours, min_notice_minutes?, buffer_minutes?, max_per_day?, notify_email?, active?}: a person, room or resource with weekly hours ({"mon": [["09:00","17:00"]]}, 24-hour, in its own zone); a change names only what moves. 'save_service' {key, name, minutes, calendars, capacity?, price_text?, location?, cancel_cutoff_hours?, intake?, description?, active?}: capacity above 1 is a class several people join at one start; price is shown, never charged. 'open_times' {service, from?, to?, calendar?}. 'list' {from?, to?, status?}: bookings with each customer and their answers. 'book' {service, calendar, starts_at (from open_times), email, first_name?, last_name?, phone?, answers?, notify?, outside_hours?}. 'move' {booking_id, starts_at, notify?, outside_hours?}. 'cancel' {booking_id, reason?, notify?}. notify: false skips the customer's email; the calendar's notice email always hears. 'keys': the booking keys for the account's websites, each with the snippet to paste. 'create_key' {website}: the booking box for one site (https), returns the snippet. 'update_key' {key_id, active?, website?}. Nobody can double-book a time: the hub re-checks under a lock and answers 409 with why (not_open, slot_taken, session_full, day_full).`,
+    inputSchema: {
+      action: external_exports.enum(["setup", "save_calendar", "save_service", "open_times", "list", "book", "move", "cancel", "keys", "create_key", "update_key"]),
+      key: external_exports.string().max(41).optional().describe("save_calendar, save_service: lower case, digits and underscores"),
+      name: external_exports.string().max(80).optional(),
+      timezone: external_exports.string().max(60).optional().describe("IANA zone, like Australia/Sydney"),
+      hours: external_exports.record(external_exports.string(), external_exports.array(external_exports.tuple([external_exports.string(), external_exports.string()]))).optional().describe('save_calendar: {"mon": [["09:00","17:00"]], ...}'),
+      min_notice_minutes: external_exports.number().int().min(0).optional(),
+      buffer_minutes: external_exports.number().int().min(0).optional(),
+      max_per_day: external_exports.number().int().min(1).nullable().optional(),
+      notify_email: external_exports.string().max(254).nullable().optional(),
+      active: external_exports.boolean().optional(),
+      minutes: external_exports.number().int().optional().describe("save_service: length in minutes"),
+      capacity: external_exports.number().int().min(1).optional(),
+      price_text: external_exports.string().max(80).optional(),
+      location: external_exports.string().max(500).optional(),
+      description: external_exports.string().max(2e3).optional(),
+      cancel_cutoff_hours: external_exports.number().int().min(0).optional(),
+      intake: external_exports.array(external_exports.object({
+        key: external_exports.string().max(41),
+        label: external_exports.string().max(200),
+        type: external_exports.enum(["text", "textarea", "select", "multiselect", "url"]),
+        required: external_exports.boolean().optional(),
+        options: external_exports.array(external_exports.string().max(100)).max(50).optional()
+      })).max(20).optional().describe("save_service: the questions asked when booking"),
+      calendars: external_exports.array(external_exports.string().max(41)).max(50).optional().describe("save_service: calendar keys that offer it"),
+      service: external_exports.string().max(41).optional(),
+      calendar: external_exports.string().max(41).optional(),
+      from: external_exports.string().max(40).optional(),
+      to: external_exports.string().max(40).optional(),
+      status: external_exports.enum(["confirmed", "cancelled", "completed", "no_show"]).optional(),
+      starts_at: external_exports.string().max(40).optional().describe("an ISO time from open_times"),
+      email: external_exports.string().max(254).optional(),
+      first_name: external_exports.string().max(80).optional(),
+      last_name: external_exports.string().max(80).optional(),
+      phone: external_exports.string().max(40).optional(),
+      answers: external_exports.record(external_exports.string(), external_exports.union([external_exports.string(), external_exports.array(external_exports.string())])).optional(),
+      notify: external_exports.boolean().optional(),
+      outside_hours: external_exports.boolean().optional(),
+      booking_id: external_exports.string().max(40).optional(),
+      reason: external_exports.string().max(500).optional(),
+      website: external_exports.string().max(300).optional().describe("create_key, update_key: the site address, like https://example.com.au"),
+      key_id: external_exports.number().int().optional().describe("update_key: from keys")
+    }
+  },
+  async (a) => {
+    try {
+      const cfg = requireConfig();
+      const base = "/api/my-crm/v1/bookings";
+      const pick2 = (...ks) => Object.fromEntries(ks.map((k) => [k, a[k]]).filter(([, v]) => v !== void 0));
+      const qs = (o) => Object.entries(o).filter(([, v]) => v !== void 0).map(([k, v]) => `${k}=${encodeURIComponent(String(v))}`).join("&");
+      const origin = (w) => new URL(w).origin;
+      switch (a.action) {
+        case "setup":
+          return textResult(await hubGet(cfg, `${base}/setup`));
+        case "save_calendar":
+          if (!a.key) return errorResult(new Error("save_calendar needs key."));
+          return textResult(await hubPut(
+            cfg,
+            `${base}/calendars/${encodeURIComponent(a.key)}`,
+            pick2("name", "timezone", "hours", "min_notice_minutes", "buffer_minutes", "max_per_day", "notify_email", "active")
+          ));
+        case "save_service":
+          if (!a.key) return errorResult(new Error("save_service needs key."));
+          return textResult(await hubPut(
+            cfg,
+            `${base}/services/${encodeURIComponent(a.key)}`,
+            pick2("name", "minutes", "capacity", "price_text", "location", "description", "cancel_cutoff_hours", "intake", "calendars", "active")
+          ));
+        case "open_times":
+          if (!a.service) return errorResult(new Error("open_times needs service."));
+          return textResult(await hubGet(cfg, `${base}/open-times?${qs({ service: a.service, from: a.from, to: a.to, calendar: a.calendar })}`));
+        case "list":
+          return textResult(await hubGet(cfg, `${base}/?${qs({ from: a.from, to: a.to, status: a.status })}`));
+        case "book":
+          return textResult(await hubPost(cfg, base, pick2("service", "calendar", "starts_at", "email", "first_name", "last_name", "phone", "answers", "notify", "outside_hours")));
+        case "move":
+          if (!a.booking_id) return errorResult(new Error("move needs booking_id, from list."));
+          return textResult(await hubPost(cfg, `${base}/${encodeURIComponent(a.booking_id)}/move`, pick2("starts_at", "notify", "outside_hours")));
+        case "cancel":
+          if (!a.booking_id) return errorResult(new Error("cancel needs booking_id, from list."));
+          return textResult(await hubPost(cfg, `${base}/${encodeURIComponent(a.booking_id)}/cancel`, pick2("reason", "notify")));
+        case "keys":
+          return textResult(await hubGet(cfg, `${base}/keys`));
+        case "create_key":
+          if (!a.website) return errorResult(new Error("create_key needs website: the site's address, like https://example.com.au."));
+          return textResult(await hubPost(cfg, `${base}/keys`, { name: new URL(a.website).hostname, allowed_origins: [origin(a.website)] }));
+        case "update_key":
+          if (a.key_id === void 0) return errorResult(new Error("update_key needs key_id, from keys."));
+          return textResult(await hubPatch(cfg, `${base}/keys/${a.key_id}`, {
+            ...a.active === void 0 ? {} : { active: a.active },
+            ...a.website ? { allowed_origins: [origin(a.website)] } : {}
+          }));
+      }
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
 server.registerTool(
   "awesomate_crm_notifications",
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.68.0",
+  "version": "0.70.0",
   "description": "Awesomate MCP server — lets Claude manage your Awesomate WordPress hosting, plan, limits, n8n automations, and build Node/static apps + databases",
   "license": "UNLICENSED",
   "type": "module",

package/skill/CHANGELOG.json

@@ -1,5 +1,17 @@
 {
   "versions": [
+    {
+      "version": "0.70.0",
+      "highlights": [
+        "A file you make private, delete or replace in your Files now stops showing at its public address within seconds, instead of up to 4 hours"
+      ]
+    },
+    {
+      "version": "0.69.0",
+      "highlights": [
+        "Bookings: your customers book appointments or classes on your own website, get an email with an invite and a link to change or cancel, and each booking lands in Contacts. Claude sets up your calendars, services and the booking box (awesomate_bookings), and can book, move and cancel for you"
+      ]
+    },
     {
       "version": "0.68.0",
       "highlights": [

package/skill/awesomate-bookings/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: awesomate-bookings
+description: Let the business's own customers book appointments or classes online, and manage those bookings. Sets up calendars (a person, room or resource with weekly hours), services (what is booked, how long, how many places, the questions asked), and the booking box for their website, then books, moves and cancels for them. Use when the user says "booking", "bookings", "appointments", "book online", "booking calendar", "scheduling", "let customers book", "Calendly", "class bookings", "who's booked tomorrow", or wants a booking page on their site. Companion to awesomate-app-builder and awesomate-hosting (the page it goes on) and awesomate-n8n (follow-ups): same connection, same token.
+---
+
+# Awesomate Bookings: customers book themselves, bookings land in Contacts
+
+A business's customers pick a time on the business's own website, get an email with a calendar
+invite and a link to change or cancel, and the business gets a notice for each booking. Every
+booking is a record in the business's own Contacts, linked to the person who made it.
+
+Everything goes through one tool, `awesomate_bookings`. Work in plain words with the owner: ask
+what people book, who with, and when they are open, then set it up and show them the result in a
+sentence or two.
+
+## What it is made of
+
+- **Calendars**: a person, room or resource people book. Each has weekly hours in its own time
+  zone, how much notice it needs, a gap between bookings, an optional daily limit, and the email
+  that hears about every booking (with an invite for their own calendar). Set the notice email:
+  without one, customers' replies to booking emails reach nobody.
+- **Services**: what is booked. A length in minutes, places (1 for one person at a time, more for
+  a class several people join), a price shown as text (nothing is charged), where it happens,
+  questions to ask when booking, how many hours before the start changes close online, and which
+  calendars offer it.
+- **The booking box**: one key per website, locked to that site's address. `create_key` returns the
+  snippet to paste.
+
+## Setting up (in this order)
+
+1. `awesomate_bookings` action `save_calendar` with `key` (lower case, like `nicole`), `name`,
+   `timezone` (like `Australia/Sydney`), `hours` (`{"mon": [["09:00","17:00"]], ...}`, 24-hour, no
+   overlaps), and `notify_email`.
+2. `save_service` with `key`, `name`, `minutes`, `calendars` (keys), and optionally `capacity`,
+   `price_text`, `location`, `cancel_cutoff_hours`, `intake` (questions:
+   `[{"key":"reason","label":"What brings you in?","type":"textarea","required":true}]`; types are
+   text, textarea, select, multiselect, url; select and multiselect take `options`).
+3. `open_times` with `service` to check the times look right before telling the owner it is ready.
+4. `create_key` with `website` (the site's address, https). Put the returned `snippet` on the page
+   the owner wants, or give it to them to paste:
+
+```html
+<div data-awesomate-bookings></div>
+<script src="https://hub.awesomate.ai/widget/v1/bookings.js" data-key="bk_..." async></script>
+```
+
+On the div, `data-service="<key>"` offers one service only, and `data-accent="#0f766e"` colours the
+buttons to match the site. On a WordPress site, a Custom HTML block holds both lines. On a site you
+build with awesomate-app-builder, put them in the page where booking belongs (a "Book now" section,
+or a /book page) and deploy as usual. The box only works on the website named on its key: to use it
+on another domain, `update_key` with `allowed_origins`.
+
+Changing a calendar or service later: call the same `save_` action with only what changes.
+
+## Running the diary
+
+- `list` (optionally `from`, `to`, `status`): upcoming bookings with each customer's name, email,
+  phone and answers. Use it for "who's booked tomorrow".
+- `book`: book someone in (`service`, `calendar`, `starts_at` from `open_times`, the customer's
+  `email`, `first_name`, `last_name`, `phone`, `answers`). `notify: false` when the customer should
+  not get an email (a booking taken by phone that they already know about). Staff may book outside
+  the hours with `outside_hours: true`; nobody can double-book a time.
+- `move` (`booking_id`, `starts_at`) and `cancel` (`booking_id`, `reason`): the customer is emailed
+  unless `notify: false`, and the calendar's notice email always is.
+
+## Follow-ups through n8n (Pro)
+
+Each booking is a record of the `booking` kind in Contacts. On Pro, an account with one of its own
+apps (`awesomate_crm_apps`) can add a hook with `awesomate_crm_hooks` and `kinds: ["booking"]` to
+send each booking's created, updated and archived events to its own n8n: an SMS reminder, copying it
+into Google Calendar with the owner's own n8n credential, a thank-you after the visit. Bookings
+themselves cannot be written through `awesomate_crm_write`; only these actions change them.
+
+## Plans and limits
+
+- Every plan can set up bookings and take them on its website. Essentials takes up to 50 website
+  bookings a month; bookings the business makes itself never count.
+- Changing bookings from Claude Code (the write actions here) needs Support Plus or above. On
+  Essentials, the tool answers `upgrade_required`: say the owner can do the same in the hub under
+  Contacts, Bookings, and do not retry.
+- Payments and deposits are not part of bookings yet. Do not promise them; the price is shown only.
+- Two-way sync with the owner's own Google or Outlook calendar is not available yet: the notice
+  email's invite is how a booking reaches their calendar. Do not promise automatic sync.