@awesomate/hosting-mcp 0.46.0 → 0.48.0

package/dist/index.js

@@ -40136,6 +40136,25 @@ function packConfirmationPayload(body) {
     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 addonRequiredPayload(body) {
+  return {
+    addon_required: true,
+    purchased: false,
+    dimension: body.dimension ?? null,
+    addon: body.addon ?? null,
+    message: typeof body.message === "string" ? body.message : null,
+    note: "This is over the account's allowance, and the way past it is a monthly add-on billed to their card every month until they stop it. NOTHING was bought and the source was NOT added. Relay the message as it is, and if they want the add-on, send the owner to the hub Knowledge \u2192 Usage page to add it (this tool never buys it). Removing sources they no longer need also works."
+  };
+}
+function storageFullPayload(body) {
+  return {
+    storage_full: true,
+    purchased: false,
+    reason: body.reason ?? null,
+    message: typeof body.message === "string" ? body.message : null,
+    note: "The Knowledge Base storage is full and the source was NOT added. Relay the message exactly as it is; offer no purchase, because none is open to this account or this person right now. Removing sources they no longer need frees space."
+  };
+}
 function bodyOf(err) {
   return err.body && typeof err.body === "object" ? err.body : null;
 }
@@ -40148,6 +40167,8 @@ function mapKnowledgeError(err, apiBase) {
     return consentPayload(typeof body.error === "string" ? body.error : "Knowledge Platform consent is off");
   }
   if (err.status === 402 && body?.error === "pack_required") return packConfirmationPayload(body);
+  if (err.status === 402 && body?.error === "addon_required") return addonRequiredPayload(body);
+  if (err.status === 402 && body?.error === "storage_full") return storageFullPayload(body);
   throw err;
 }
 async function knowledgeStatus(config3) {
@@ -41195,6 +41216,7 @@ var TITLES = {
   awesomate_crm_recipes: "Save named write recipes",
   awesomate_crm_apps: "Set up sign-in for your own apps",
   awesomate_crm_app_users: "Manage the people who sign in to your apps",
+  awesomate_crm_assistant: "Set up the AI in your app's conversations",
   awesomate_crm_email: "Draft an email to a contact list"
 };
 function annotate(name, kind) {
@@ -41883,23 +41905,13 @@ readTool(
   "Usage vs plan limits across every dimension (sites, custom domains, apps, database provisions today, workflow credits, AI-editor credits) plus a nudges[] array. Call BEFORE any create action; when a nudge has severity 'approaching' or 'exceeded', surface it to the user with the recommended plan \u2014 never execute an upgrade without preview + explicit confirmation (upgrade tools ship in a later release; for now deep-link to the hub billing page). pgProvisionsToday is a flat daily cap that resets within 24h \u2014 no plan raises it, so don't pitch an upgrade for it.",
   "/api/client-hosting/limits"
 );
-var KNOWLEDGE_NOT_INCLUDED = {
-  included: false,
-  onboardingMediaHours: 0,
-  onboardingPages: 0,
-  onboardingUrls: 0,
-  monthlyMediaHours: 0,
-  monthlyAnswers: 0,
-  maxStorageGb: 0,
-  agentModelTier: "sonnet"
-};
 var PLAN_LADDER_FALLBACK = {
-  note: "Live per-account limits come from awesomate_get_limits \u2014 this is the plan ladder reference (static fallback).",
+  note: "Live per-account limits come from awesomate_get_limits. This is the plan ladder reference (static fallback).",
   plans: [
-    { name: "Essentials", purchasable: false, monthlyPriceUsd: 75, maxSites: 1, maxCustomDomains: 1, maxApps: 0, cpanelAccess: true, shellAccess: false, appBuilder: false, knowledgeBase: KNOWLEDGE_NOT_INCLUDED },
-    { name: "Support Plus", purchasable: true, monthlyPriceUsd: 175, maxSites: 2, maxCustomDomains: 5, maxApps: 5, cpanelAccess: true, shellAccess: true, appBuilder: true, knowledgeBase: KNOWLEDGE_NOT_INCLUDED },
-    { name: "Pro", purchasable: true, monthlyPriceUsd: 375, maxSites: 10, maxCustomDomains: 20, maxApps: 20, cpanelAccess: true, shellAccess: true, appBuilder: true, knowledgeBase: { included: true, onboardingMediaHours: 10, onboardingPages: 2e3, onboardingUrls: 500, monthlyMediaHours: 5, monthlyAnswers: 1e3, maxStorageGb: 10, agentModelTier: "sonnet" } },
-    { name: "Embedded", purchasable: false, monthlyPriceUsd: null, maxSites: 100, maxCustomDomains: 100, maxApps: 100, cpanelAccess: true, shellAccess: true, appBuilder: true, knowledgeBase: { included: true, onboardingMediaHours: 50, onboardingPages: 1e4, onboardingUrls: 2500, monthlyMediaHours: 20, monthlyAnswers: 1e4, maxStorageGb: 50, agentModelTier: "opus" }, note: "Not generally available yet" }
+    { name: "Essentials", purchasable: false, monthlyPriceUsd: 75, maxSites: 1, maxCustomDomains: 1, maxApps: 0, cpanelAccess: true, shellAccess: false, appBuilder: false, knowledgeBase: { included: true, onboardingMediaHours: 0, onboardingPages: 50, onboardingUrls: 10, monthlyMediaHours: 0, monthlyAnswers: 50, maxStorageGb: 5, agentModelTier: "sonnet" } },
+    { name: "Support Plus", purchasable: true, monthlyPriceUsd: 175, maxSites: 2, maxCustomDomains: 5, maxApps: 5, cpanelAccess: true, shellAccess: true, appBuilder: true, knowledgeBase: { included: true, onboardingMediaHours: 5, onboardingPages: 1e3, onboardingUrls: 250, monthlyMediaHours: 2, monthlyAnswers: 500, maxStorageGb: 250, agentModelTier: "sonnet" } },
+    { name: "Pro", purchasable: true, monthlyPriceUsd: 375, maxSites: 10, maxCustomDomains: 20, maxApps: 20, cpanelAccess: true, shellAccess: true, appBuilder: true, knowledgeBase: { included: true, onboardingMediaHours: 10, onboardingPages: 2e3, onboardingUrls: 500, monthlyMediaHours: 5, monthlyAnswers: 1e3, maxStorageGb: 1024, agentModelTier: "sonnet" } },
+    { name: "Embedded", purchasable: false, monthlyPriceUsd: null, maxSites: 100, maxCustomDomains: 100, maxApps: 100, cpanelAccess: true, shellAccess: true, appBuilder: true, knowledgeBase: { included: true, onboardingMediaHours: 50, onboardingPages: 1e4, onboardingUrls: 2500, monthlyMediaHours: 20, monthlyAnswers: 1e4, maxStorageGb: 1024, agentModelTier: "opus" }, note: "Not generally available yet" }
   ],
   upgradePath: "Essentials \u2192 Support Plus \u2192 Pro \u2192 Embedded; upgrades at hub.awesomate.ai/billing (only Support Plus and Pro are purchasable)"
 };
@@ -42928,6 +42940,44 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_crm_assistant",
+  {
+    annotations: annotate("awesomate_crm_assistant", MUTATING),
+    description: "An AI participant in an app's conversations (a portal's per-job messages): when a signed-in customer writes, it answers from what that customer may see plus the account's own Knowledge Base, or drafts an answer for staff. Each conversation has a mode staff switch: off (people only, the default), draft (a suggested reply only staff see, sent by a person as themselves) or auto (it replies at once under its own name, marked as AI, when its gate allows; otherwise it drafts). It reads AS the customer, so the account's access rules bound it, and only attributes marked readable_by_ai reach it. The hub writes its replies, never the model. Pro and above to change; reading is every plan. action 'get' {app_id}. action 'set' {app_id, assistant}: assistant is {name, thread_link (the message kind's link to the job/booking), instructions?, knowledge_agent_id? (a PUBLISHED agent from awesomate_knowledge_agents, audience public), default_mode? (off), message_kind? (message), body_attribute? (body), settings_kind? (assistant_thread), drafts_kind? (assistant_draft), staff_roles? ([owner, staff]), daily_cap? (200), enabled?}. The tenant must already hold: the message kind with the body attribute marked readable_by_ai, a yes/no from_assistant attribute and the thread link; a settings kind {mode: choice off|draft|auto, needs_person?: yes_no} and a drafts kind {body, why?}, both linked to the same thread kind and readable by staff only (set_access). Saving an enabled assistant is refused with every problem listed; fix them with awesomate_crm_kinds and save again. action 'runs' {app_id, limit?}: what it decided per customer message (send, draft, handoff, skip, error) and why, by reference only. Confirm the name, the default mode and the knowledge agent with the user before 'set': switching it on lets an AI reply to their customers.",
+    inputSchema: {
+      action: external_exports.enum(["get", "set", "runs"]),
+      app_id: external_exports.string().max(48).describe("the app, from awesomate_crm_apps list"),
+      assistant: external_exports.object({
+        name: external_exports.string().max(40),
+        thread_link: external_exports.string().max(41),
+        instructions: external_exports.string().max(4e3).optional(),
+        knowledge_agent_id: external_exports.string().max(64).nullable().optional(),
+        default_mode: external_exports.enum(["off", "draft", "auto"]).optional(),
+        message_kind: external_exports.string().max(41).optional(),
+        body_attribute: external_exports.string().max(41).optional(),
+        settings_kind: external_exports.string().max(41).optional(),
+        drafts_kind: external_exports.string().max(41).optional(),
+        staff_roles: external_exports.array(external_exports.string().max(31)).max(10).optional(),
+        daily_cap: external_exports.number().int().min(1).max(1e3).optional(),
+        enabled: external_exports.boolean().optional()
+      }).optional().describe("set: the whole config; fields left out take their defaults"),
+      limit: external_exports.number().int().min(1).max(200).optional().describe("runs: how many, newest first (default 50)")
+    }
+  },
+  async ({ action, app_id, assistant, limit }) => {
+    try {
+      const cfg = requireConfig();
+      const path = `/api/my-crm/v1/apps/${encodeURIComponent(app_id)}/assistant`;
+      if (action === "get") return textResult(await hubGet(cfg, path));
+      if (action === "runs") return textResult(await hubGet(cfg, `${path}/runs${limit ? `?limit=${limit}` : ""}`));
+      if (!assistant) return errorResult(new Error("set needs assistant: {name, thread_link, ...}."));
+      return textResult(await hubPut(cfg, path, { assistant }));
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
 var crmParam = external_exports.object({
   name: external_exports.string().max(41).describe("lower_case"),
   type: external_exports.enum(["text", "number", "date", "datetime", "boolean", "uuid", "text_list", "number_list"]).optional().describe("default text"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.46.0",
+  "version": "0.48.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/CHANGELOG.json

@@ -1,5 +1,21 @@
 {
   "versions": [
+    {
+      "version": "0.48.0",
+      "highlights": [
+        "Knowledge Base answers are now a hard limit: when a month's answers run out, your assistants stop answering until the 1st, and you are emailed at 80% and again at the limit",
+        "Past the limit: an answer pack adds 2,500 answers for the rest of the month (1 credit), or the monthly answers add-on adds 2,500 every month for $100 a month, stop anytime. Support Plus and above",
+        "A full library on Support Plus and up now points at the monthly storage add-on (1 TB for $100 a month) instead of a storage pack, and Claude relays it without ever buying it"
+      ]
+    },
+    {
+      "version": "0.47.0",
+      "highlights": [
+        "Your app's conversations can have an AI in them (awesomate_crm_assistant). When a customer writes, it answers from their own records and your Knowledge Base, or drafts an answer for your team. Pro and above",
+        "Your team decides per conversation: off, draft (a suggested reply only staff see, sent by a person as themselves) or auto (it replies at once, marked as AI). New conversations start off unless you choose otherwise",
+        "It reads as the customer it is answering, so your access rules bound it, and it sees only the fields you marked readable by AI. When someone asks for a person, it hands the conversation over and flags it"
+      ]
+    },
     {
       "version": "0.46.0",
       "highlights": [

package/skill/awesomate-knowledge/references/quotas-and-packs.md

@@ -1,26 +1,40 @@
 # Quotas, allowances, and Ingestion Packs
 
 Live numbers ALWAYS come from `awesomate_knowledge_status` (`usage` vs
-`usage.included` + `usage.packs`) — this file explains the model.
+`usage.included` + `usage.packs`). This file explains the model.
 
 ## Plan allowances
 
-| | Pro | Embedded |
-|---|---|---|
-| Included | yes | yes |
-| Onboarding (first month, one-off) | 10 media-hours, 2,000 pages / 500 URLs | 50 media-hours, 10,000 pages / 2,500 URLs |
-| Monthly media ingest | 5 hours | 20 hours |
-| Monthly verified answers | 1,000 | 10,000 |
-| Storage | 10 GB | 50 GB |
-| Agent model tier | sonnet | opus-eligible |
+Every plan includes the Knowledge Base. The NUMBERS (pages, answers a month,
+storage, business data) are not written here on purpose: they change as we learn
+real usage. Read them from `awesomate_knowledge_status` (`usage.included`), or
+from `awesomate_get_plan_features` for another plan.
 
-Essentials and Support Plus don't include Knowledge Base — status returns
-`upgrade_required` with the upsell copy; relay it once, honestly.
+| | Essentials | Support Plus | Pro |
+|---|---|---|---|
+| What it is for | Trying it out: your FAQs and an agent that answers from them | Day-to-day use | Everything, at the highest usage |
+| FAQs | Yes | Yes | Yes |
+| Documents, spreadsheets, web pages, pasted text | A small allowance | More | The most |
+| Website chat widget, unanswered-questions inbox | No | Yes | Yes |
+| Audio and video, scanned documents and images | No | No | Yes |
+| Ingestion Packs (below) | No: the answer is an upgrade | Yes | Yes |
+
+FAQ entries don't use up the page allowance. When an Essentials client outgrows
+it, say so plainly and point to Support Plus or Pro at hub.awesomate.ai/billing;
+never offer a pack, since Essentials cannot buy one.
 
 ## Ingestion Packs (overage)
 
 One pack = **1 credit ($100)**, the user picks the dimension at purchase:
-+40 media-hours OR +5,000 pages OR +2,500 answers OR +50 GB-months.
++40 media-hours OR +5,000 pages OR +2,500 answers. The storage pack is no
+longer sold (packs already held still count): extra storage is the monthly
+storage add-on, 1 TB for $100 a month, which the owner adds on the hub's
+Knowledge → Usage page. A full library on Support Plus and up answers 402
+`addon_required` with the add-on's details when the owner can buy it, or 402
+`storage_full` with a sentence when they can't (in a trial, at the cap, or
+not the owner). Relay either one as it is; never buy anything.
+An answers pack counts only for the calendar month (UTC) it is bought in, so
+buying one late in the month buys less; say so before they confirm.
 
 - An ingest that would exceed included+packs returns `pack_required`. The
   tool response purchases NOTHING and queues NOTHING.
@@ -31,8 +45,25 @@ One pack = **1 credit ($100)**, the user picks the dimension at purchase:
 - Insufficient credits → 402 `insufficient_credits`: top up from Billing
   first. Never loop on it.
 
-## Answer overage
+## Answer limit
+
+Answers are a hard stop. The allowance is the plan's monthly answers plus
+every answer pack held. When it is used up, every answer route (widget, agent
+chat, n8n, `ask`) returns 429 `quota_exceeded` until the 1st of next month
+(UTC), and a visitor sees "This assistant has reached its limit for this
+month". Answers on the client's own OpenRouter key never count.
 
-Answers are soft-gated: warnings at 100% of allowance, throttling well past
-it — chat never silently debits credits. If a client consistently outgrows
-the allowance, that's an upgrade/pack conversation, not a workaround.
+- The owner is emailed at 80% and again when the limit is reached.
+- Nothing ever debits credits on its own. The ways past the limit, all applied
+  straight away:
+  - an answer pack: 2,500 for the rest of this month, 1 credit, via the pack
+    flow above;
+  - the monthly answers add-on: 2,500 more answers in every month it runs,
+    $100 a month on the card, stop anytime (the paid month runs out). The
+    owner adds it on the hub's Knowledge → Usage page. Don't buy it from here;
+  - an upgrade.
+  Packs and the add-on are Support Plus and above, so for Essentials it's the
+  upgrade.
+- If a 429 `quota_exceeded` comes back from `ask` or a test chat, say so
+  plainly and offer those two routes. Don't retry: nothing changes until the
+  month turns or the allowance rises.