@awesomate/hosting-mcp 0.31.0 → 0.33.0

package/dist/index.js

@@ -40993,6 +40993,7 @@ var TITLES = {
   awesomate_n8n_node_docs: "Get n8n node docs",
   awesomate_n8n_deploy: "Deploy n8n workflow",
   awesomate_n8n_library: "Install Awesomate templates",
+  awesomate_book_session: "Book a session with Awesomate",
   awesomate_n8n_test: "Test-fire n8n workflow",
   awesomate_n8n_datatable_write: "Write to n8n data table",
   awesomate_n8n_attach_to_app: "Attach n8n to app",
@@ -41129,19 +41130,21 @@ server.registerTool(
   "awesomate_n8n_library",
   {
     annotations: annotate("awesomate_n8n_library", MUTATING),
-    description: "The Awesomate template library for THIS account: ready-made n8n automations and AI agents that Awesomate curates, including bundles linked to the account's referrer (e.g. Business Blueprint members see Dale Beaumont's bundles). Actions: 'list' (every bundle the account may see, each with installed, plan_ok and credentials_missing; every plan), 'detail' (slug: the templates in the bundle, what each does, the credential types it needs and whether the account already has each; every plan), 'install_plan' (slug: runs the pre-install checks WITHOUT writing and returns ready | paused | blocked; paused carries a help card per missing credential with where to get it, the exact page on their n8n to create it and our help article; Support Plus+), 'install' (slug: installs; refused unless the plan is ready, or every missing OPTIONAL credential is named in proceed_without and every ambiguous one has a choice in credential_choices; Support Plus+), 'redeem' (token: installs what a redeem token unlocks; Support Plus+). Workflows land INACTIVE; activation, testing and rollback of installed bundles arrive in the next release. A 403 whose missingScopes contains n8n:deploy means the plan is Essentials: show the catalog, say installing needs Support Plus, and stop. Never create a credential for the client; send them to create_url and re-run install_plan afterwards.",
+    description: "The Awesomate template library for THIS account: ready-made n8n automations and AI agents that Awesomate curates, including bundles linked to the account's referrer (e.g. Business Blueprint members see Dale Beaumont's bundles). Actions: 'list' (every bundle the account may see, each with installed, plan_ok and credentials_missing; every plan), 'detail' (slug: the templates in the bundle, what each does, the credential types it needs and whether the account already has each; every plan), 'install_plan' (slug: runs the pre-install checks WITHOUT writing and returns ready | paused | blocked; paused carries a help card per missing credential with where to get it, the exact page on their n8n to create it and our help article; Support Plus+), 'install' (slug: installs; refused unless the plan is ready, or every missing OPTIONAL credential is named in proceed_without and every ambiguous one has a choice in credential_choices; Support Plus+), 'redeem' (token: installs what a redeem token unlocks; Support Plus+). Then: 'installs' (what is on the instance, grouped by bundle), 'activate' (slug; switches the bundle's workflows on behind the same credential gate the hub uses: a workflow with an empty or missing credential answers setup_incomplete with the exact list; pass active:false to switch off), 'test' (slug; runs each template's test recipe and returns passed | failed | untested with the execution id; real side effects DO run, warn the client), 'rollback' (slug; removes what YOUR most recent install of this bundle created, never anything reused). Workflows land INACTIVE on install; activate is a separate, confirmed step. A 403 whose missingScopes contains n8n:deploy means the plan is Essentials: show the catalog, say installing needs Support Plus, and stop. Never create a credential for the client; send them to create_url and re-run install_plan afterwards.",
     inputSchema: {
-      action: external_exports.enum(["list", "detail", "install_plan", "install", "redeem"]),
+      action: external_exports.enum(["list", "detail", "install_plan", "install", "redeem", "installs", "activate", "test", "rollback"]),
       slug: external_exports.string().optional().describe("Bundle slug from list (detail, install_plan, install)"),
       token: external_exports.string().optional().describe("redeem only: the redeem token Awesomate handed over"),
       proceed_without: external_exports.array(external_exports.string()).optional().describe("install only: OPTIONAL credential types the client agreed to skip (from install_plan.optional_missing)"),
-      credential_choices: external_exports.record(external_exports.string()).optional().describe("install only: credential type -> credential id the client chose for ambiguous types (from install_plan.ambiguous)")
+      credential_choices: external_exports.record(external_exports.string()).optional().describe("install only: credential type -> credential id the client chose for ambiguous types (from install_plan.ambiguous)"),
+      active: external_exports.boolean().optional().describe("activate only: false switches the bundle off (default true)")
     }
   },
-  async ({ action, slug, token, proceed_without, credential_choices }) => {
+  async ({ action, slug, token, proceed_without, credential_choices, active }) => {
     try {
       const cfg = requireConfig();
       if (action === "list") return textResult(await hubGet(cfg, "/api/my-n8n/library"));
+      if (action === "installs") return textResult(await hubGet(cfg, "/api/my-n8n/library/installs"));
       if (action === "redeem") {
         if (!token) return errorResult(new Error("token is required for redeem"));
         return textResult(await hubPost(cfg, "/api/my-n8n/library/redeem", { token }));
@@ -41150,6 +41153,9 @@ server.registerTool(
       const base = `/api/my-n8n/library/bundles/${encodeURIComponent(slug)}`;
       if (action === "detail") return textResult(await hubGet(cfg, base));
       if (action === "install_plan") return textResult(await hubPost(cfg, `${base}/install-plan`, {}));
+      if (action === "activate") return textResult(await hubPost(cfg, `${base}/activate`, { active: active !== false }));
+      if (action === "test") return textResult(await hubPost(cfg, `${base}/test`, {}));
+      if (action === "rollback") return textResult(await hubPost(cfg, `${base}/rollback`, {}));
       return textResult(
         await hubPost(cfg, `${base}/install`, { proceed_without: proceed_without ?? [], credential_choices: credential_choices ?? {} })
       );
@@ -41158,6 +41164,44 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_book_session",
+  {
+    annotations: annotate("awesomate_book_session", MUTATING),
+    description: "Book a session with the Awesomate team on the client's behalf, from their credits. Use it when a template needs a credential or setup the client would rather not do alone (the install_plan help card names it), or when three test-and-fix rounds have failed. Actions: 'session_types' (what can be booked, credit cost, whether bookable on their plan, and the intake questions each asks; call FIRST), 'slots' (session_type, optional from/to ISO dates: open times with host_team_member_id), 'book' (session_type, starts_at ISO, host_team_member_id, client_name, optional timezone and intake answers; spends the credits shown; get an explicit yes first and tell them the time in THEIR timezone), 'mine' (their upcoming and past sessions). 404 not_live means bookings are not switched on for clients yet: say so and offer a support ticket instead. 402 insufficient_credits: relay it honestly and link https://hub.awesomate.ai/billing.",
+    inputSchema: {
+      action: external_exports.enum(["session_types", "slots", "book", "mine"]),
+      session_type: external_exports.string().optional().describe("slots and book: the session type key from session_types"),
+      from: external_exports.string().optional().describe("slots: ISO date to search from (default now)"),
+      to: external_exports.string().optional().describe("slots: ISO date to search to (default from + 14 days)"),
+      starts_at: external_exports.string().optional().describe("book: the slot start, ISO timestamp exactly as returned by slots"),
+      host_team_member_id: external_exports.number().optional().describe("book: the host id from the chosen slot"),
+      client_name: external_exports.string().optional().describe("book: the name the host will greet"),
+      timezone: external_exports.string().optional().describe("book: IANA timezone, e.g. Australia/Brisbane"),
+      intake: external_exports.record(external_exports.unknown()).optional().describe("book: answers to the session type's intake questions")
+    }
+  },
+  async ({ action, session_type, from, to, starts_at, host_team_member_id, client_name, timezone, intake }) => {
+    try {
+      const cfg = requireConfig();
+      if (action === "session_types") return textResult(await hubGet(cfg, "/api/bookings/session-types"));
+      if (action === "mine") return textResult(await hubGet(cfg, "/api/bookings"));
+      if (!session_type) return errorResult(new Error(`session_type is required for ${action}`));
+      if (action === "slots") {
+        const q = new URLSearchParams({ session_type });
+        if (from) q.set("from", String(Date.parse(from)));
+        if (to) q.set("to", String(Date.parse(to)));
+        return textResult(await hubGet(cfg, `/api/bookings/slots?${q.toString()}`));
+      }
+      if (!starts_at || !host_team_member_id) return errorResult(new Error("starts_at and host_team_member_id are required for book"));
+      return textResult(
+        await hubPost(cfg, "/api/bookings", { session_type, starts_at, host_team_member_id, client_name: client_name ?? "", timezone, intake: intake ?? {} })
+      );
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
 server.registerTool(
   "awesomate_n8n_test",
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.31.0",
+  "version": "0.33.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,21 @@
 {
   "versions": [
+    {
+      "version": "0.33.0",
+      "highlights": [
+        "When a template needs a credential you would rather not set up alone, Claude can book a session with the Awesomate team for you: awesomate_book_session shows what can be booked, the open times and the credit cost, and books with your yes",
+        "Stuck after three test-and-fix rounds on one template? Claude now suggests a support ticket, and if you say yes it sends one carrying the template, the failing execution and your own note",
+        "A missing credential's help card names what the template expects (Kie, not HTTP Bearer Auth), taken from the template's own markers"
+      ]
+    },
+    {
+      "version": "0.32.0",
+      "highlights": [
+        "What you installed, you can run: awesomate_n8n_library now switches a bundle on (behind the same credential check the hub uses, so an empty credential names itself instead of failing silently), runs each template's test recipe, and rolls your install back",
+        "The catalog now reads a bundle as installed when its templates are on your n8n, however they got there; a bundle that was already present reports already_present instead of pretending to install",
+        "A missing credential's help card now carries the name the template expects, so a Kie key on a generic bearer type is called Kie, not HTTP Bearer Auth"
+      ]
+    },
     {
       "version": "0.31.0",
       "highlights": [

package/skill/awesomate-n8n/SKILL.md

@@ -93,7 +93,8 @@ the named node actually exists in the workflow before editing anything.
 | Node schemas, node search, community templates, node-level validation | `awesomate_n8n_node_docs` |
 | Validate / create draft / update draft / activate / promote / rollback / delete draft | `awesomate_n8n_deploy` |
 | Fire a test payload at an active workflow | `awesomate_n8n_test` |
-| Awesomate's template library: list, detail, install_plan (pauses on a missing credential), install, redeem | `awesomate_n8n_library` |
+| Awesomate's template library: list, detail, install_plan (pauses on a missing credential), install, redeem, installs, activate, test, rollback | `awesomate_n8n_library` |
+| Book a session with the Awesomate team from their credits (session_types, slots, book, mine) | `awesomate_book_session` |
 | Create/alter data tables, write rows | `awesomate_n8n_datatable_write` |
 | Provision a Postgres DB + n8n credential | `awesomate_n8n_provision_pg` |
 | Wire a tested webhook workflow into one of their hosted apps (stores URL + secret on the app; returns the secret ONCE for the workflow's header check) | `awesomate_n8n_attach_to_app` |
@@ -202,13 +203,31 @@ loop: nothing is designed, the bundle is installed as curated.
      `ambiguous` needs their pick (`credential_choices`, type to credential id).
    - `blocked`: read `blockers` verbatim. A plan or consent block has a settings link; a
      connection block means their n8n key needs updating (see 0. First run).
-4. `install`. Workflows land INACTIVE. Say so, and say that switching on, testing and
-   rolling back from here arrive in the next release; until then the hub's Library page
-   (`/templates`) does it. Do not try `awesomate_n8n_deploy activate` on them: installed
-   templates are refused there as agency-managed.
-5. A 403 whose `missingScopes` contains `n8n:deploy` means Essentials. Show the catalog,
+4. `install`. Read `outcome`: `installed`, `already_present` (nothing changed; say so),
+   `failed` (read results[].error). Workflows land INACTIVE.
+5. `activate` (with their OK). A workflow answering `setup_incomplete` has an empty or
+   missing credential named in `unresolved`; send them to fill it on their n8n
+   (`/home/credentials`), then activate again. Agents are live on install.
+6. `test`. Each template reports `passed`, `failed` (read the execution with
+   `awesomate_n8n_executions` debug, fix configuration, re-run) or `untested` (no recipe:
+   ask them to try it once). Real side effects run; say so before testing.
+
+**The stuck ladder** (a credential they cannot set up, or three failed test-and-fix rounds
+on ONE template): (1) `awesomate_support ask` and the help card's articles; (2) offer a
+session with the Awesomate team through `awesomate_book_session` (session_types first; it
+costs the credits shown; book only on their yes; 404 not_live means bookings are not open
+yet, go to 3); (3) SUGGEST a support ticket. Never send one unasked. If they say yes, ask
+for a sentence in their own words, then `awesomate_support create_ticket` with category
+'Workflow error', subject `<bundle>: <template> fails after install`, and a message that
+carries the bundle and template slugs, the execution id and failing node from the last
+test, what you tried, and their sentence verbatim. Never paste workflow JSON into a ticket.
+7. `rollback` removes what their install created (never a reused workflow), with their OK.
+8. A 403 whose `missingScopes` contains `n8n:deploy` means Essentials. Show the catalog,
    say installing needs Support Plus, link `https://hub.awesomate.ai/billing`, and stop.
 
+`installs` lists what is on the instance grouped by bundle; rows marked `installed_by:
+agency` were pushed by Awesomate and are read-only here.
+
 `redeem` takes a token Awesomate handed over and installs what it unlocks, no visibility
 check; use it when the member has a token, otherwise use the catalog.