@awesomate/hosting-mcp 0.24.0 → 0.26.0

package/dist/index.js

@@ -40083,7 +40083,22 @@ var KNOWLEDGE_GATE_COPY = {
     "Hosted in Sydney, isolated to your account, and gone the moment you delete it"
   ]
 };
-function upsellPayload(apiBase, plan) {
+function upsellPayload(apiBase, plan, body) {
+  const capability = typeof body?.capability === "string" ? body.capability : null;
+  const requiredPlan = typeof body?.requiredPlan === "string" ? body.requiredPlan : KNOWLEDGE_GATE_COPY.requiredPlan;
+  const message = typeof body?.message === "string" ? body.message : null;
+  if (capability && message) {
+    return {
+      upgrade_required: true,
+      capability,
+      requiredPlan,
+      ...typeof plan === "string" ? { plan } : {},
+      ...typeof body?.dimension === "string" ? { dimension: body.dimension } : {},
+      message,
+      billingUrl: `${apiBase}/billing?upgrade=${encodeURIComponent(requiredPlan)}`,
+      note: capability === "knowledge_packs" ? `The included allowance is used up and this plan cannot buy Ingestion Packs (they start at ${requiredPlan}). NOTHING was added or purchased. Say so plainly, share the billing link, and let the user decide; never retry.` : `This kind of content needs ${requiredPlan} or above. NOTHING was added. Relay the message honestly, share the billing link, and let the user decide; never retry.`
+    };
+  }
   return {
     upgrade_required: true,
     ...typeof plan === "string" ? { plan } : {},
@@ -40124,7 +40139,7 @@ function mapKnowledgeError(err, apiBase) {
   if (!(err instanceof HubApiError)) throw err;
   const body = bodyOf(err);
   if (err.status === 404) return notAvailablePayload(apiBase);
-  if (err.status === 403 && body?.upgrade_required) return upsellPayload(apiBase, body.plan);
+  if ((err.status === 403 || err.status === 402) && body?.upgrade_required) return upsellPayload(apiBase, body.plan, body);
   if (err.status === 403 && body?.consent_required) {
     return consentPayload(typeof body.error === "string" ? body.error : "Knowledge Platform consent is off");
   }
@@ -40633,6 +40648,40 @@ async function knowledgeSearch(config3, args) {
     return mapKnowledgeError(err, config3.apiBase);
   }
 }
+function touchesScope(args) {
+  return Boolean(args.collectionIds || args.kinds || args.sourceIds);
+}
+var SCOPE_KEYS = ["source_ids", "tags", "datasets", "kinds", "data_sets", "allow_media", "allow_data"];
+function agentPatchBody(args, currentScope = {}) {
+  let scope;
+  if (touchesScope(args)) {
+    const kept = {};
+    for (const k of SCOPE_KEYS) if (currentScope[k] !== void 0) kept[k] = currentScope[k];
+    const currentTags = Array.isArray(kept.tags) ? kept.tags.filter((t) => typeof t === "string") : [];
+    scope = {
+      ...kept,
+      ...args.collectionIds ? { tags: [...currentTags.filter((t) => !t.startsWith("collection:")), ...args.collectionIds.map((id) => `collection:${id}`)] } : {},
+      ...args.kinds ? { kinds: args.kinds } : {},
+      ...args.sourceIds ? { source_ids: args.sourceIds } : {}
+    };
+  }
+  return {
+    ...args.name ? { name: args.name } : {},
+    ...args.description !== void 0 ? { description: args.description } : {},
+    ...args.systemMessage !== void 0 ? { system_message: args.systemMessage } : {},
+    ...args.noAnswerMessage !== void 0 ? { no_answer_message: args.noAnswerMessage } : {},
+    ...args.grounding ? { grounding: args.grounding } : {},
+    ...args.audience ? { audience: args.audience } : {},
+    ...args.maxSources !== void 0 ? { max_sources: args.maxSources } : {},
+    ...args.temperature !== void 0 ? { temperature: args.temperature } : {},
+    ...scope ? { scope } : {}
+  };
+}
+async function currentAgentScope(config3, agentId) {
+  const got = await hubGet(config3, `/api/knowledge/agents/${encodeURIComponent(agentId)}`);
+  const scope = got.agent?.scope ?? got.scope;
+  return scope && typeof scope === "object" && !Array.isArray(scope) ? scope : {};
+}
 function mapAgentsError(err, apiBase) {
   if (err instanceof HubApiError && err.status === 404) {
     const body = bodyOf(err);
@@ -40662,6 +40711,23 @@ async function knowledgeAgents(config3, args) {
       if (!args.name) return { error: "name (or goal) is required for create" };
       return await hubPost(config3, "/api/knowledge/agents", { name: args.name, ...args.audience ? { audience: args.audience } : {} });
     }
+    if (args.action === "update") {
+      if (!args.agentId) return { error: "agentId is required for update" };
+      const currentScope = touchesScope(args) ? await currentAgentScope(config3, args.agentId) : {};
+      const body = agentPatchBody(args, currentScope);
+      if (!Object.keys(body).length) {
+        return {
+          error: "invalid_request",
+          note: "update needs at least one of name, description, systemMessage, noAnswerMessage, grounding, audience, collectionIds, kinds, sourceIds, maxSources, temperature"
+        };
+      }
+      const out = await hubPatch(config3, `/api/knowledge/agents/${encodeURIComponent(args.agentId)}`, body);
+      return {
+        ...out,
+        requested: body,
+        status_note: "Draft updated. A published agent keeps serving its last published version until you publish again: test the draft, then publish when the user approves."
+      };
+    }
     if (args.action === "publish") {
       if (!args.agentId) return { error: "agentId is required for publish" };
       const out = await hubPost(config3, `/api/knowledge/agents/${encodeURIComponent(args.agentId)}/publish`, {});
@@ -40885,6 +40951,7 @@ var TITLES = {
   awesomate_skill_update: "Update Awesomate skills",
   awesomate_site_create: "Create WordPress site",
   awesomate_site_audit: "Audit site for SEO and AEO",
+  awesomate_php_extensions: "Check or fix PHP extensions",
   awesomate_uninstall_site: "Delete WordPress site",
   awesomate_snapshot_site: "Snapshot site",
   awesomate_list_snapshots: "List site snapshots",
@@ -41416,6 +41483,26 @@ readTool(
   "cPanel account details: package, server, provisioned-at, masked username.",
   "/api/client-hosting/account"
 );
+server.registerTool(
+  "awesomate_php_extensions",
+  {
+    description: "Check (and optionally fix) the PHP extensions enabled for the hosting account's PHP runtime. Use this when WordPress fails on a SPECIFIC operation while the rest of the site works: `wp media import` or image uploads dying with \"critical error\" (missing dom), sudden white screens on text handling (missing mbstring), importers or sitemap generation failing (missing xmlreader/xmlwriter), or a plugin that installs fine but cannot connect (missing soap). The CloudLinux alt-php82 default set is much leaner than 7.4's, so accounts on PHP 8.2 often come up without these even though the modules are installed on the server. The account holder CANNOT fix this from a shell \u2014 CageFS blocks selectorctl for jailed accounts \u2014 so do it here rather than talking them through cPanel. Pass fix:true to enable the missing ones. Enabling is additive (nothing already on is removed), needs no PHP restart and causes no downtime.",
+    inputSchema: {
+      fix: external_exports.boolean().optional().describe("Enable the missing extensions. Omit or false to only report what is missing.")
+    },
+    annotations: annotate("awesomate_php_extensions", MUTATING)
+  },
+  async ({ fix }) => {
+    try {
+      const config3 = requireConfig();
+      return textResult(
+        fix ? await hubPost(config3, "/api/client-hosting/php-extensions", {}) : await hubGet(config3, "/api/client-hosting/php-extensions")
+      );
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
 readTool(
   "awesomate_list_sites",
   "All WordPress sites on the hosting account: canonical domain, URL, title, WP version, SSL state, install date.",
@@ -41906,13 +41993,22 @@ server.registerTool(
   "awesomate_knowledge_agents",
   {
     annotations: annotate("awesomate_knowledge_agents", MUTATING),
-    description: "The agent builder (multi-agent; the older awesomate_knowledge_agent tool is the single workspace default). action 'list' \u2014 every agent with status (draft/published vN/suspended). 'get' {agentId} \u2014 full config incl. system message and scope. 'create' {goal} \u2014 AI drafts the whole setup (instructions, scope, tone, test questions) from the account's own content and saves it as a PRIVATE DRAFT (never live, nothing lost); or {name} for a blank draft. 'test' {agentId, message, sessionId?} \u2014 chat with the DRAFT config: free, unmetered, the right way to check behaviour before going live. 'publish' {agentId} \u2014 makes the draft LIVE immediately for every key bound to the agent: get the user's explicit approval first, and read the version back. Editing fields, policies, API keys and the request log live in the hub UI (Knowledge \u2192 Agents); keys are shown once there and never pass through this tool.",
+    description: "The agent builder (multi-agent; the older awesomate_knowledge_agent tool is the single workspace default). action 'list': every agent with status (draft/published vN/suspended). 'get' {agentId}: full config incl. system message and scope. 'create' {goal}: AI drafts the whole setup (instructions, scope, tone, test questions) from the account's own content and saves it as a PRIVATE DRAFT (never live, nothing lost); or {name} for a blank draft. 'update' {agentId, ...fields}: edit the DRAFT config: name, description, systemMessage, noAnswerMessage, grounding, audience, collectionIds (scope to collections from awesomate_knowledge_collections), kinds, sourceIds, maxSources, temperature. Nothing changes for callers until 'publish'. 'test' {agentId, message, sessionId?}: chat with the DRAFT config: free, unmetered, the right way to check behaviour before going live. 'publish' {agentId}: makes the draft LIVE immediately for every key bound to the agent: get the user's explicit approval first, and read the version back. Policies, API keys and the request log live in the hub UI (Knowledge \u2192 Agents); keys are shown once there and never pass through this tool.",
     inputSchema: {
-      action: external_exports.enum(["list", "get", "create", "publish", "test"]),
-      agentId: external_exports.string().max(64).optional().describe("get/publish/test: agent_id from list"),
-      name: external_exports.string().max(80).optional().describe("create: blank draft with this name"),
+      action: external_exports.enum(["list", "get", "create", "update", "publish", "test"]),
+      agentId: external_exports.string().max(64).optional().describe("get/update/publish/test: agent_id from list"),
+      name: external_exports.string().max(80).optional().describe("create: blank draft with this name; update: rename"),
       goal: external_exports.string().max(2e3).optional().describe("create: describe the agent and AI drafts it from the account content"),
-      audience: external_exports.enum(["private", "internal", "public"]).optional().describe("create: who the agent serves \u2014 'public' for anything customers or a website will talk to (it then answers from sources marked public ONLY), 'internal' for the team, 'private' (default) for the owner's own tools. Widening later is a publish, so choose now."),
+      audience: external_exports.enum(["private", "internal", "public"]).optional().describe("create/update: who the agent serves: 'public' for anything customers or a website will talk to (it then answers from sources marked public ONLY), 'internal' for the team, 'private' (default) for the owner's own tools. Widening later is a publish, so choose now."),
+      description: external_exports.string().max(300).optional().describe("update: one-line description shown in the hub"),
+      systemMessage: external_exports.string().max(8e3).optional().describe("update: the agent instructions (system message)"),
+      noAnswerMessage: external_exports.string().max(500).optional().describe("update: what the agent says when the grounding gate declines to answer"),
+      grounding: external_exports.enum(["strict", "grounded_chat"]).optional().describe("update: 'strict' refuses anything not in the retrieved content (use it for anything customer-facing); 'grounded_chat' may add general knowledge around the cited content"),
+      collectionIds: external_exports.array(external_exports.string().max(64)).max(16).optional().describe("update: scope the agent to these collections (collection_id from awesomate_knowledge_collections list); replaces the collection scope only, other scope fields and free-form tags are kept"),
+      kinds: external_exports.array(external_exports.string().max(40)).max(16).optional().describe("update: restrict retrieval to source kinds (web, document, video, audio, image, book, dataset); omit for all kinds"),
+      sourceIds: external_exports.array(external_exports.string().max(200)).max(500).optional().describe("update: pin the scope to specific sources"),
+      maxSources: external_exports.number().int().min(1).max(10).optional().describe("update: how many sources one answer may cite (1-10)"),
+      temperature: external_exports.number().min(0).max(1).optional().describe("update: 0 is the most literal"),
       message: external_exports.string().max(4e3).optional().describe("test: the question to ask the draft"),
       sessionId: external_exports.string().max(128).optional().describe("test: keep follow-ups in one thread")
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.24.0",
+  "version": "0.26.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/awesomate-knowledge/SKILL.md

@@ -64,7 +64,7 @@ platform's answer beats anything you remember.
 | Instant search with facet counts (find WHAT is in there: moments, pages, datasets; free) | `awesomate_knowledge_search` |
 | Ask a question → verified answer + numbered sources (accepts the same facet `filters` to ask within a slice) | `awesomate_knowledge_ask` |
 | Agent persona / fallback message / model tier — get & set (the single workspace default) | `awesomate_knowledge_agent` |
-| Agent BUILDER: list / get / create (AI-drafted from their content, saved as a private draft; pass `audience:'public'` for anything customers will talk to — it then answers from sources marked public ONLY) / test the draft / publish (explicit approval first) | `awesomate_knowledge_agents` |
+| Agent BUILDER: list / get / create (AI-drafted from their content, saved as a private draft; pass `audience:'public'` for anything customers will talk to; it then answers from sources marked public ONLY) / update (edit the draft's instructions, grounding, no-answer message, audience and collection scope; nothing changes for callers until publish) / test the draft / publish (explicit approval first) | `awesomate_knowledge_agents` |
 | People, places, topics: list / name / hide / merge / alias suggestions / re-run resolution | `awesomate_knowledge_people` |
 | Business-data warehouse: `metrics` / `datasets` / `query` / `imports` — answer quantitative questions from their own imported business data (query is free-form but read-only) | `awesomate_knowledge_data` |
 | Refresh these skills from the latest package | `awesomate_skill_update` |