@ateam-ai/mcp 0.4.17 → 0.4.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ateam-ai/mcp",
-  "version": "0.4.17",
+  "version": "0.4.19",
   "mcpName": "io.github.ariekogan/ateam-mcp",
   "description": "A-Team MCP Server — build, validate, and deploy multi-agent solutions from any AI environment",
   "type": "module",

package/src/api.js

@@ -393,7 +393,7 @@ function headers(sessionId) {
 /**
  * Format an API error into a user-friendly message with actionable hints.
  */
-function formatError(method, path, status, body) {
+function formatError(method, path, status, body, baseUrl) {
   const hints = {
     400: "Bad request — see the error details above for what to fix.",
     401: "Your API key may be invalid or expired. Get a valid key at https://mcp.ateam-ai.com/get-api-key then call ateam_auth(api_key: \"your_key\").",
@@ -434,7 +434,12 @@ function formatError(method, path, status, body) {
   const hint = hints[status] || "";
   const detail = typeof body === "string" && body.length > 0 && body.length < 2000 ? body : "";
 
-  let msg = `A-Team API error: ${method} ${path} returned ${status}`;
+  // Always show the FULL URL actually hit — ateam-mcp is a PUBLIC MCP with a
+  // configurable base (prod default, dev/self-host overrides), so a bare
+  // "POST /deploy/..." 404 is ambiguous: is the route missing, or did the
+  // request go to the wrong base? The full URL disambiguates instantly.
+  const target = baseUrl ? `${baseUrl}${path}` : path;
+  let msg = `A-Team API error: ${method} ${target} returned ${status}`;
   if (detail) msg += ` — ${detail}`;
   if (hint) msg += `\nHint: ${hint}`;
 
@@ -486,7 +491,7 @@ async function request(method, path, body, sessionId, opts = {}) {
 
       if (!res.ok) {
         const text = await res.text().catch(() => "");
-        throw new Error(formatError(method, path, res.status, text));
+        throw new Error(formatError(method, path, res.status, text, baseUrl));
       }
 
       return res.json();

package/src/tools.js

@@ -362,6 +362,26 @@ export const tools = [
       required: ["type"],
     },
   },
+  {
+    name: "ateam_design_advisor",
+    core: true,
+    description:
+      "CONSULT THIS DURING DESIGN — before and while you design a skill/solution. Describe what you're building; it returns POINTERS to the platform capabilities that fit (per-actor storage, widgets, triggers, sub-agents, mobile data, run-scripts, multi-skill, GitHub, …), each with the /spec topic to read next (via ateam_get_spec) and the tool to wire it. Also returns 'missing' hints (capabilities your goal implies but the design hasn't wired) and lifecycle hints (e.g. connect GitHub when the project will iterate). ADVISORY ONLY — you decide and own the design. Stateless: pass the current design_state each call; consult it as often as you like as the design evolves.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        goal: {
+          type: "string",
+          description: "What you're trying to build, in your own words (e.g. 'a coach that tracks each user's meals from photos and shows a dashboard').",
+        },
+        design_state: {
+          type: "object",
+          description: "Optional. The design so far (skills, connectors, capabilities already wired) so the advisor can point at what's still missing. Pass {} at the start.",
+        },
+      },
+      required: ["goal"],
+    },
+  },
   {
     name: "ateam_build_and_run",
     core: true,
@@ -2181,10 +2201,10 @@ export default {
   // ui.listPlugins is generated from ui-dist/<plugin>/manifest.json pick it up
   // automatically, and for connectors with a HARDCODED plugin list (e.g.
   // personal-assistant-ui-mcp) copy this render block into their ui.getPlugin.
-  const mode = k === "iframe" ? "iframe" : k === "rn" ? "react-native" : "adaptive";
+  const mode = kind === "iframe" ? "iframe" : kind === "rn" ? "react-native" : "adaptive";
   const render = { mode };
-  if (k === "iframe" || k === "adaptive") render.iframeUrl = `/ui/${pluginName}/index.html`;
-  if (k === "rn" || k === "adaptive") render.reactNative = { component: pluginName };
+  if (kind === "iframe" || kind === "adaptive") render.iframeUrl = `/ui/${pluginName}/index.html`;
+  if (kind === "rn" || kind === "adaptive") render.reactNative = { component: pluginName };
   const prettyName = pluginName.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
   files.push({
     path: `ui-dist/${pluginName}/manifest.json`,
@@ -2209,6 +2229,10 @@ const handlers = {
       category: "AI Team Solution Platform",
       summary: "A-Team is a platform for building governed AI Teams as complete operational solutions.",
     },
+    design_advisor: {
+      _important: "BEFORE and WHILE you design any skill/solution you MUST consult ateam_design_advisor. You do NOT know which platform capabilities exist or when to use them — the advisor does. Describe your goal to it and it returns pointers to the right capabilities (per-actor storage, widgets, triggers, sub-agents, mobile data, run-scripts, multi-skill handoff, GitHub, …) with the /spec topic to read next and the tool to wire each. It's advisory — you decide and own the design — but skipping it means you'll miss capabilities the platform already provides.",
+      how: "ateam_design_advisor({ goal: '<what you are building, in your words>', design_state: {} }). Re-call it as the design evolves (pass the current design_state) to get 'what's still missing' hints. Then ateam_get_spec(topic) for any capability it points you to.",
+    },
     what_is_a_team: {
       definition: "A Team is a structured multi-role AI system composed of Skills, Connectors, Governance contracts, and Managed Runtime deployment.",
       core_components: {
@@ -2568,6 +2592,14 @@ const handlers = {
 
   ateam_get_examples: async ({ type }, sid) => get(EXAMPLE_PATHS[type], sid),
 
+  // Design-time capability advisor. Proxies to the Builder's /spec/advisor
+  // (LLM over the curated capability catalog). Public endpoint (auth-exempt),
+  // but we forward the session so a base override is honored.
+  ateam_design_advisor: async ({ goal, design_state }, sid) => {
+    if (!goal || typeof goal !== "string") throw new Error("goal required (a string describing what you're building)");
+    return post("/spec/advisor", { goal, design_state: design_state || {} }, sid, { timeoutMs: 90_000, retries: 1 });
+  },
+
   // ─── Composite: Build & Run ────────────────────────────────────────
   // Validates → Deploys → Health-checks → Optionally tests
   // One call replaces: validate_solution + deploy_solution + get_solution(health)