@awesomate/hosting-mcp 0.16.2 → 0.16.3

package/dist/index.js

@@ -39855,12 +39855,13 @@ var HubApiError = class extends Error {
   }
 };
 var REQUEST_TIMEOUT_MS = 15e3;
-async function hubRequest(config3, method, path, jsonBody) {
+async function hubRequest(config3, method, path, jsonBody, opts = {}) {
   const timeoutMs = method === "GET" ? REQUEST_TIMEOUT_MS : 24e4;
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
   const headers = { Authorization: `Bearer ${config3.pat}` };
   if (jsonBody !== void 0) headers["Content-Type"] = "application/json";
+  if (opts.accept) headers.Accept = opts.accept;
   let res;
   try {
     res = await (0, import_undici.fetch)(`${config3.apiBase}${path}`, {
@@ -39907,8 +39908,8 @@ async function hubRequest(config3, method, path, jsonBody) {
 function hubGet(config3, path) {
   return hubRequest(config3, "GET", path);
 }
-function hubPost(config3, path, jsonBody = {}) {
-  return hubRequest(config3, "POST", path, jsonBody);
+function hubPost(config3, path, jsonBody = {}, opts = {}) {
+  return hubRequest(config3, "POST", path, jsonBody, opts);
 }
 function hubPatch(config3, path, jsonBody = {}) {
   return hubRequest(config3, "PATCH", path, jsonBody);
@@ -40072,15 +40073,29 @@ function parseSse(text) {
   }
   return events;
 }
-function renderAnswer(meta, streamedAnswer) {
-  const status = typeof meta.status === "string" ? meta.status : streamedAnswer ? "ok" : "error";
+function renderAnswer(meta, streamedAnswer, streamError = null) {
+  const status = typeof meta.status === "string" ? meta.status : streamError ? "error" : streamedAnswer ? "ok" : "error";
+  const session = typeof meta.session === "string" && meta.session ? { session: meta.session } : {};
+  const fallback = typeof meta.answer_plain === "string" && meta.answer_plain || typeof meta.no_answer_message === "string" && meta.no_answer_message || null;
+  if (status === "error") {
+    return {
+      status: "error",
+      answer: null,
+      platform_error: true,
+      not_in_verified_content: false,
+      detail: streamError ?? (streamedAnswer || null),
+      configured_fallback: fallback,
+      ...session,
+      note: "The knowledge platform failed to answer \u2014 a service problem, NOT a content gap. Do not tell the user their content lacks this. Say the service hit a problem, retry once, and if it persists raise it via awesomate_support. configured_fallback is only what an end customer would have seen meanwhile."
+    };
+  }
   if (status !== "ok") {
-    const fallback = typeof meta.answer_plain === "string" && meta.answer_plain || typeof meta.no_answer_message === "string" && meta.no_answer_message || null;
     return {
       status,
       answer: null,
       not_in_verified_content: true,
       configured_fallback: fallback,
+      ...session,
       note: "The knowledge base has no verified answer for this \u2014 relay that honestly (use the configured fallback wording if present). Never fill the gap from memory."
     };
   }
@@ -40097,20 +40112,24 @@ function renderAnswer(meta, streamedAnswer) {
     answer: typeof meta.answer_plain === "string" && meta.answer_plain ? meta.answer_plain : streamedAnswer,
     sources,
     ...typeof meta.score === "number" ? { score: meta.score } : {},
+    ...session,
     note: "Present the answer with its numbered sources \u2014 the citations are the product."
   };
 }
 async function knowledgeAsk(config3, args) {
   try {
-    const raw = await hubPost(config3, "/api/knowledge/chat", {
-      question: args.question,
-      ...args.session ? { session: args.session } : {}
-    });
+    const raw = await hubPost(
+      config3,
+      "/api/knowledge/chat",
+      { question: args.question, ...args.session ? { session: args.session } : {} },
+      { accept: "application/json" }
+    );
     if (raw && typeof raw === "object") {
       return renderAnswer(raw, "");
     }
     const events = parseSse(String(raw ?? ""));
     let streamedAnswer = "";
+    let streamError = null;
     let meta = {};
     for (const ev of events) {
       if (ev.event === "answer") streamedAnswer += ev.data;
@@ -40119,9 +40138,16 @@ async function knowledgeAsk(config3, args) {
           meta = { ...meta, ...JSON.parse(ev.data) };
         } catch {
         }
+      } else if (ev.event === "error" && ev.data) {
+        try {
+          const parsed = JSON.parse(ev.data);
+          streamError = typeof parsed.message === "string" ? parsed.message : ev.data;
+        } catch {
+          streamError = ev.data;
+        }
       }
     }
-    return renderAnswer(meta, streamedAnswer);
+    return renderAnswer(meta, streamedAnswer, streamError);
   } catch (err) {
     return mapKnowledgeError(err, config3.apiBase);
   }
@@ -41003,7 +41029,7 @@ server.registerTool(
 server.registerTool(
   "awesomate_knowledge_ask",
   {
-    description: `Ask the account's knowledge base a question and get the VERIFIED answer with numbered sources (title, locator, url) \u2014 the test surface for 'is my content in there and answering well'. status other than ok means the verified content has no answer: relay that honestly (use the configured fallback wording), never fill the gap from memory \u2014 an honest "it doesn't know" is the feature working. Counts against the monthly answers quota.`,
+    description: `Ask the account's knowledge base a question and get the VERIFIED answer with numbered sources (title, locator, url) \u2014 the test surface for 'is my content in there and answering well'. Read status: ok \u2192 present answer + sources. no_results / failed_validation (not_in_verified_content:true) \u2192 the verified content has no answer: relay that honestly (use configured_fallback), never fill the gap from memory \u2014 an honest "it doesn't know" is the feature working. error (platform_error:true) \u2192 the platform itself failed (model/API/infra): NOT a content gap \u2014 never tell the user their content lacks the answer; retry once, then awesomate_support. Counts against the monthly answers quota.`,
     inputSchema: {
       question: external_exports.string().min(1).max(2e3),
       session: external_exports.string().max(128).optional().describe("Stable id to keep follow-up questions in one conversation thread")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.16.2",
+  "version": "0.16.3",
   "description": "Awesomate MCP server \u2014 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/references/citations-and-grounding.md

@@ -17,8 +17,12 @@ and widgets never see a partial or unvalidated answer.
 - `status: 'failed_validation'` — the model drafted something that didn't
   survive the citation gate. The user never sees the draft; treat exactly
   like no_results.
-- `status: 'error'` — infrastructure problem; suggest trying again, and
-  `awesomate_support` if it persists.
+- `status: 'error'` (`platform_error: true`, `not_in_verified_content:
+  false`) — the platform could not answer at all (model/API/infra outage).
+  This says NOTHING about the content: never relay it as "your content
+  doesn't cover this". `detail` carries the platform's message when it sent
+  one; `configured_fallback` is only what an end customer would have seen
+  meanwhile. Retry once; if it persists, `awesomate_support`.
 
 ## Rendering citations for humans