@awesomate/hosting-mcp 0.16.4 → 0.16.5

package/dist/index.js

@@ -40014,13 +40014,20 @@ async function knowledgeStatus(config3) {
       return { ...status, upsell: upsellPayload(config3.apiBase, status.plan) };
     }
     const usage = status.usage;
-    if (usage && usage.sources_total_truncated === true) {
-      return {
-        ...status,
-        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.`
-      };
+    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 status;
+    return annotated;
   } catch (err) {
     return mapKnowledgeError(err, config3.apiBase);
   }
@@ -40065,6 +40072,24 @@ async function knowledgeSources(config3, args) {
       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)}` : "";
       return await hubGet(config3, `/api/knowledge/jobs${q}`);
@@ -41035,9 +41060,9 @@ server.registerTool(
 server.registerTool(
   "awesomate_knowledge_sources",
   {
-    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, and the total lives in awesomate_knowledge_status \u2192 usage.sources_total. '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"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.16.4",
+  "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

@@ -38,8 +38,9 @@ platform's answer beats anything you remember.
      still building; `usage` → month-to-date vs `usage.included` quota.
 3. Only then design: what content exists, what's already ingested, what the
    user wants the bot to answer. For "what's ingested" use
-   `status.usage.sources_total` (with `sources_total_truncated:true` it is a
-   floor). `awesomate_knowledge_sources {action:'list'}` returns ONE page —
+   `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.