@ateam-ai/mcp 0.3.41 → 0.3.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ateam-ai/mcp",
-  "version": "0.3.41",
+  "version": "0.3.43",
   "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/tools.js

@@ -499,6 +499,42 @@ export const tools = [
     },
   },
 
+  {
+    name: "ateam_show_skill_minimal",
+    core: true,
+    description:
+      "Show the minimal authoring view of a skill — persona + connectors + " +
+      "handoff_when + style + policy guardrails only. ~10× smaller than " +
+      "ateam_get_solution(view:'skills') for the same skill. Use this when " +
+      "you only need the irreducible author content (Phase 9 of the strip).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        solution_id: { type: "string", description: "The solution ID" },
+        skill_id: { type: "string", description: "The skill ID" },
+      },
+      required: ["solution_id", "skill_id"],
+    },
+  },
+
+  {
+    name: "ateam_show_solution_minimal",
+    core: true,
+    description:
+      "Show the minimal authoring view of a solution — name + description + " +
+      "style + routing_mode + identity_mode + skill ids + connector ids only. " +
+      "Skips deployed metadata, handoffs (auto-generated), grants, ui_plugins, " +
+      "validation results. Use this for fast inspection without the verbose " +
+      "fields (Phase 9 of the strip).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        solution_id: { type: "string", description: "The solution ID" },
+      },
+      required: ["solution_id"],
+    },
+  },
+
   {
     name: "ateam_create_connector",
     core: true,
@@ -1620,6 +1656,36 @@ const handlers = {
         deploy: "Activation into controlled runtime on A-Team Core",
       },
     },
+    minimal_authoring: {
+      _important: "READ THIS BEFORE WRITING. Most of what historic A-Team docs describe as required is now AUTO-GENERATED at deploy time. Writing the verbose form is wasted tokens — the platform overwrites your hand-written intents, tools, scenarios, etc. with its generated equivalents.",
+      author_writes_per_skill: [
+        "id, name, version, description",
+        "role.persona (the agent's instructions in prose — this is the irreducible content)",
+        "connectors[] (which MCP connector ids the skill uses)",
+        "policy.guardrails (optional — always[]/never[] rules)",
+        "handoff_when (optional — one-sentence routing trigger; LLM-synthesizes one if you omit it)",
+      ],
+      author_writes_per_solution: [
+        "id, name, description, version",
+        "linked_skills[] (skill ids the solution composes)",
+        "routing_mode: \"auto\"  (opt into the auto-generated orchestrator)",
+        "style: \"mobile\" | \"voice\" | etc (Phase 1 channel style cascade)",
+      ],
+      platform_generates_at_deploy: [
+        "skill.tools[]   — Phase 2b: fetched from each connector's live tool inventory",
+        "skill.intents   — Phase 3: LLM-synthesized from persona + tools",
+        "skill.scenarios — auto from intents",
+        "skill.engine    — Phase 4: resolved from preset name or default",
+        "skill.security  — Phase 2: tool classifications auto-applied",
+        "skill.access_policy — defaults",
+        "solution orchestrator skill — Phase 6: generated when routing_mode:auto",
+        "solution.handoffs[] — Phase 6: orchestrator → each worker",
+        "solution.ui_plugins[] — Phase 5: MCP introspection (ui.listPlugins + ui.getPlugin)",
+        "Style block prepended to every skill persona — Phase 1",
+      ],
+      replace_rule: "REPLACE wins per-field. Any field you write explicitly overrides the platform-generated equivalent. Delete it to opt back into automation.",
+      read_first: "GET /spec/skill → auto_expand block has the full list and a typical_minimal_skill example. GET /spec/solution → same.",
+    },
     example_solutions: [
       { name: "Fleet Command Center", description: "Live vehicle tracking, route optimization, safety monitoring, governed execution" },
       { name: "Customer Support Operations Team", description: "Multi-role support system with escalation, refund controls, CRM integration" },
@@ -2730,6 +2796,62 @@ const handlers = {
       { timeoutMs: 300_000, retries: 1 },
     ),
 
+  // ── Phase 9 strip: focused minimal responses ────────────────────────
+  ateam_show_skill_minimal: async ({ solution_id, skill_id }, sid) => {
+    if (!solution_id) throw new Error("solution_id required");
+    if (!skill_id) throw new Error("skill_id required");
+    const full = await get(`/deploy/solutions/${solution_id}/skills/${skill_id}`, sid);
+    const skill = full?.skill || full;
+    if (!skill) return { ok: false, error: "skill not found" };
+    return {
+      ok: true,
+      id: skill.id,
+      name: skill.name || skill.id,
+      description: skill.description || "",
+      role: { persona: skill.role?.persona || "" },
+      connectors: skill.connectors || [],
+      handoff_when: skill.handoff_when || null,
+      style: skill.style || null,
+      excluded_tools: skill.excluded_tools || [],
+      policy_guardrails: {
+        never: skill.policy?.guardrails?.never || [],
+        always: skill.policy?.guardrails?.always || [],
+      },
+      engine: typeof skill.engine === "string" ? skill.engine : (skill.engine ? "<explicit-object>" : null),
+      _hint: "This is the MINIMAL view (Phase 9 strip). Use ateam_get_solution(view:'skills', skill_id) for the full schema.",
+    };
+  },
+
+  ateam_show_solution_minimal: async ({ solution_id }, sid) => {
+    if (!solution_id) throw new Error("solution_id required");
+    const full = await get(`/deploy/solutions/${solution_id}/definition`, sid);
+    const sol = full?.solution || full;
+    if (!sol) return { ok: false, error: "solution not found" };
+    return {
+      ok: true,
+      id: sol.id,
+      name: sol.name || sol.id,
+      description: sol.description || "",
+      version: sol.version || "1.0.0",
+      style: sol.style || null,
+      routing_mode: sol.routing_mode || "manual",
+      identity_mode: sol.identity_mode || null,
+      identity: sol.identity ? {
+        default_actor_type: sol.identity.default_actor_type,
+        actor_types_count: (sol.identity.actor_types || []).length,
+      } : null,
+      skills: (sol.skills || []).map(s => ({
+        id: s.id,
+        name: s.name || s.id,
+        role: s.role || "worker",
+      })),
+      connectors_count: (sol.platform_connectors || []).length,
+      ui_plugins_count: (sol.ui_plugins || []).length,
+      handoffs_count: (sol.handoffs || []).length,
+      _hint: "This is the MINIMAL view (Phase 9 strip). Use ateam_get_solution(view:'definition') for the full schema.",
+    };
+  },
+
   // ── Phase 7 strip: scaffold helpers ─────────────────────────────────
   ateam_create_connector: async ({ solution_id, connector_id, name, ui_capable }, sid) => {
     if (!solution_id) throw new Error("solution_id required");