@awesomate/hosting-mcp 0.16.3 → 0.16.5

package/dist/index.js

@@ -40013,7 +40013,21 @@ async function knowledgeStatus(config3) {
     if (status.upgrade_required) {
       return { ...status, upsell: upsellPayload(config3.apiBase, status.plan) };
     }
-    return status;
+    const usage = status.usage;
+    if (!usage) return status;
+    const annotated = {
+      ...status,
+      usage_glossary: {
+        pages: "month-to-date hub-submitted page quota used (vs usage.included.pages) \u2014 NOT the size of the library",
+        sources_total: 'sources currently in the library; kinds in usage.sources_by_kind or awesomate_knowledge_sources {action:"summary"}'
+      }
+    };
+    if (usage.sources_total_source === "hourly_gauge") {
+      annotated.note = "The live source count failed for this call: usage.sources_total / sources_failed are the last hourly gauge \u2014 possibly stale, and 0 for a library the gauge could never count. Retry before quoting them; the tenant itself is active.";
+    } else if (usage.sources_total_truncated === true) {
+      annotated.note = `usage.sources_total is a floor: the live count stopped at ${String(usage.sources_total)} sources (paged-count cap). The library holds at least that many \u2014 never quote it as the exact total.`;
+    }
+    return annotated;
   } catch (err) {
     return mapKnowledgeError(err, config3.apiBase);
   }
@@ -40032,10 +40046,49 @@ async function knowledgeProvision(config3) {
     return mapKnowledgeError(err, config3.apiBase);
   }
 }
+function describeSourcePage(page) {
+  if (!Array.isArray(page.sources)) return page;
+  const kinds = {};
+  for (const s of page.sources) {
+    const k = typeof s.kind === "string" ? s.kind : "unknown";
+    kinds[k] = (kinds[k] ?? 0) + 1;
+  }
+  const hasMore = typeof page.next_cursor === "string" && page.next_cursor.length > 0;
+  return {
+    ...page,
+    page: { returned: page.sources.length, kinds_on_this_page: kinds, has_more: hasMore },
+    ...hasMore ? {
+      note: 'This is ONE page of the most recently ingested sources, not the whole library \u2014 do not summarise the knowledge base from it. Pass cursor=next_cursor to continue (limit up to 200). For the total, use awesomate_knowledge_status \u2192 usage.sources_total (sources_total_truncated:true means "at least that many").'
+    } : {}
+  };
+}
 async function knowledgeSources(config3, args) {
   try {
     if (args.action === "list") {
-      return await hubGet(config3, "/api/knowledge/sources");
+      const q = new URLSearchParams();
+      if (args.cursor) q.set("cursor", args.cursor);
+      if (args.limit !== void 0) q.set("limit", String(args.limit));
+      const qs = q.toString();
+      const page = await hubGet(config3, `/api/knowledge/sources${qs ? `?${qs}` : ""}`);
+      return describeSourcePage(page);
+    }
+    if (args.action === "summary") {
+      try {
+        const s = await hubGet(config3, "/api/knowledge/sources/summary");
+        return {
+          ...s,
+          note: "Exact whole-library counts. by_kind is what the knowledge base answers from; the paged list is only for browsing individual sources."
+        };
+      } catch (err) {
+        if (err instanceof HubApiError && err.status === 404) {
+          return {
+            available: false,
+            reason: "summary_unavailable",
+            note: "The knowledge platform predates the sources summary. Use awesomate_knowledge_status \u2192 usage.sources_total for the total and page the list (cursor) to see kinds."
+          };
+        }
+        throw err;
+      }
     }
     if (args.action === "jobs") {
       const q = args.status ? `?status=${encodeURIComponent(args.status)}` : "";
@@ -40125,7 +40178,8 @@ async function knowledgeAsk(config3, args) {
       { accept: "application/json" }
     );
     if (raw && typeof raw === "object") {
-      return renderAnswer(raw, "");
+      const envelope = raw;
+      return renderAnswer(envelope, typeof envelope.answer === "string" ? envelope.answer : "");
     }
     const events = parseSse(String(raw ?? ""));
     let streamedAnswer = "";
@@ -41006,20 +41060,22 @@ server.registerTool(
 server.registerTool(
   "awesomate_knowledge_sources",
   {
-    description: "The knowledge base's content sources. action 'list' \u2014 current sources (live metadata). 'jobs' \u2014 ingest job statuses (optional status filter: queued|running|succeeded|failed). 'add' \u2014 ingest a public page {url} or a whole site {sitemap, since?}; ALWAYS get explicit approval first (ingest costs money and counts against quota), and for local FILES send the user to the hub's Knowledge \u2192 Sources upload page \u2014 this tool cannot carry file bytes. A pack_required response means the allowance is exhausted: NOTHING was purchased \u2014 present the pack price (1 credit = $100) and let the user buy from the hub if they want it. 'remove' {sourceId} \u2014 deletes the source AND its indexed content; explicit approval required.",
+    description: "The knowledge base's content sources. action 'list' \u2014 ONE page of sources, most recently ingested first (default 50, max 200 via limit): read `page.has_more`/`next_cursor` and pass cursor to continue \u2014 a page is never the whole library. 'summary' \u2014 exact whole-library counts {total, by_kind, chunks, indexed_chunks, failed_sources}: use THIS to say what the knowledge base contains. 'jobs' \u2014 ingest job statuses (optional status filter: queued|running|succeeded|failed). 'add' \u2014 ingest a public page {url} or a whole site {sitemap, since?}; ALWAYS get explicit approval first (ingest costs money and counts against quota), and for local FILES send the user to the hub's Knowledge \u2192 Sources upload page \u2014 this tool cannot carry file bytes. A pack_required response means the allowance is exhausted: NOTHING was purchased \u2014 present the pack price (1 credit = $100) and let the user buy from the hub if they want it. 'remove' {sourceId} \u2014 deletes the source AND its indexed content; explicit approval required.",
     inputSchema: {
-      action: external_exports.enum(["list", "add", "remove", "jobs"]),
+      action: external_exports.enum(["list", "summary", "add", "remove", "jobs"]),
       url: external_exports.string().url().optional().describe("add: one public page / blog post / YouTube link"),
       sitemap: external_exports.string().url().optional().describe("add: sitemap.xml URL \u2014 ingests every listed page"),
       since: external_exports.string().optional().describe("add+sitemap only: skip entries with lastmod older than this ISO date"),
       sourceId: external_exports.string().optional().describe("remove only"),
-      status: external_exports.string().optional().describe("jobs only: queued|running|succeeded|failed")
+      status: external_exports.string().optional().describe("jobs only: queued|running|succeeded|failed"),
+      cursor: external_exports.string().max(512).optional().describe("list only: next_cursor from the previous page"),
+      limit: external_exports.number().int().min(1).max(200).optional().describe("list only: page size (default 50, max 200)")
     }
   },
-  async ({ action, url, sitemap, since, sourceId, status }) => {
+  async ({ action, url, sitemap, since, sourceId, status, cursor, limit }) => {
     try {
       return knowledgeResult(
-        await knowledgeSources(requireConfig(), { action, url, sitemap, since, sourceId, status })
+        await knowledgeSources(requireConfig(), { action, url, sitemap, since, sourceId, status, cursor, limit })
       );
     } catch (err) {
       return knowledgeError(err);

package/package.json

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

@@ -36,9 +36,14 @@ platform's answer beats anything you remember.
      content is indexed in Sydney, deletable any time), wait, re-check.
    - `tenant: null` or `status: 'provisioning'` → not enabled yet /
      still building; `usage` → month-to-date vs `usage.included` quota.
-3. Only then design: what content exists, what's already ingested
-   (`awesomate_knowledge_sources {action:'list'}`), what the user wants the
-   bot to answer.
+3. Only then design: what content exists, what's already ingested, what the
+   user wants the bot to answer. For "what's ingested" use
+   `awesomate_knowledge_sources {action:'summary'}` (exact `total` +
+   `by_kind`; falls back to `status.usage.sources_total`, a floor when
+   `sources_total_truncated:true`). `{action:'list'}` returns ONE page —
+   the most recently ingested first (default 50, `limit` up to 200) — read
+   `page.kinds_on_this_page` / `page.has_more` and follow `next_cursor`;
+   never describe the library from a single page.
 
 ## 1. Tools