@ateam-ai/mcp 0.4.57 → 0.4.59

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ateam-ai/mcp",
-  "version": "0.4.57",
+  "version": "0.4.59",
   "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

@@ -460,7 +460,16 @@ function formatError(method, path, status, body, baseUrl) {
     ].join("\n");
   }
 
-  const hint = hints[status] || "";
+  // A GENERIC HINT MUST NOT CONTRADICT A SPECIFIC ONE. When the body already
+  // carries its own `code` + `hint`, the endpoint has diagnosed the failure
+  // precisely — appending the status-level guess produces two hints pointing
+  // opposite ways, and the reader follows the wrong one. Observed 2026-08-21
+  // (job_aehopl8z): a patch whose search string did not match came back with
+  // the endpoint's correct "re-read the file and copy the exact bytes"
+  // followed by "Check the solution_id … use ateam_list_solutions", and the
+  // agent went hunting for a missing solution three times.
+  const hasSpecificHint = /"code"\s*:/.test(bodyStr) && /"hint"\s*:/.test(bodyStr);
+  const hint = hasSpecificHint ? "" : (hints[status] || "");
   // A JSON error body used to be dropped entirely — only a string body became
   // `detail`. So an endpoint that answers 4xx WITH the diagnosis (ui.surfaceProbe
   // returns 422 + the failures that explain why the surface is broken) reached

package/src/tools.js

@@ -512,6 +512,19 @@ export const tools = [
   {
     name: "ateam_design_advisor",
     core: true,
+    // MEASURED, not estimated. 6 successful calls against dev on 2026-08-21,
+    // distinct goals, spaced to avoid provider rate-limiting:
+    //   19048 21123 23359 23739 24462 24699 ms  (median 23.7s, max 24.7s)
+    // It is ONE LLM call over the capability catalog, so the cost is provider
+    // latency and there is no meaningful warm path to under-report.
+    //
+    // WHY IT MATTERS: Core derives its timeout from this (p95 x 4, floored at
+    // 30s). Undeclared, the advisor sat under a 30s default while taking ~25s —
+    // one bad provider spike from failing, and it failed exactly that way on
+    // 2026-08-21 ("HTTP connector timeout after 30000ms"). It is also the FIRST
+    // call a building agent makes and it carries the storage decision, so when
+    // it times out the run proceeds with no capability guidance at all.
+    monitoring: { safe: true, cost: "normal", latency_ms_p95: 25000, output: "bounded" },
     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: {
@@ -5060,7 +5073,7 @@ const handlers = {
     if (!tool) throw new Error("tool required — the tool that misled you");
     if (!error) throw new Error("error required — quote it VERBATIM, do not paraphrase");
     return await post(
-      `/solutions/${solution_id}/lessons`,
+      `/deploy/solutions/${solution_id}/lessons`,
       { tool, error, workaround, worked, kind },
       sid,
     );
@@ -5069,7 +5082,7 @@ const handlers = {
   ateam_get_lessons: async ({ solution_id, limit }, sid) => {
     if (!solution_id) throw new Error("solution_id required");
     const qs = Number.isFinite(limit) ? `?limit=${limit}` : "";
-    return await get(`/solutions/${solution_id}/lessons${qs}`, sid);
+    return await get(`/deploy/solutions/${solution_id}/lessons${qs}`, sid);
   },
 
   ateam_show_solution_minimal: async ({ solution_id }, sid) => {