@ateam-ai/mcp 0.3.39 → 0.3.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ateam-ai/mcp",
-  "version": "0.3.39",
+  "version": "0.3.41",
   "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,70 @@ export const tools = [
     },
   },
 
+  {
+    name: "ateam_create_connector",
+    core: true,
+    description:
+      "Scaffold a new MCP connector with server.js + package.json + README. " +
+      "Eliminates ~50% of identical boilerplate (MCP server setup, tool registration, " +
+      "stdio transport). You then fill in the tool implementations. " +
+      "Set ui_capable=true to include ui.listPlugins / ui.getPlugin stubs " +
+      "(plugin source files added separately via ateam_create_plugin). " +
+      "After scaffolding, the files are uploaded to Core via the same path " +
+      "as ateam_upload_connector.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        solution_id: { type: "string", description: "The solution ID" },
+        connector_id: {
+          type: "string",
+          description: "Connector ID (lowercase-with-dashes, no spaces). Becomes the directory name.",
+        },
+        name: {
+          type: "string",
+          description: "Human-readable name for the connector (e.g. 'Hue Lights'). Defaults to connector_id.",
+        },
+        ui_capable: {
+          type: "boolean",
+          description: "If true, include ui.listPlugins/ui.getPlugin handler stubs. Default: false.",
+        },
+      },
+      required: ["solution_id", "connector_id"],
+    },
+  },
+
+  {
+    name: "ateam_create_plugin",
+    core: true,
+    description:
+      "Scaffold a UI plugin (iframe HTML, React Native TSX, or both) inside an existing connector. " +
+      "Eliminates ~50% of identical plugin boilerplate (imports, theme/bridge hooks, " +
+      "postMessage protocol, default export shape). You then fill in the component body. " +
+      "Use kind='iframe' for web-only, 'rn' for mobile-only, 'adaptive' for both. " +
+      "Auto-discovery (Phase 5 of the strip) picks up the new plugin at next deploy " +
+      "without a manifest declaration.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        solution_id: { type: "string", description: "The solution ID" },
+        connector_id: {
+          type: "string",
+          description: "Existing connector to add the plugin into (e.g. 'personal-assistant-ui-mcp')",
+        },
+        plugin_name: {
+          type: "string",
+          description: "Plugin name (lowercase-with-dashes). E.g. 'memories-panel'. Becomes the dir name.",
+        },
+        kind: {
+          type: "string",
+          enum: ["iframe", "rn", "adaptive"],
+          description: "Render mode. 'adaptive' (default) produces both iframe + RN scaffolds.",
+        },
+      },
+      required: ["solution_id", "connector_id", "plugin_name"],
+    },
+  },
+
   {
     name: "ateam_upload_connector",
     core: true,
@@ -894,6 +958,19 @@ export const tools = [
       required: ["solution_id"],
     },
   },
+  {
+    name: "ateam_verify_consistency",
+    core: false,
+    description:
+      "Read-only: do Builder FS and the GitHub repo agree for this solution? Returns { consistent: bool, drifts: [{path, kind}] } where kind ∈ fs_missing | content_differs | gh_missing | gh_read_error | repo_unreachable. Comparison strips ephemeral fields (timestamps, runtime/deploy-state, resolved-on-load flags) so only REAL content drift surfaces. Use this any time you're unsure whether a recent change landed on GitHub or whether your local view of the solution matches what's deployed — much faster than scrolling ateam_github_log manually. No deploy is triggered.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        solution_id: { type: "string", description: "The solution ID" },
+      },
+      required: ["solution_id"],
+    },
+  },
 
   // ═══════════════════════════════════════════════════════════════════
   // GITHUB TOOLS — version control for solutions
@@ -1252,6 +1329,7 @@ const TENANT_TOOLS = new Set([
   "ateam_get_connector_source",
   "ateam_get_metrics",
   "ateam_diff",
+  "ateam_verify_consistency",
   // GitHub operations
   "ateam_github_push",
   "ateam_github_pull",
@@ -1267,6 +1345,264 @@ const TENANT_TOOLS = new Set([
 /** Small delay helper */
 const sleep = (ms) => new Promise(r => setTimeout(r, ms));
 
+// ═══════════════════════════════════════════════════════════════════
+// Phase 7 strip: connector + plugin scaffolds
+// ───────────────────────────────────────────────────────────────────
+// Pure client-side templates. ateam_create_connector / ateam_create_plugin
+// produce file contents + push them via the existing /deploy/.../upload
+// endpoint. The author writes only the unique tool implementations and
+// component bodies; the ~50% of boilerplate per connector/plugin (MCP
+// server setup, theme/bridge hooks, postMessage protocol, package.json)
+// is template-generated.
+// ═══════════════════════════════════════════════════════════════════
+
+function _scaffoldConnectorFiles({ connectorId, displayName, uiCapable }) {
+  const safeName = displayName || connectorId;
+  const files = [];
+
+  // server.js — minimal stdio MCP server with one tool stub + ui handlers if ui_capable
+  const serverJs = `#!/usr/bin/env node
+// ${connectorId} — stdio MCP server. Generated by ateam_create_connector.
+//
+// Fill in the tool implementations below. The MCP scaffolding
+// (server setup, tool registration, error handling, stdio transport)
+// is template-provided. You write the integration logic.
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+const server = new Server(
+  { name: "${connectorId}", version: "1.0.0" },
+  { capabilities: { tools: {}${uiCapable ? ', ui: {}' : ''} } },
+);
+
+// ── Tool definitions ────────────────────────────────────────────────
+const TOOLS = [
+  {
+    name: "${connectorId}.echo",
+    description: "Echo back the input. Replace with your real tools.",
+    inputSchema: {
+      type: "object",
+      properties: { message: { type: "string" } },
+      required: ["message"],
+    },
+  },
+];
+
+server.setRequestHandler({ method: "tools/list" }, async () => ({ tools: TOOLS }));
+
+server.setRequestHandler({ method: "tools/call" }, async (req) => {
+  const { name, arguments: args } = req.params;
+  switch (name) {
+    case "${connectorId}.echo":
+      return { content: [{ type: "text", text: \`Echo: \${args.message}\` }] };
+    default:
+      throw new Error(\`Unknown tool: \${name}\`);
+  }
+});
+${uiCapable ? `
+// ── UI plugin handlers (ui_capable connector) ──────────────────────
+server.setRequestHandler({ method: "ui.listPlugins" }, async () => ({
+  plugins: [
+    // List your plugins here. Plugin source files live in
+    // plugins/<plugin-name>/ (RN) and ui-dist/<plugin-name>/ (iframe).
+    // Plugin manifests are auto-discovered at deploy time per Phase 5
+    // of the strip — no need to repeat them here unless you want overrides.
+  ],
+}));
+
+server.setRequestHandler({ method: "ui.getPlugin" }, async (req) => {
+  const { id } = req.params;
+  // Return plugin manifest by id. Auto-discovery covers the default case.
+  return { ok: false, error: \`Plugin \${id} not found\` };
+});
+` : ''}
+// ── Boot ────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("[${connectorId}] connected via stdio");
+`;
+  files.push({ path: "server.js", content: serverJs });
+
+  // package.json
+  const pkg = {
+    name: connectorId,
+    version: "1.0.0",
+    type: "module",
+    description: `${safeName} — A-Team MCP connector`,
+    main: "server.js",
+    dependencies: {
+      "@modelcontextprotocol/sdk": "^1.0.0",
+    },
+  };
+  files.push({ path: "package.json", content: JSON.stringify(pkg, null, 2) + "\n" });
+
+  // README.md
+  const readme = `# ${safeName}
+
+Connector ID: \`${connectorId}\`
+${uiCapable ? "UI-capable: yes" : ""}
+
+## Adding tools
+
+Edit \`server.js\`. Add entries to the \`TOOLS\` array, then add a
+matching case in the \`tools/call\` handler.
+
+## Adding UI plugins (ui_capable connectors)
+
+Drop iframe plugins under \`ui-dist/<plugin-name>/index.html\` and/or
+React Native plugins under \`plugins/<plugin-name>/index.tsx\`.
+Phase 5 of the strip auto-discovers them at deploy — no manifest
+declaration needed unless you want overrides (drop a
+\`manifest.json\` next to the source).
+
+## Deploy
+
+Use \`ateam_upload_connector\` to push the latest source to Core
+without a full skill redeploy.
+`;
+  files.push({ path: "README.md", content: readme });
+
+  return files;
+}
+
+function _scaffoldPluginFiles({ connectorId, pluginName, kind }) {
+  const files = [];
+
+  if (kind === "iframe" || kind === "adaptive") {
+    const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>${pluginName}</title>
+<style>
+  body { font-family: system-ui, sans-serif; padding: 16px; margin: 0; }
+  .card { background: #f5f5f5; padding: 12px; border-radius: 8px; }
+</style>
+</head>
+<body>
+<div class="card">
+  <h2>${pluginName}</h2>
+  <p>Plugin body — replace with your real UI.</p>
+  <button id="callTool">Call sample tool</button>
+  <pre id="output"></pre>
+</div>
+<script type="module">
+  // ── Plugin postMessage protocol scaffold ────────────────────────
+  // 'adas-host' messages come FROM the host shell (web app / mobile).
+  // 'adas-plugin' messages go TO the host.
+  // Use mcpCall(tool, args) to invoke any tool the skill has access to.
+
+  function mcpCall(tool, args = {}, connectorId) {
+    return new Promise((resolve, reject) => {
+      const id = "call_" + Math.random().toString(36).slice(2);
+      const listener = (e) => {
+        if (e?.data?.type !== "adas-host") return;
+        if (e?.data?.requestId !== id) return;
+        window.removeEventListener("message", listener);
+        if (e.data.error) reject(new Error(e.data.error));
+        else resolve(e.data.result);
+      };
+      window.addEventListener("message", listener);
+      window.parent?.postMessage({
+        type: "adas-plugin",
+        action: "mcpCall",
+        requestId: id,
+        tool, args, connectorId,
+      }, "*");
+    });
+  }
+
+  document.getElementById("callTool").addEventListener("click", async () => {
+    try {
+      const result = await mcpCall("${connectorId}.echo", { message: "hello" });
+      document.getElementById("output").textContent = JSON.stringify(result, null, 2);
+    } catch (err) {
+      document.getElementById("output").textContent = "Error: " + err.message;
+    }
+  });
+
+  // Tell host we're ready
+  window.parent?.postMessage({ type: "adas-plugin", action: "ready" }, "*");
+</script>
+</body>
+</html>
+`;
+    files.push({
+      path: `ui-dist/${pluginName}/index.html`,
+      content: html,
+    });
+  }
+
+  if (kind === "rn" || kind === "adaptive") {
+    const tsx = `// ${pluginName} — React Native plugin. Generated by ateam_create_plugin.
+//
+// Fill in the Component body. Imports, hooks, default export shape are
+// template-provided — Phase 7 of the strip eliminates this boilerplate.
+
+import React, { useState } from 'react';
+import { View, Text, TouchableOpacity, StyleSheet } from 'react-native';
+import { useApi } from '../../plugin-sdk';
+import type { PluginProps } from '../../plugin-sdk/types';
+
+// Plain object export — NO PluginSDK.register() (pollutes shared registry).
+export default {
+  id: '${pluginName}',
+  type: 'ui',
+  version: '1.0.0',
+  capabilities: { haptics: true },
+
+  Component({ bridge, native, theme }: PluginProps) {
+    const api = useApi(bridge);
+    const [output, setOutput] = useState<string>('');
+
+    const handlePress = async () => {
+      try {
+        native?.haptics?.selection?.();
+        const result = await api.call('${connectorId}.echo', { message: 'hello' });
+        setOutput(JSON.stringify(result, null, 2));
+      } catch (err: any) {
+        native?.haptics?.error?.();
+        setOutput('Error: ' + err.message);
+      }
+    };
+
+    const styles = StyleSheet.create({
+      container: { padding: 16, backgroundColor: theme.colors.bg, flex: 1 },
+      card: { backgroundColor: theme.colors.surface, padding: 12, borderRadius: 8 },
+      title: { fontSize: 18, fontWeight: '600', color: theme.colors.text, marginBottom: 8 },
+      button: { backgroundColor: theme.colors.accent, padding: 12, borderRadius: 6, marginTop: 12 },
+      buttonText: { color: '#fff', textAlign: 'center', fontWeight: '600' },
+      output: { color: theme.colors.textMuted, marginTop: 12, fontFamily: 'Menlo' },
+    });
+
+    return (
+      <View style={styles.container}>
+        <View style={styles.card}>
+          <Text style={styles.title}>${pluginName}</Text>
+          <Text style={{ color: theme.colors.textMuted }}>
+            Plugin body — replace with your real UI.
+          </Text>
+          <TouchableOpacity style={styles.button} onPress={handlePress}>
+            <Text style={styles.buttonText}>Call sample tool</Text>
+          </TouchableOpacity>
+          {!!output && <Text style={styles.output}>{output}</Text>}
+        </View>
+      </View>
+    );
+  },
+};
+`;
+    files.push({
+      path: `plugins/${pluginName}/index.tsx`,
+      content: tsx,
+    });
+  }
+
+  return files;
+}
+
 const handlers = {
   ateam_bootstrap: async () => ({
     platform_positioning: {
@@ -2323,6 +2659,9 @@ const handlers = {
     return get(`/deploy/solutions/${solution_id}/metrics${qsStr}`, sid);
   },
 
+  ateam_verify_consistency: async ({ solution_id }, sid) =>
+    get(`/deploy/solutions/${solution_id}/verify`, sid),
+
   ateam_diff: async ({ solution_id, skill_id }, sid) => {
     const qs = skill_id ? `?skill_id=${encodeURIComponent(skill_id)}` : "";
     return get(`/deploy/solutions/${solution_id}/diff${qs}`, sid);
@@ -2391,6 +2730,81 @@ const handlers = {
       { timeoutMs: 300_000, retries: 1 },
     ),
 
+  // ── 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");
+    if (!connector_id) throw new Error("connector_id required");
+    if (!/^[a-z][a-z0-9-]*$/.test(connector_id)) {
+      throw new Error("connector_id must be lowercase letters/digits/dashes only");
+    }
+    const files = _scaffoldConnectorFiles({
+      connectorId: connector_id,
+      displayName: name || connector_id,
+      uiCapable: !!ui_capable,
+    });
+    const result = await post(
+      `/deploy/solutions/${solution_id}/connectors/${connector_id}/upload`,
+      { files },
+      sid,
+      { timeoutMs: 120_000, retries: 1 },
+    );
+    return {
+      ok: true,
+      connector_id,
+      files_created: files.map(f => f.path),
+      ui_capable: !!ui_capable,
+      upload_result: result,
+      next_steps: [
+        `Edit server.js to add your real tools (replace the echo stub).`,
+        ui_capable
+          ? `Use ateam_create_plugin to scaffold your first UI plugin.`
+          : null,
+        `Use ateam_test_connector or ateam_build_and_run to deploy + test.`,
+      ].filter(Boolean),
+    };
+  },
+
+  ateam_create_plugin: async ({ solution_id, connector_id, plugin_name, kind }, sid) => {
+    if (!solution_id) throw new Error("solution_id required");
+    if (!connector_id) throw new Error("connector_id required");
+    if (!plugin_name) throw new Error("plugin_name required");
+    if (!/^[a-z][a-z0-9-]*$/.test(plugin_name)) {
+      throw new Error("plugin_name must be lowercase letters/digits/dashes only");
+    }
+    const k = kind || "adaptive";
+    if (!["iframe", "rn", "adaptive"].includes(k)) {
+      throw new Error(`kind must be one of: iframe, rn, adaptive (got ${k})`);
+    }
+    const files = _scaffoldPluginFiles({
+      connectorId: connector_id,
+      pluginName: plugin_name,
+      kind: k,
+    });
+    const result = await post(
+      `/deploy/solutions/${solution_id}/connectors/${connector_id}/upload`,
+      { files },
+      sid,
+      { timeoutMs: 120_000, retries: 1 },
+    );
+    return {
+      ok: true,
+      plugin_id: `mcp:${connector_id}:${plugin_name}`,
+      kind: k,
+      files_created: files.map(f => f.path),
+      upload_result: result,
+      next_steps: [
+        k === "rn" || k === "adaptive"
+          ? `Edit plugins/${plugin_name}/index.tsx — fill in the Component body.`
+          : null,
+        k === "iframe" || k === "adaptive"
+          ? `Edit ui-dist/${plugin_name}/index.html — replace the placeholder UI.`
+          : null,
+        `Phase 5 auto-discovery will register the plugin at next deploy.`,
+        `Optional: drop a manifest.json next to the source for custom commands/capabilities.`,
+      ].filter(Boolean),
+    };
+  },
+
   ateam_redeploy: async ({ solution_id, skill_id }, sid) => {
     const endpoint = skill_id
       ? `/deploy/solutions/${solution_id}/skills/${skill_id}/redeploy`