@awesomate/hosting-mcp 0.46.0 → 0.47.0

package/dist/index.js

@@ -41195,6 +41195,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 +41884,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 +42919,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.47.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,13 @@
 {
   "versions": [
+    {
+      "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,21 +1,27 @@
 # 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)
 
@@ -31,8 +37,18 @@ 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
-
-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.
+## 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.
+
+- The owner is emailed at 80% and again when the limit is reached.
+- Nothing ever debits credits on its own. The way past the limit is an answer
+  pack (Support Plus and above, the pack flow above, applied straight away) or
+  an upgrade. Essentials cannot buy packs, so for them 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.