@awesomate/hosting-mcp 0.25.0 → 0.27.0

package/dist/index.js

@@ -40083,7 +40083,22 @@ var KNOWLEDGE_GATE_COPY = {
     "Hosted in Sydney, isolated to your account, and gone the moment you delete it"
   ]
 };
-function upsellPayload(apiBase, plan) {
+function upsellPayload(apiBase, plan, body) {
+  const capability = typeof body?.capability === "string" ? body.capability : null;
+  const requiredPlan = typeof body?.requiredPlan === "string" ? body.requiredPlan : KNOWLEDGE_GATE_COPY.requiredPlan;
+  const message = typeof body?.message === "string" ? body.message : null;
+  if (capability && message) {
+    return {
+      upgrade_required: true,
+      capability,
+      requiredPlan,
+      ...typeof plan === "string" ? { plan } : {},
+      ...typeof body?.dimension === "string" ? { dimension: body.dimension } : {},
+      message,
+      billingUrl: `${apiBase}/billing?upgrade=${encodeURIComponent(requiredPlan)}`,
+      note: capability === "knowledge_packs" ? `The included allowance is used up and this plan cannot buy Ingestion Packs (they start at ${requiredPlan}). NOTHING was added or purchased. Say so plainly, share the billing link, and let the user decide; never retry.` : `This kind of content needs ${requiredPlan} or above. NOTHING was added. Relay the message honestly, share the billing link, and let the user decide; never retry.`
+    };
+  }
   return {
     upgrade_required: true,
     ...typeof plan === "string" ? { plan } : {},
@@ -40124,7 +40139,7 @@ function mapKnowledgeError(err, apiBase) {
   if (!(err instanceof HubApiError)) throw err;
   const body = bodyOf(err);
   if (err.status === 404) return notAvailablePayload(apiBase);
-  if (err.status === 403 && body?.upgrade_required) return upsellPayload(apiBase, body.plan);
+  if ((err.status === 403 || err.status === 402) && body?.upgrade_required) return upsellPayload(apiBase, body.plan, body);
   if (err.status === 403 && body?.consent_required) {
     return consentPayload(typeof body.error === "string" ? body.error : "Knowledge Platform consent is off");
   }
@@ -40633,6 +40648,40 @@ async function knowledgeSearch(config3, args) {
     return mapKnowledgeError(err, config3.apiBase);
   }
 }
+function touchesScope(args) {
+  return Boolean(args.collectionIds || args.kinds || args.sourceIds);
+}
+var SCOPE_KEYS = ["source_ids", "tags", "datasets", "kinds", "data_sets", "allow_media", "allow_data"];
+function agentPatchBody(args, currentScope = {}) {
+  let scope;
+  if (touchesScope(args)) {
+    const kept = {};
+    for (const k of SCOPE_KEYS) if (currentScope[k] !== void 0) kept[k] = currentScope[k];
+    const currentTags = Array.isArray(kept.tags) ? kept.tags.filter((t) => typeof t === "string") : [];
+    scope = {
+      ...kept,
+      ...args.collectionIds ? { tags: [...currentTags.filter((t) => !t.startsWith("collection:")), ...args.collectionIds.map((id) => `collection:${id}`)] } : {},
+      ...args.kinds ? { kinds: args.kinds } : {},
+      ...args.sourceIds ? { source_ids: args.sourceIds } : {}
+    };
+  }
+  return {
+    ...args.name ? { name: args.name } : {},
+    ...args.description !== void 0 ? { description: args.description } : {},
+    ...args.systemMessage !== void 0 ? { system_message: args.systemMessage } : {},
+    ...args.noAnswerMessage !== void 0 ? { no_answer_message: args.noAnswerMessage } : {},
+    ...args.grounding ? { grounding: args.grounding } : {},
+    ...args.audience ? { audience: args.audience } : {},
+    ...args.maxSources !== void 0 ? { max_sources: args.maxSources } : {},
+    ...args.temperature !== void 0 ? { temperature: args.temperature } : {},
+    ...scope ? { scope } : {}
+  };
+}
+async function currentAgentScope(config3, agentId) {
+  const got = await hubGet(config3, `/api/knowledge/agents/${encodeURIComponent(agentId)}`);
+  const scope = got.agent?.scope ?? got.scope;
+  return scope && typeof scope === "object" && !Array.isArray(scope) ? scope : {};
+}
 function mapAgentsError(err, apiBase) {
   if (err instanceof HubApiError && err.status === 404) {
     const body = bodyOf(err);
@@ -40662,6 +40711,23 @@ async function knowledgeAgents(config3, args) {
       if (!args.name) return { error: "name (or goal) is required for create" };
       return await hubPost(config3, "/api/knowledge/agents", { name: args.name, ...args.audience ? { audience: args.audience } : {} });
     }
+    if (args.action === "update") {
+      if (!args.agentId) return { error: "agentId is required for update" };
+      const currentScope = touchesScope(args) ? await currentAgentScope(config3, args.agentId) : {};
+      const body = agentPatchBody(args, currentScope);
+      if (!Object.keys(body).length) {
+        return {
+          error: "invalid_request",
+          note: "update needs at least one of name, description, systemMessage, noAnswerMessage, grounding, audience, collectionIds, kinds, sourceIds, maxSources, temperature"
+        };
+      }
+      const out = await hubPatch(config3, `/api/knowledge/agents/${encodeURIComponent(args.agentId)}`, body);
+      return {
+        ...out,
+        requested: body,
+        status_note: "Draft updated. A published agent keeps serving its last published version until you publish again: test the draft, then publish when the user approves."
+      };
+    }
     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`, {});
@@ -40903,6 +40969,7 @@ var TITLES = {
   awesomate_app_scaffold: "Get app scaffold guide",
   awesomate_app_deploy_info: "Get app deploy briefing",
   awesomate_app_health: "Check app health",
+  awesomate_app_run_state: "Start or stop an app environment",
   awesomate_app_set_env: "Set app secret",
   awesomate_app_provision_db: "Add database to app",
   awesomate_n8n_workflows: "List n8n workflows",
@@ -41737,6 +41804,27 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_app_run_state",
+  {
+    annotations: annotate("awesomate_app_run_state", MUTATING),
+    description: "Start or stop ONE environment of a Node app (its pm2 process). Use `stopped` to turn off a dev or staging environment the user has finished with. This frees process capacity on their hosting account, which is a real constraint: the account has a fixed number of processes it can run at once, and idle environments can starve the account's own websites. Use `running` to bring one back before you build or test on it. Stopping deletes NOTHING: code, database and address all stay, and starting again takes seconds. PRODUCTION CANNOT BE STOPPED (400 `prod_not_stoppable`); it is the address the user's customers reach. A 409 `run_state_failed` on a start means the account has no spare capacity, and the response carries nprocUsed/nprocLimit; tell the user which environment to stop rather than retrying. Static sites have no process (400 `static_app`). Requires apps:write (Support Plus+). Good habit: start dev before a build session, stop it after.",
+    inputSchema: {
+      appId: external_exports.number().int().positive().describe("The app id from awesomate_app_list / _get"),
+      env: external_exports.enum(["dev", "staging", "prod"]).describe("Which environment to act on"),
+      desiredState: external_exports.enum(["running", "stopped"]).describe("'stopped' frees capacity; 'running' starts it again")
+    }
+  },
+  async ({ appId, env, desiredState }) => {
+    try {
+      return textResult(
+        await hubPost(requireConfig(), `/api/my-apps/apps/${appId}/envs/${env}/run-state`, { desiredState })
+      );
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
 server.registerTool(
   "awesomate_n8n_provision_pg",
   {
@@ -41927,13 +42015,22 @@ server.registerTool(
   "awesomate_knowledge_agents",
   {
     annotations: annotate("awesomate_knowledge_agents", MUTATING),
-    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.",
+    description: "The agent builder (multi-agent; the older awesomate_knowledge_agent tool is the single workspace default). action 'list': every agent with status (draft/published vN/suspended). 'get' {agentId}: full config incl. system message and scope. 'create' {goal}: 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. 'update' {agentId, ...fields}: edit the DRAFT config: name, description, systemMessage, noAnswerMessage, grounding, audience, collectionIds (scope to collections from awesomate_knowledge_collections), kinds, sourceIds, maxSources, temperature. Nothing changes for callers until 'publish'. 'test' {agentId, message, sessionId?}: chat with the DRAFT config: free, unmetered, the right way to check behaviour before going live. 'publish' {agentId}: makes the draft LIVE immediately for every key bound to the agent: get the user's explicit approval first, and read the version back. 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"),
+      action: external_exports.enum(["list", "get", "create", "update", "publish", "test"]),
+      agentId: external_exports.string().max(64).optional().describe("get/update/publish/test: agent_id from list"),
+      name: external_exports.string().max(80).optional().describe("create: blank draft with this name; update: rename"),
       goal: external_exports.string().max(2e3).optional().describe("create: describe the agent and AI drafts it from the account content"),
-      audience: external_exports.enum(["private", "internal", "public"]).optional().describe("create: who the agent serves \u2014 'public' for anything customers or a website will talk to (it then answers from sources marked public ONLY), 'internal' for the team, 'private' (default) for the owner's own tools. Widening later is a publish, so choose now."),
+      audience: external_exports.enum(["private", "internal", "public"]).optional().describe("create/update: who the agent serves: 'public' for anything customers or a website will talk to (it then answers from sources marked public ONLY), 'internal' for the team, 'private' (default) for the owner's own tools. Widening later is a publish, so choose now."),
+      description: external_exports.string().max(300).optional().describe("update: one-line description shown in the hub"),
+      systemMessage: external_exports.string().max(8e3).optional().describe("update: the agent instructions (system message)"),
+      noAnswerMessage: external_exports.string().max(500).optional().describe("update: what the agent says when the grounding gate declines to answer"),
+      grounding: external_exports.enum(["strict", "grounded_chat"]).optional().describe("update: 'strict' refuses anything not in the retrieved content (use it for anything customer-facing); 'grounded_chat' may add general knowledge around the cited content"),
+      collectionIds: external_exports.array(external_exports.string().max(64)).max(16).optional().describe("update: scope the agent to these collections (collection_id from awesomate_knowledge_collections list); replaces the collection scope only, other scope fields and free-form tags are kept"),
+      kinds: external_exports.array(external_exports.string().max(40)).max(16).optional().describe("update: restrict retrieval to source kinds (web, document, video, audio, image, book, dataset); omit for all kinds"),
+      sourceIds: external_exports.array(external_exports.string().max(200)).max(500).optional().describe("update: pin the scope to specific sources"),
+      maxSources: external_exports.number().int().min(1).max(10).optional().describe("update: how many sources one answer may cite (1-10)"),
+      temperature: external_exports.number().min(0).max(1).optional().describe("update: 0 is the most literal"),
       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")
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.25.0",
+  "version": "0.27.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-app-builder/SKILL.md

@@ -140,6 +140,14 @@ target; never touch prod without an explicit ask.**
    addresses from `awesomate_app_get` rather than constructing them — an
    account without the branded domains falls back to subdomains of its own
    primary domain (`dev-{app}.{domain}`).
+   **If dev is stopped, start it before you deploy to it.** `awesomate_app_get`
+   reports each environment's `desired_state`. A stopped environment is off to
+   free capacity on the account, not broken. `awesomate_app_run_state` with
+   `running` brings it back in seconds, and a health probe against a stopped
+   env fails for that reason and no other. **Offer to stop it again when the
+   session's work is done**: the account can only run a limited number of app
+   processes at once, so an idle dev environment is capacity taken from
+   something the user actually needs. Never stop `prod`; the tool refuses it.
    **Publishing to their WordPress site** (as opposed to an app) has its own
    tools, and `awesomate_run_wp_cli` is the wrong one for content: its
    argument gate rejects spaces outright, so a title or tagline can't go

package/skill/awesomate-knowledge/SKILL.md

@@ -64,7 +64,7 @@ platform's answer beats anything you remember.
 | 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; pass `audience:'public'` for anything customers will talk to — it then answers from sources marked public ONLY) / test the draft / publish (explicit approval first) | `awesomate_knowledge_agents` |
+| Agent BUILDER: list / get / create (AI-drafted from their content, saved as a private draft; pass `audience:'public'` for anything customers will talk to; it then answers from sources marked public ONLY) / update (edit the draft's instructions, grounding, no-answer message, audience and collection scope; nothing changes for callers until publish) / 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` |
 | Business-data warehouse: `metrics` / `datasets` / `query` / `imports` — answer quantitative questions from their own imported business data (query is free-form but read-only) | `awesomate_knowledge_data` |
 | Refresh these skills from the latest package | `awesomate_skill_update` |