@awesomate/hosting-mcp 0.31.0 → 0.32.0

package/dist/index.js

@@ -41129,19 +41129,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 +41152,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 ?? {} })
       );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.31.0",
+  "version": "0.32.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,13 @@
 {
   "versions": [
+    {
+      "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,7 @@ 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` |
 | 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 +202,22 @@ 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. After THREE
+   failed rounds on one template, stop and SUGGEST a support ticket; never send one unasked.
+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.