@awesomate/hosting-mcp 0.16.3 → 0.16.4

package/dist/index.js

@@ -40013,6 +40013,13 @@ async function knowledgeStatus(config3) {
     if (status.upgrade_required) {
       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.`
+      };
+    }
     return status;
   } catch (err) {
     return mapKnowledgeError(err, config3.apiBase);
@@ -40032,10 +40039,31 @@ 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 === "jobs") {
       const q = args.status ? `?status=${encodeURIComponent(args.status)}` : "";
@@ -40125,7 +40153,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 +41035,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, 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.",
     inputSchema: {
       action: external_exports.enum(["list", "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.4",
   "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,13 @@ 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
+   `status.usage.sources_total` (with `sources_total_truncated:true` it is a
+   floor). `awesomate_knowledge_sources {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