@awesomate/hosting-mcp 0.21.0 → 0.22.0

package/dist/index.js

@@ -40196,6 +40196,41 @@ async function knowledgeSources(config3, args) {
       const page = await hubGet(config3, `/api/knowledge/sources${qs ? `?${qs}` : ""}`);
       return describeSourcePage(page);
     }
+    if (args.action === "sync_rules") {
+      const r = await hubGet(config3, "/api/knowledge/files-sync/rules");
+      return { ...r, note: "Each rule keeps a File Manager folder synced into the knowledge base: files under path_prefix (matching include_globs, if any) are ingested with the rule visibility/tags/collection, re-ingested when they change, and handled per on_file_removed when they disappear. A worker sweeps every 15 min; uploads under an auto rule sync immediately; sync_run sweeps now." };
+    }
+    if (args.action === "sync_state") {
+      const q = new URLSearchParams();
+      if (args.ruleId !== void 0) q.set("rule_id", String(args.ruleId));
+      if (args.status) q.set("status", args.status);
+      if (args.limit !== void 0) q.set("limit", String(args.limit));
+      const qs = q.toString();
+      return await hubGet(config3, `/api/knowledge/files-sync/state${qs ? `?${qs}` : ""}`);
+    }
+    if (args.action === "sync_rule_create") {
+      if (!args.pathPrefix) return { error: "invalid_request", note: "sync_rule_create needs pathPrefix (a File Manager folder such as 'public/reports')" };
+      if (args.visibility === "public" && !args.confirm) {
+        return { error: "confirmation_required", note: "A rule that makes every file in a folder PUBLIC is a standing publication. Explain that, then call again with confirm set to the account slug only after the user agrees in words." };
+      }
+      return await hubPost(config3, "/api/knowledge/files-sync/rules", {
+        path_prefix: args.pathPrefix,
+        ...args.includeGlobs?.length ? { include_globs: args.includeGlobs } : {},
+        ...args.collectionIds?.[0] ? { collection_id: args.collectionIds[0] } : {},
+        ...args.visibility ? { visibility: args.visibility } : {},
+        ...args.tags?.length ? { tags: args.tags } : {},
+        ...args.onFileRemoved ? { on_file_removed: args.onFileRemoved } : {},
+        ...args.confirm ? { confirm: args.confirm } : {}
+      });
+    }
+    if (args.action === "sync_rule_delete") {
+      if (args.ruleId === void 0) return { error: "invalid_request", note: "sync_rule_delete needs ruleId (from sync_rules)" };
+      return await hubDelete(config3, `/api/knowledge/files-sync/rules/${args.ruleId}`);
+    }
+    if (args.action === "sync_run") {
+      const r = await hubPost(config3, "/api/knowledge/files-sync/run", {});
+      return { ...r, note: 'Files ingested this run are queued on the platform; verify with awesomate_knowledge_sources {action:"jobs"} and a search for a phrase from the file, never with the run summary alone.' };
+    }
     if (args.action === "search") {
       const q = new URLSearchParams();
       if (args.q) q.set("q", args.q);
@@ -41636,9 +41671,13 @@ server.registerTool(
 server.registerTool(
   "awesomate_knowledge_sources",
   {
-    description: "The knowledge base's content sources \u2014 the LIBRARY. action 'search' {q?, kind?, visibility?, tags?, collectionIds?, cursor?, limit?} \u2014 find sources by title/tag substring and metadata filters (instant, free; for CONTENT search use awesomate_knowledge_search); each row carries visibility (private|internal|public \u2014 who may retrieve it, ENFORCED), tags and collections. 'tag' {sourceId, tags} \u2014 REPLACE a source's free-form tags. 'set_visibility' {sourceId|sourceIds, visibility, confirm?} \u2014 change who may retrieve the source(s); 'public' is irreversible once fetched, so it needs the user's explicit agreement and their account slug as confirm. 'move' {sourceId|sourceIds, collectionIds?, removeCollectionIds?} \u2014 add to / remove from collections. '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, failed_jobs_7d}: use THIS to say what the knowledge base contains, and if failed_jobs_7d > 0 say so \u2014 those ingests are missing from every other count. '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?}, optionally with visibility (default private), tags and collectionIds; ALWAYS get explicit approval first (ingest costs money and counts against quota), for a local FILE on the user's machine use awesomate_knowledge_upload instead (it streams the file from disk; this tool takes URLs only). 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 \u2014 the LIBRARY. action 'search' {q?, kind?, visibility?, tags?, collectionIds?, cursor?, limit?} \u2014 find sources by title/tag substring and metadata filters (instant, free; for CONTENT search use awesomate_knowledge_search); each row carries visibility (private|internal|public \u2014 who may retrieve it, ENFORCED), tags and collections. 'tag' {sourceId, tags} \u2014 REPLACE a source's free-form tags. 'set_visibility' {sourceId|sourceIds, visibility, confirm?} \u2014 change who may retrieve the source(s); 'public' is irreversible once fetched, so it needs the user's explicit agreement and their account slug as confirm. 'move' {sourceId|sourceIds, collectionIds?, removeCollectionIds?} \u2014 add to / remove from collections. 'sync_rules' / 'sync_rule_create' {pathPrefix, includeGlobs?, visibility?, tags?, collectionIds?, onFileRemoved?} / 'sync_rule_delete' {ruleId} / 'sync_run' / 'sync_state' \u2014 keep a folder of the account's File Manager (their n8n file system: public/, private/, temp/) synced into the knowledge base, so files their workflows write become searchable; a public rule needs confirm. '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, failed_jobs_7d}: use THIS to say what the knowledge base contains, and if failed_jobs_7d > 0 say so \u2014 those ingests are missing from every other count. '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?}, optionally with visibility (default private), tags and collectionIds; ALWAYS get explicit approval first (ingest costs money and counts against quota), for a local FILE on the user's machine use awesomate_knowledge_upload instead (it streams the file from disk; this tool takes URLs only). 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", "summary", "add", "remove", "jobs", "search", "tag", "set_visibility", "move"]),
+      action: external_exports.enum(["list", "summary", "add", "remove", "jobs", "search", "tag", "set_visibility", "move", "sync_rules", "sync_rule_create", "sync_rule_delete", "sync_run", "sync_state"]),
+      pathPrefix: external_exports.string().max(512).optional().describe("sync_rule_create: a File Manager folder to keep synced, e.g. 'public/reports'"),
+      includeGlobs: external_exports.array(external_exports.string().max(120)).max(20).optional().describe("sync_rule_create: only files matching these globs (relative to the folder), e.g. ['**/*.pdf']"),
+      onFileRemoved: external_exports.enum(["keep", "demote_to_private", "delete"]).optional().describe("sync_rule_create: what happens to the knowledge source when the file is removed (default demote_to_private for internal/public rules, keep for private)"),
+      ruleId: external_exports.number().int().optional().describe("sync_rule_delete / sync_state: rule id from sync_rules"),
       q: external_exports.string().max(100).optional().describe("search: title/tag substring"),
       kind: external_exports.string().max(32).optional().describe("search: source kind filter (web, document, video, audio, image, book, dataset)"),
       visibility: external_exports.enum(["private", "internal", "public"]).optional().describe("add: the audience the new source is cleared for (default private); set_visibility: the level to apply; search: filter"),
@@ -41656,10 +41695,10 @@ server.registerTool(
       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, cursor, limit, q, kind, visibility, tags, collectionIds, removeCollectionIds, sourceIds, confirm }) => {
+  async ({ action, url, sitemap, since, sourceId, status, cursor, limit, q, kind, visibility, tags, collectionIds, removeCollectionIds, sourceIds, confirm, pathPrefix, includeGlobs, onFileRemoved, ruleId }) => {
     try {
       return knowledgeResult(
-        await knowledgeSources(requireConfig(), { action, url, sitemap, since, sourceId, status, cursor, limit, q, kind, visibility, tags, collectionIds, removeCollectionIds, sourceIds, confirm })
+        await knowledgeSources(requireConfig(), { action, url, sitemap, since, sourceId, status, cursor, limit, q, kind, visibility, tags, collectionIds, removeCollectionIds, sourceIds, confirm, pathPrefix, includeGlobs, onFileRemoved, ruleId })
       );
     } catch (err) {
       return knowledgeError(err);
@@ -42097,15 +42136,26 @@ server.registerTool(
   {
     description: "Ingest ONE file from the user's own computer into their Knowledge Base (Pro+). Pass a LOCAL PATH \u2014 this server runs on their machine and streams the file to the hub itself, so the file contents never pass through the conversation. Handles documents (pdf, md, txt), business data (csv, tsv, xls, xlsx, json), audio and video (transcribed), and images. Word/PowerPoint/RTF/EPUB files are NOT parseable yet \u2014 the tool refuses them with the workaround (export to PDF, or save as .md/.txt). Max 100 MB per file; bigger media goes through the hub's Knowledge \u2192 Sources page. INGESTING COSTS MONEY and counts against the monthly allowance, so ALWAYS get explicit approval for the specific file(s) first and say what it will consume. For several files, call once per file and report progress \u2014 do not loop silently. Returns a job with its live status; poll awesomate_knowledge_sources {action:'jobs'} until it succeeds (a duplicate upload replays the earlier job \u2014 a response already reading succeeded needs no polling), then probe the content with awesomate_knowledge_ask before building anything on it. A pack_required response means the allowance is exhausted: nothing was ingested and nothing was purchased.",
     inputSchema: {
-      path: external_exports.string().min(1).max(4096).describe("Path to the file on the user's machine (~ is expanded)"),
-      title: external_exports.string().max(300).optional().describe("Display title; defaults to the filename"),
+      path: external_exports.string().min(1).max(4096).optional().describe("Path to the file on the user's machine (~ is expanded). Omit when using fromFilesPath."),
+      fromFilesPath: external_exports.string().max(1024).optional().describe("Instead of a local file: a path in the account's File Manager (their n8n file system), relative to files/, e.g. 'public/reports/weekly.md'. The hub streams it from their storage \u2014 nothing leaves this machine."),
+      title: external_exports.string().max(300).optional().describe("Display title; defaults to the filename (local uploads only)"),
       visibility: external_exports.enum(["private", "internal", "public"]).optional().describe("Who may retrieve this source (default private). public = customers and public chatbots; irreversible once fetched \u2014 ask first."),
       tags: external_exports.array(external_exports.string().max(64)).max(64).optional().describe("Free-form tags for the new source"),
       collectionIds: external_exports.array(external_exports.string().max(64)).max(16).optional().describe("Put the new source in these collections (awesomate_knowledge_collections list)")
     }
   },
-  async ({ path: rawPath, title, visibility, tags, collectionIds }) => {
+  async ({ path: rawPath, fromFilesPath, title, visibility, tags, collectionIds }) => {
     try {
+      if (fromFilesPath) {
+        const out = await hubPost(requireConfig(), "/api/knowledge/sources/from-files", {
+          path: fromFilesPath,
+          ...visibility ? { visibility } : {},
+          ...tags?.length ? { tags } : {},
+          ...collectionIds?.length ? { collection_ids: collectionIds } : {}
+        });
+        return knowledgeResult({ ...out, note: 'Queued from the File Manager. Poll awesomate_knowledge_sources {action:"jobs"} until succeeded, then verify with a search for a phrase from the file.' });
+      }
+      if (!rawPath) return errorResult(new Error("Give either path (a local file) or fromFilesPath (a File Manager path)."));
       const { statSync, existsSync: existsSync3 } = await import("node:fs");
       const { resolve: resolve2, basename, extname } = await import("node:path");
       const expanded = rawPath.startsWith("~") ? join3(homedir3(), rawPath.slice(1).replace(/^[/\\]/, "")) : rawPath;

package/package.json

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

@@ -60,6 +60,7 @@ platform's answer beats anything you remember.
 | Enable the knowledge base (idempotent; 202 = keep polling status) | `awesomate_knowledge_provision` |
 | The LIBRARY: search by title/tag/collection/visibility, list, add url·sitemap (with visibility, tags, collections), tag, set visibility (public needs the slug typed), move between collections, remove, ingest jobs | `awesomate_knowledge_sources` |
 | Collections — named sets of sources a chatbot is scoped to: list / create / update / delete / add / remove members | `awesomate_knowledge_collections` |
+| Keep a File Manager folder (their n8n file system) synced into the knowledge base: `sync_rules` / `sync_rule_create` / `sync_rule_delete` / `sync_run` / `sync_state` on the sources tool; one file at a time via `awesomate_knowledge_upload {fromFilesPath}` | `awesomate_knowledge_sources`, `awesomate_knowledge_upload` |
 | 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` |

package/skill/awesomate-knowledge/references/from-your-files.md

@@ -37,6 +37,15 @@ contents never pass through the conversation and a 100 MB PDF costs no context.
 - A folder path is rejected on purpose — list it, agree the files, then upload.
 - Public URLs and whole sitemaps stay on `awesomate_knowledge_sources`
   `{action:'add'}`. Use that for their website; use upload for their disk.
+- **Files already in their File Manager** (the n8n file system at hub
+  Files — `public/`, `private/`, `temp/`, where their workflows write
+  outputs): `awesomate_knowledge_upload {fromFilesPath: 'public/reports/x.md'}`
+  for one file, or a folder rule with `awesomate_knowledge_sources
+  {action:'sync_rule_create', pathPrefix, visibility, collectionIds}` so
+  every file a workflow drops there is ingested automatically (uploads sync
+  at once, everything else on a 15-minute sweep). A `public/` folder being
+  web-served does NOT make its knowledge sources public — say which
+  visibility the rule should use, default private.
 - **What parses:** pdf, md, txt (documents); csv, tsv, xls, xlsx, json (business data);
   audio, video, images. Word/PowerPoint/RTF/EPUB/HTML files are refused with a
   workaround — export to PDF or save as .md/.txt; a web page goes in by URL.