@awesomate/hosting-mcp 0.17.0 → 0.18.0

package/dist/index.js

@@ -39950,11 +39950,11 @@ function scrubKeyMaterial(text) {
 var KNOWLEDGE_GATE_COPY = {
   displayName: "Knowledge Base",
   requiredPlan: "Pro",
-  description: "Turn your own content \u2014 videos, blog posts, books, socials \u2014 into a knowledge base your AI agents answer from, with a citation for every claim. If it isn't in your content, the bot says so instead of making something up.",
+  description: "Turn your own content (videos, blog posts, books, socials) into a knowledge base your AI agents answer from, with a citation for every claim. If it isn't in your content, the bot says so instead of making something up.",
   bullets: [
     "Answers come only from your published content, cited back to the exact source",
-    `No made-up answers in front of a customer \u2014 no evidence means an honest "I don't know"`,
-    "Feed it videos, podcasts, blog posts and books \u2014 we transcribe and index the lot",
+    `No made-up answers in front of a customer: no evidence means an honest "I don't know"`,
+    "Feed it videos, podcasts, blog posts and books. We transcribe and index the lot",
     "Plugs straight into your n8n chat agents, so the 10pm enquiry gets a real answer",
     "Hosted in Sydney, isolated to your account, and gone the moment you delete it"
   ]
@@ -39965,7 +39965,7 @@ function upsellPayload(apiBase, plan) {
     ...typeof plan === "string" ? { plan } : {},
     feature: KNOWLEDGE_GATE_COPY,
     billingUrl: `${apiBase}/billing`,
-    note: "Knowledge Base needs the Pro plan. Do NOT retry \u2014 relay this honestly, share the billing link, and let the user decide. Preview + explicit confirmation before any upgrade."
+    note: "Knowledge Base needs the Pro plan. Do NOT retry. Relay this honestly, share the billing link, and let the user decide. Preview + explicit confirmation before any upgrade."
   };
 }
 function consentPayload(message) {
@@ -39973,14 +39973,14 @@ function consentPayload(message) {
     consent_required: true,
     message,
     settingsPath: 'Settings \u2192 Privacy \u2192 "Knowledge Platform"',
-    note: "The user must flip the consent themselves in the hub \u2014 do NOT retry until they confirm it is on."
+    note: "The user must flip the consent themselves in the hub. Do NOT retry until they confirm it is on."
   };
 }
 function notAvailablePayload(apiBase) {
   return {
     available: false,
     reason: "not_available_on_this_hub",
-    note: "Knowledge Base is not enabled on this hub (feature switch off, or the hub predates it). The connection itself is fine \u2014 do not retry. The user can ask Awesomate support when it will be available for their account.",
+    note: "Knowledge Base is not enabled on this hub (feature switch off, or the hub predates it). The connection itself is fine; do not retry. The user can ask Awesomate support when it will be available for their account.",
     hubUrl: apiBase
   };
 }
@@ -39990,7 +39990,7 @@ function packConfirmationPayload(body) {
     purchased: false,
     dimension: body.dimension ?? null,
     pack: body.pack ?? null,
-    note: "This ingest would exceed the included allowance. NOTHING was purchased and the source was NOT added. An Ingestion Pack costs 1 credit ($100) \u2014 state that plainly, get an explicit yes, then send the user to the hub Knowledge \u2192 Usage page to buy it (this tool never spends credits)."
+    note: "This ingest would exceed the included allowance. NOTHING was purchased and the source was NOT added. An Ingestion Pack costs 1 credit ($100). State that plainly, get an explicit yes, then send the user to the hub Knowledge \u2192 Usage page to buy it (this tool never spends credits)."
   };
 }
 function bodyOf(err) {
@@ -40018,14 +40018,14 @@ async function knowledgeStatus(config3) {
     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",
+        pages: "month-to-date hub-submitted page quota used (vs usage.included.pages): 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.";
+      annotated.note = "The live source count failed for this call: usage.sources_total / sources_failed are the last hourly gauge: 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.`;
+      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: never quote it as the exact total.`;
     }
     return annotated;
   } catch (err) {
@@ -40038,7 +40038,7 @@ async function knowledgeProvision(config3) {
     if (result.pending) {
       return {
         ...result,
-        note: "Provisioning continues in the background \u2014 poll awesomate_knowledge_status until the tenant is active (a few minutes at most). Re-calling provision is safe (idempotent)."
+        note: "Provisioning continues in the background. Poll awesomate_knowledge_status until the tenant is active (a few minutes at most). Re-calling provision is safe (idempotent)."
       };
     }
     return result;
@@ -40058,7 +40058,7 @@ function describeSourcePage(page) {
     ...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").'
+      note: 'This is ONE page of the most recently ingested sources, not the whole library: 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").'
     } : {}
   };
 }
@@ -40104,7 +40104,7 @@ async function knowledgeSources(config3, args) {
     if (!args.url && !args.sitemap) {
       return {
         error: "invalid_request",
-        note: "add needs url or sitemap. For a local FILE, send the user to the hub: Knowledge \u2192 Sources \u2192 Upload \u2014 files stream there; this tool cannot carry file bytes in v1."
+        note: "add needs url or sitemap. For a local FILE, send the user to the hub: Knowledge \u2192 Sources \u2192 Upload. Files stream there; this tool cannot carry file bytes in v1."
       };
     }
     const body = args.url ? { url: args.url } : { sitemap: args.sitemap, ...args.since ? { since: args.since } : {} };
@@ -40139,7 +40139,7 @@ function renderAnswer(meta, streamedAnswer, streamError = null) {
       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."
+      note: "The knowledge platform failed to answer: 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") {
@@ -40149,7 +40149,7 @@ function renderAnswer(meta, streamedAnswer, streamError = 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."
+      note: "The knowledge base has no verified answer for this. Relay that honestly (use the configured fallback wording if present). Never fill the gap from memory."
     };
   }
   const rawSources = Array.isArray(meta.sources) ? meta.sources : [];
@@ -40166,7 +40166,7 @@ function renderAnswer(meta, streamedAnswer, streamError = null) {
     sources,
     ...typeof meta.score === "number" ? { score: meta.score } : {},
     ...session,
-    note: "Present the answer with its numbered sources \u2014 the citations are the product."
+    note: "Present the answer with its numbered sources; the citations are the product."
   };
 }
 async function knowledgeAsk(config3, args) {
@@ -40174,7 +40174,7 @@ async function knowledgeAsk(config3, args) {
     const raw = await hubPost(
       config3,
       "/api/knowledge/chat",
-      { question: args.question, ...args.session ? { session: args.session } : {} },
+      { question: args.question, ...args.session ? { session: args.session } : {}, ...args.filters ? { filters: askFilters(args.filters) } : {} },
       { accept: "application/json" }
     );
     if (raw && typeof raw === "object") {
@@ -40210,10 +40210,10 @@ function entityLayerUnavailablePayload() {
   return {
     available: false,
     reason: "entity_layer_not_available",
-    note: "People, places and connections are not switched on for this knowledge base yet (the platform has not deployed the entity layer for this tenant). Nothing to fix on the user's side \u2014 do not retry; the counts appear once the first resolution runs."
+    note: "People, places and connections are not switched on for this knowledge base yet (the platform has not deployed the entity layer for this tenant). Nothing to fix on the user's side: do not retry; the counts appear once the first resolution runs."
   };
 }
-var PHOTOS_NOTE = "Text only: names, mention counts and the sources behind them. Photos of unnamed people are only viewable on the hub Knowledge \u2192 People page \u2014 never guess who someone is from a handle.";
+var PHOTOS_NOTE = "Text only: names, mention counts and the sources behind them. Photos of unnamed people are only viewable on the hub Knowledge \u2192 People page: never guess who someone is from a handle.";
 function invalid(note) {
   return { error: "invalid_request", note };
 }
@@ -40224,7 +40224,7 @@ function mapPeopleError(err, apiBase) {
       return {
         error: "not_found",
         message: typeof body.message === "string" ? body.message : "No such person or entity on this knowledge base",
-        note: "Use the exact person_id / entity_id from a fresh list \u2014 ids are opaque and per-tenant."
+        note: "Use the exact person_id / entity_id from a fresh list: ids are opaque and per-tenant."
       };
     }
   }
@@ -40256,13 +40256,13 @@ async function knowledgePeople(config3, args) {
         const page = await hubGet(config3, `/api/knowledge/entities/aliases?${q.toString()}`);
         return {
           ...page,
-          note: "Each suggestion is a text name the content uses that probably refers to a known entity. Show the user the alias, the suggested match and the confidence, then use decide with the (kind, alias_norm) pair \u2014 only after they explicitly say accept, reject, or create."
+          note: "Each suggestion is a text name the content uses that probably refers to a known entity. Show the user the alias, the suggested match and the confidence, then use decide with the (kind, alias_norm) pair: only after they explicitly say accept, reject, or create."
         };
       }
       const result = await hubPost(config3, "/api/knowledge/entities/resolve", {});
       return {
         ...result,
-        note: result.status === "queued" ? "Resolution queued. It re-scans the content for people/places/topics and counts toward the ingestion allowance; the user's names and decisions are never undone. Check back with list for the refreshed counts." : "A resolution is already queued or running \u2014 nothing new was started. Check back with list for the refreshed counts."
+        note: result.status === "queued" ? "Resolution queued. It re-scans the content for people/places/topics and counts toward the ingestion allowance; the user's names and decisions are never undone. Check back with list for the refreshed counts." : "A resolution is already queued or running: nothing new was started. Check back with list for the refreshed counts."
       };
     }
     if (args.action === "get") {
@@ -40278,7 +40278,7 @@ async function knowledgePeople(config3, args) {
       let body;
       if (args.action === "rename") {
         const name = args.displayName?.trim();
-        if (!name) return invalid("rename needs displayName (1\u201380 chars) \u2014 the name the USER gave, never a guess");
+        if (!name) return invalid("rename needs displayName (1\u201380 chars): the name the USER gave, never a guess");
         body = { display_name: name };
       } else {
         body = { status: args.action === "hide" ? "hidden" : "unknown" };
@@ -40292,7 +40292,7 @@ async function knowledgePeople(config3, args) {
         changed: Object.keys(body),
         requested: body,
         ...result,
-        note: args.action === "rename" ? "The name is attached to every source this person appears in and the agent uses it from the next reindex. Read the new display_name back to the user to confirm." : args.action === "hide" ? "Hidden \u2014 this person no longer appears in answers. Reversible with unhide." : "Unhidden \u2014 back in answers from the next resolution."
+        note: args.action === "rename" ? "The name is attached to every source this person appears in and the agent uses it from the next reindex. Read the new display_name back to the user to confirm." : args.action === "hide" ? "Hidden: this person no longer appears in answers. Reversible with unhide." : "Unhidden: back in answers from the next resolution."
       };
     }
     if (args.action === "merge") {
@@ -40325,7 +40325,7 @@ async function knowledgePeople(config3, args) {
       return {
         requested: body,
         ...result,
-        note: args.decision === "reject" ? "Rejected \u2014 the alias stays a plain text mention and will not be suggested again." : "Accepted \u2014 mentions re-link on the next resolution. Read entity_id back to the user."
+        note: args.decision === "reject" ? "Rejected: the alias stays a plain text mention and will not be suggested again." : "Accepted: mentions re-link on the next resolution. Read entity_id back to the user."
       };
     }
     return invalid(`unknown action ${String(args.action)}`);
@@ -40357,6 +40357,101 @@ async function knowledgeAgent(config3, args) {
     return mapKnowledgeError(err, config3.apiBase);
   }
 }
+function askFilters(f) {
+  const out = {};
+  for (const name of ["kind", "topic", "person", "place", "category", "author"]) {
+    if (f[name] !== void 0) out[name] = f[name];
+  }
+  const docs = f.doc ?? f.doc_ids;
+  if (docs !== void 0) out.doc_ids = docs;
+  if (f.year !== void 0) {
+    const years = Array.isArray(f.year) ? f.year : [f.year];
+    out.year = years.map((y) => Number(y)).filter((y) => Number.isInteger(y));
+  }
+  return out;
+}
+var SENTINEL_PRE = "\uE000";
+var SENTINEL_POST = "\uE001";
+function plainSnippet(text) {
+  return text.split(SENTINEL_PRE).join("**").split(SENTINEL_POST).join("**");
+}
+async function knowledgeSearch(config3, args) {
+  try {
+    const q = new URLSearchParams();
+    if (args.q) q.set("q", args.q);
+    if (args.kind) q.set("kind", args.kind);
+    for (const [name, values] of [
+      ["topic", args.topic],
+      ["person", args.person],
+      ["place", args.place],
+      ["category", args.category],
+      ["author", args.author],
+      ["year", args.year],
+      ["doc", args.doc]
+    ]) {
+      for (const v of values ?? []) q.append(name, v);
+    }
+    if (args.limit !== void 0) q.set("limit", String(args.limit));
+    if (args.offset !== void 0) q.set("offset", String(args.offset));
+    if (args.include_media) q.set("include", "media");
+    const qs = q.toString();
+    const result = await hubGet(config3, `/api/knowledge/explore${qs ? `?${qs}` : ""}`);
+    const hits = Array.isArray(result.hits) ? result.hits.map((h) => ({
+      ...h,
+      snippet: typeof h.snippet === "string" ? plainSnippet(h.snippet) : h.snippet
+    })) : result.hits;
+    const { highlight: _highlight, ...rest } = result;
+    return {
+      ...rest,
+      hits,
+      note: "Facet counts describe the CURRENT filters; pass repeated facet values to OR within a facet. media URLs (url/poster_url, present with include_media) are presigned and expire in minutes: use them immediately, never store them."
+    };
+  } catch (err) {
+    return mapKnowledgeError(err, config3.apiBase);
+  }
+}
+function mapAgentsError(err, apiBase) {
+  if (err instanceof HubApiError && err.status === 404) {
+    const body = bodyOf(err);
+    if (body && body.error === "not_found") {
+      return { error: "not_found", detail: typeof body.message === "string" ? body.message : "No such agent or resource for this account." };
+    }
+  }
+  return mapKnowledgeError(err, apiBase);
+}
+async function knowledgeAgents(config3, args) {
+  try {
+    if (args.action === "list") {
+      return await hubGet(config3, "/api/knowledge/agents");
+    }
+    if (args.action === "get") {
+      if (!args.agentId) return { error: "agentId is required for get" };
+      return await hubGet(config3, `/api/knowledge/agents/${encodeURIComponent(args.agentId)}`);
+    }
+    if (args.action === "create") {
+      if (args.goal) {
+        const draft = await hubPost(config3, "/api/knowledge/agents/draft", { goal: args.goal });
+        if (!draft.proposal) return { error: "draft_failed", detail: draft };
+        const created = await hubPost(config3, "/api/knowledge/agents", draft.proposal);
+        return { ...created, test_questions: draft.test_questions ?? [], status_note: "Created as a private DRAFT: test it, then publish when the user approves." };
+      }
+      if (!args.name) return { error: "name (or goal) is required for create" };
+      return await hubPost(config3, "/api/knowledge/agents", { name: args.name });
+    }
+    if (args.action === "publish") {
+      if (!args.agentId) return { error: "agentId is required for publish" };
+      const out = await hubPost(config3, `/api/knowledge/agents/${encodeURIComponent(args.agentId)}/publish`, {});
+      return { ...out, status_note: "Live immediately for every key bound to this agent." };
+    }
+    if (!args.agentId || !args.message) return { error: "agentId and message are required for test" };
+    return await hubPost(config3, `/api/knowledge/agents/${encodeURIComponent(args.agentId)}/chat`, {
+      message: args.message,
+      ...args.sessionId ? { session_id: args.sessionId } : {}
+    });
+  } catch (err) {
+    return mapAgentsError(err, config3.apiBase);
+  }
+}
 
 // src/index.ts
 var config2 = null;
@@ -41209,18 +41304,55 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_knowledge_search",
+  {
+    description: "Instant search over the knowledge library with live facet counts: the fastest way to see WHAT is in there and to find the exact video moment, book page, dataset or web section. Returns hits (title, kind, locator like t=612-640 or p.42, snippet with **matched words**, score) plus facets {kind, year, category, author, people, places, topics} whose counts describe the current filters: repeat a facet value to OR within it, combine facets to AND. include_media adds presigned url/poster_url to hits: they expire in minutes, use immediately, never store. Keyword-only and free (no answer quota); for a verified ANSWER use awesomate_knowledge_ask, optionally with the same filters.",
+    inputSchema: {
+      q: external_exports.string().max(2e3).optional().describe("Search words; empty lists the library filtered by the facets"),
+      kind: external_exports.enum(["book", "document", "web", "image", "video", "audio", "post", "dataset"]).optional(),
+      topic: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+      person: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+      place: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+      category: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+      author: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+      year: external_exports.array(external_exports.string().regex(/^\d{4}$/)).max(10).optional(),
+      doc: external_exports.array(external_exports.string().max(200)).max(50).optional().describe("Restrict to these doc_ids (from earlier hits)"),
+      limit: external_exports.number().int().min(1).max(50).optional(),
+      offset: external_exports.number().int().min(0).max(2e3).optional(),
+      include_media: external_exports.boolean().optional().describe("Add presigned url/poster_url to hits; they expire in minutes")
+    }
+  },
+  async (args) => {
+    try {
+      return knowledgeResult(await knowledgeSearch(requireConfig(), args));
+    } catch (err) {
+      return knowledgeError(err);
+    }
+  }
+);
 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'. 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")
+      session: external_exports.string().max(128).optional().describe("Stable id to keep follow-up questions in one conversation thread"),
+      filters: external_exports.object({
+        kind: external_exports.enum(["book", "document", "web", "image", "video", "audio", "post", "dataset"]).optional(),
+        topic: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+        person: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+        place: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+        category: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+        author: external_exports.array(external_exports.string().max(200)).max(10).optional(),
+        year: external_exports.array(external_exports.string().regex(/^\d{4}$/)).max(10).optional(),
+        doc: external_exports.array(external_exports.string().max(200)).max(50).optional().describe("doc_ids from search hits")
+      }).optional().describe("Ask within a slice of the library: EXACTLY the awesomate_knowledge_search input shapes, reusable verbatim; filters only ever narrow")
     }
   },
-  async ({ question, session }) => {
+  async ({ question, session, filters }) => {
     try {
-      return knowledgeResult(await knowledgeAsk(requireConfig(), { question, session }));
+      return knowledgeResult(await knowledgeAsk(requireConfig(), { question, session, filters }));
     } catch (err) {
       return knowledgeError(err);
     }
@@ -41239,7 +41371,7 @@ server.registerTool(
         tone: external_exports.string().max(500).optional()
       }).optional().describe("set only: persona fields to change"),
       no_answer_message: external_exports.string().max(1e3).optional().describe("set only: wording used when the content has no answer"),
-      model_tier: external_exports.enum(["sonnet", "opus"]).optional().describe("set only: opus needs the Embedded plan"),
+      model_tier: external_exports.enum(["flash", "sonnet", "opus"]).optional().describe("set only: flash is the fastest (Gemini Flash, same citation checks), sonnet the thorough default, opus needs the Embedded plan"),
       datasets: external_exports.array(external_exports.string().max(64)).max(16).optional().describe("set only: datasets the agent may answer from")
     }
   },
@@ -41253,6 +41385,27 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_knowledge_agents",
+  {
+    description: "The agent builder (multi-agent; the older awesomate_knowledge_agent tool is the single workspace default). action 'list' \u2014 every agent with status (draft/published vN/suspended). 'get' {agentId} \u2014 full config incl. system message and scope. 'create' {goal} \u2014 AI drafts the whole setup (instructions, scope, tone, test questions) from the account's own content and saves it as a PRIVATE DRAFT (never live, nothing lost); or {name} for a blank draft. 'test' {agentId, message, sessionId?} \u2014 chat with the DRAFT config: free, unmetered, the right way to check behaviour before going live. 'publish' {agentId} \u2014 makes the draft LIVE immediately for every key bound to the agent: get the user's explicit approval first, and read the version back. Editing fields, policies, API keys and the request log live in the hub UI (Knowledge \u2192 Agents); keys are shown once there and never pass through this tool.",
+    inputSchema: {
+      action: external_exports.enum(["list", "get", "create", "publish", "test"]),
+      agentId: external_exports.string().max(64).optional().describe("get/publish/test: agent_id from list"),
+      name: external_exports.string().max(80).optional().describe("create: blank draft with this name"),
+      goal: external_exports.string().max(2e3).optional().describe("create: describe the agent and AI drafts it from the account content"),
+      message: external_exports.string().max(4e3).optional().describe("test: the question to ask the draft"),
+      sessionId: external_exports.string().max(128).optional().describe("test: keep follow-ups in one thread")
+    }
+  },
+  async (args) => {
+    try {
+      return knowledgeResult(await knowledgeAgents(requireConfig(), args));
+    } catch (err) {
+      return knowledgeError(err);
+    }
+  }
+);
 server.registerTool(
   "awesomate_knowledge_people",
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "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",
@@ -32,4 +32,4 @@
     "esbuild": "^0.25.0",
     "typescript": "^6.0.3"
   }
-}
+}

package/skill/awesomate-knowledge/SKILL.md

@@ -52,8 +52,10 @@ platform's answer beats anything you remember.
 | Tenant state, plan gate, consent, quota, packs (CALL FIRST) | `awesomate_knowledge_status` |
 | Enable the knowledge base (idempotent; 202 = keep polling status) | `awesomate_knowledge_provision` |
 | Sources list / add url·sitemap / remove / ingest jobs | `awesomate_knowledge_sources` |
-| Ask a question → verified answer + numbered sources | `awesomate_knowledge_ask` |
-| Agent persona / fallback message / model tier — get & set | `awesomate_knowledge_agent` |
+| 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` |
+| Agent BUILDER: list / get / create (AI-drafted from their content, saved as a private draft) / test the draft / publish (explicit approval first) | `awesomate_knowledge_agents` |
 | People, places, topics: list / name / hide / merge / alias suggestions / re-run resolution | `awesomate_knowledge_people` |
 | Refresh these skills from the latest package | `awesomate_skill_update` |