@tasksai/install 0.1.13 → 0.1.15

package/README.md

@@ -5,7 +5,8 @@ Official installer CLI for TasksAI MCP verticals.
 Users normally run this through a product-specific GitHub manifest, for example:
 
 ```bash
-npm exec --package=@tasksai/install --call 'tasksai-install lawtasksai --source https://github.com/laudoluxDev/lawtasksai-mcp'
+npm exec --package=@tasksai/install --call 'tasksai-install lawtasksai --source https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/lawtasksai'
+npm exec --package=@tasksai/install --call 'tasksai-install realtor --source https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/realtor'
 ```
 
 In restricted agent environments, grant write access to the default TasksAI
@@ -13,7 +14,8 @@ application data folder and the selected MCP client config. If the runtime must
 be installed elsewhere, pass an exact product install directory:
 
 ```bash
-npm exec --package=@tasksai/install --call 'tasksai-install farmer --source https://github.com/laudoluxDev/farmertasksai-mcp --install-dir /tmp/tasksai/farmer'
+npm exec --package=@tasksai/install --call 'tasksai-install farmer --source https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/farmer --install-dir /tmp/tasksai/farmer'
+npm exec --package=@tasksai/install --call 'tasksai-install realtor --source https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/realtor --install-dir /tmp/tasksai/realtor'
 ```
 
 `TASKSAI_INSTALL_DIR=/tmp/tasksai/farmer` is equivalent to `--install-dir`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tasksai/install",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Shared TasksAI MCP installer CLI",
   "type": "module",
   "bin": {
@@ -18,12 +18,14 @@
     "tasksai",
     "lawtasksai",
     "farmertasksai",
-    "farmer"
+    "farmer",
+    "realtortasksai",
+    "realtor"
   ],
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/laudoluxDev/tasksai-mcp.git",
+    "url": "git+https://github.com/TasksAI-Official/tasksai-mcp.git",
     "directory": "packages/installer"
   },
   "publishConfig": {

package/runtime/server.py

@@ -25,6 +25,7 @@ import time
 import asyncio
 import platform
 import httpx
+import uuid
 from datetime import datetime
 from pathlib import Path
 
@@ -86,6 +87,7 @@ else:
 API_BASE    = os.getenv("TASKSAI_API_BASE", os.getenv("LAWTASKSAI_API_BASE", "https://api.lawtasksai.com"))
 LICENSE_KEY = os.getenv("TASKSAI_LICENSE_KEY", os.getenv("LAWTASKSAI_LICENSE_KEY", ""))
 PRODUCT_ID  = os.getenv("TASKSAI_PRODUCT_ID", "")  # set by installer; used to resolve correct vertical
+INSTALL_ID  = os.getenv("TASKSAI_INSTALL_ID", "")
 
 if not LICENSE_KEY:
     print("ERROR: License key is required. Set TASKSAI_LICENSE_KEY in your .env file.", file=sys.stderr, flush=True)
@@ -473,6 +475,51 @@ async def api_get(path):
         return resp.json()
 
 
+async def api_post(path, payload):
+    async with httpx.AsyncClient(timeout=10.0) as client:
+        resp = await client.post(
+            f"{API_BASE}{path}",
+            json=payload,
+            headers={**AUTH_HEADERS, "X-Product-ID": (_vertical or {}).get("product_id", "law")}
+        )
+        resp.raise_for_status()
+        return resp.json()
+
+
+def get_install_id() -> str:
+    """Stable anonymous install id for attribution; stored locally only."""
+    global INSTALL_ID
+    if INSTALL_ID:
+        return INSTALL_ID
+    env_path = Path(_dotenv_path) if _dotenv_path else None
+    INSTALL_ID = str(uuid.uuid4())
+    if env_path:
+        try:
+            with env_path.open("a", encoding="utf-8") as f:
+                f.write(f"\nTASKSAI_INSTALL_ID={INSTALL_ID}\n")
+        except Exception:
+            pass
+    return INSTALL_ID
+
+
+async def report_activation_event(event_name, *, skill_id=None, file_format=None):
+    """Best-effort activation telemetry. Never sends document content or paths."""
+    try:
+        await api_post("/v1/events/activation", {
+            "event_name": event_name,
+            "skill_id": skill_id,
+            "file_format": file_format,
+            "install_id": get_install_id(),
+            "metadata": {
+                "source": "mcp_runtime",
+                "client": "mcp-server",
+                "tool_version": SERVER_VERSION,
+            },
+        })
+    except Exception:
+        pass
+
+
 async def load_vertical():
     """Fetch vertical metadata from /v1/me on startup. Falls back to farmer."""
     global _vertical
@@ -1270,6 +1317,11 @@ async def call_tool(name, arguments):
         # ── Save Document ───────────────────────────────────────────────────
         elif name == f"{prefix}_save_document":
             output_path, fmt = save_document(arguments or {}, product_name)
+            await report_activation_event(
+                "first_file_generated",
+                skill_id=(arguments or {}).get("skill_id"),
+                file_format=fmt,
+            )
             return [TextContent(type="text", text=(
                 "**Document Saved**\n\n"
                 f"- File: `{output_path}`\n"

package/src/index.js

@@ -10,15 +10,21 @@ import { spawnSync } from "node:child_process";
 import { stdin as input, stdout as output } from "node:process";
 import { fileURLToPath } from "node:url";
 
-const INSTALLER_VERSION = "0.1.9";
+const INSTALLER_VERSION = "0.1.15";
 const INSTALLER_DIR = path.dirname(fileURLToPath(import.meta.url));
 const BUNDLED_RUNTIME_DIR = path.resolve(INSTALLER_DIR, "..", "runtime");
 const DEFAULT_SOURCES = {
-  lawtasksai: "https://github.com/laudoluxDev/lawtasksai-mcp",
-  farmer: "https://github.com/laudoluxDev/farmertasksai-mcp",
-  teacher: "https://github.com/laudoluxDev/teachertasksai-mcp",
+  lawtasksai: "https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/lawtasksai",
+  farmer: "https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/farmer",
+  realtor: "https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/realtor",
+  teacher: "https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/teacher",
   priorauthai: "https://github.com/laudoluxDev/priorauthai-mcp"
 };
+const LEGACY_MCP_SERVER_IDS = {
+  farmer: ["farmertasksai"],
+  realtor: ["realtortasksai"],
+  teacher: ["teachertasksai"]
+};
 
 const CLIENTS = {
   "claude-desktop": {
@@ -147,8 +153,9 @@ function printUsage() {
   tasksai-install <product-id> uninstall [--client claude-desktop|cursor|windsurf|codex|all] [--install-dir <path>]
 
 Examples:
-  tasksai-install lawtasksai --source https://github.com/laudoluxDev/lawtasksai-mcp
-  tasksai-install farmer --source https://github.com/laudoluxDev/farmertasksai-mcp
+  tasksai-install lawtasksai --source https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/lawtasksai
+  tasksai-install farmer --source https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/farmer
+  tasksai-install realtor --source https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/realtor
   tasksai-install farmer --install-dir /tmp/tasksai/farmer
   tasksai-install lawtasksai doctor
 
@@ -266,23 +273,23 @@ async function uninstall(options) {
     }
 
     await withLock(`${configPath}.lock`, async () => {
-      const key = options.productId;
+      const keys = mcpServerKeysForProduct(options.productId);
       if (client.configFormat === "toml") {
         const text = await fsp.readFile(configPath, "utf8");
-        if (!tomlHasMcpServer(text, key)) {
-          console.log(`${client.displayName} does not have a ${key} MCP entry.`);
+        if (!tomlHasAnyMcpServer(text, keys)) {
+          console.log(`${client.displayName} does not have a ${options.productId} MCP entry.`);
           return;
         }
         await backupFile(configPath);
-        await atomicWriteText(configPath, removeTomlSections(text, [`mcp_servers.${key}`, `mcp_servers.${key}.env`]));
+        await atomicWriteText(configPath, removeTomlSections(text, tomlSectionNamesForProduct(options.productId)));
       } else {
         const config = await readJson(configPath);
-        if (!config.mcpServers?.[key]) {
-          console.log(`${client.displayName} does not have a ${key} MCP entry.`);
+        if (!keys.some((key) => config.mcpServers?.[key])) {
+          console.log(`${client.displayName} does not have a ${options.productId} MCP entry.`);
           return;
         }
         await backupFile(configPath);
-        delete config.mcpServers[key];
+        for (const key of keys) delete config.mcpServers[key];
         await atomicWriteJson(configPath, config);
       }
     });
@@ -311,6 +318,7 @@ async function configureMcpClient({ client, vertical, installDir, runtimeDir, ve
 
     const config = fs.existsSync(configPath) ? await readJson(configPath) : {};
     if (!config.mcpServers || typeof config.mcpServers !== "object") config.mcpServers = {};
+    for (const key of mcpServerKeysForProduct(vertical.product_id)) delete config.mcpServers[key];
     config.mcpServers[vertical.product_id] = serverConfig;
     await atomicWriteJson(configPath, config);
   });
@@ -344,6 +352,11 @@ function tomlHasMcpServer(text, productId) {
   return getTomlSectionNames(text).includes(`mcp_servers.${productId}`);
 }
 
+function tomlHasAnyMcpServer(text, productIds) {
+  const sections = new Set(getTomlSectionNames(text));
+  return productIds.some((productId) => sections.has(`mcp_servers.${productId}`));
+}
+
 function getTomlSectionNames(text) {
   return text
     .split(/\r?\n/)
@@ -355,11 +368,19 @@ function getTomlSectionNames(text) {
 }
 
 function upsertCodexMcpServer(text, productId, serverConfig) {
-  const withoutServer = removeTomlSections(text, [`mcp_servers.${productId}`, `mcp_servers.${productId}.env`]).trimEnd();
+  const withoutServer = removeTomlSections(text, tomlSectionNamesForProduct(productId)).trimEnd();
   const block = formatCodexMcpServer(productId, serverConfig);
   return `${withoutServer ? `${withoutServer}\n\n` : ""}${block}\n`;
 }
 
+function mcpServerKeysForProduct(productId) {
+  return [...new Set([productId, ...(LEGACY_MCP_SERVER_IDS[productId] || [])])];
+}
+
+function tomlSectionNamesForProduct(productId) {
+  return mcpServerKeysForProduct(productId).flatMap((key) => [`mcp_servers.${key}`, `mcp_servers.${key}.env`]);
+}
+
 function removeTomlSections(text, sectionNames) {
   const sections = new Set(sectionNames);
   const lines = text.split(/\r?\n/);
@@ -714,6 +735,12 @@ function verifySource({ options, source, manifest, vertical }) {
   if (source.kind === "github" && manifest.official_github_repo !== source.repoUrl) {
     throw new Error(`Source repo ${source.repoUrl} does not match manifest official repo ${manifest.official_github_repo}.`);
   }
+  if (source.kind === "github" && manifest.official_manifest_path) {
+    const expectedManifestPath = joinGitPath(source.basePath, "agent-install.json");
+    if (normalizeGitPath(manifest.official_manifest_path) !== expectedManifestPath) {
+      throw new Error(`Source manifest ${expectedManifestPath} does not match manifest official path ${manifest.official_manifest_path}.`);
+    }
+  }
   if (!manifest.official_domain || !vertical.website_url?.includes(manifest.official_domain)) {
     throw new Error("Manifest official domain does not match vertical website URL.");
   }
@@ -740,6 +767,37 @@ function parseSource(source, ref) {
   if (source.startsWith("/") || source.startsWith(".")) {
     return { kind: "file", root: path.resolve(source), ref, repoUrl: source };
   }
+  const rawMatch = source.match(/^https:\/\/raw\.githubusercontent\.com\/([^/]+)\/([^/]+)\/([^/]+)\/(.+)$/);
+  if (rawMatch) {
+    const [, owner, repo, rawRef, rawPath] = rawMatch;
+    const manifestPath = normalizeGitPath(rawPath);
+    const basePath = manifestPath.endsWith("/agent-install.json")
+      ? manifestPath.slice(0, -"/agent-install.json".length)
+      : path.posix.dirname(manifestPath);
+    return {
+      kind: "github",
+      owner,
+      repo,
+      ref: rawRef,
+      basePath: basePath === "." ? "" : basePath,
+      repoUrl: `https://github.com/${owner}/${repo}`
+    };
+  }
+  const treeMatch = source.match(/^https:\/\/github\.com\/([^/]+)\/([^/#?]+)\/(?:tree|blob)\/([^/]+)(?:\/([^#?]+))?(?:[?#].*)?$/);
+  if (treeMatch) {
+    const [, owner, repo, treeRef, treePath = ""] = treeMatch;
+    const normalizedPath = normalizeGitPath(treePath);
+    return {
+      kind: "github",
+      owner,
+      repo,
+      ref: treeRef,
+      basePath: normalizedPath.endsWith("/agent-install.json")
+        ? normalizedPath.slice(0, -"/agent-install.json".length)
+        : normalizedPath,
+      repoUrl: `https://github.com/${owner}/${repo}`
+    };
+  }
   const match = source.match(/^https:\/\/github\.com\/([^/]+)\/([^/#?]+)(?:[/?#].*)?$/);
   if (!match) throw new Error(`Unsupported source URL: ${source}`);
   const [, owner, repo] = match;
@@ -748,6 +806,7 @@ function parseSource(source, ref) {
     owner,
     repo,
     ref,
+    basePath: "",
     repoUrl: `https://github.com/${owner}/${repo}`
   };
 }
@@ -760,10 +819,27 @@ async function loadText(source, filePath) {
   if (source.kind === "file") {
     return fsp.readFile(path.join(source.root, filePath), "utf8");
   }
-  const rawUrl = `https://raw.githubusercontent.com/${source.owner}/${source.repo}/${encodeURIComponent(source.ref)}/${filePath}`;
+  const sourcePath = joinGitPath(source.basePath, filePath);
+  const rawUrl = `https://raw.githubusercontent.com/${source.owner}/${source.repo}/${encodeURIComponent(source.ref)}/${encodeGitPath(sourcePath)}`;
   return fetchText(rawUrl);
 }
 
+function normalizeGitPath(value = "") {
+  return value
+    .split("/")
+    .filter(Boolean)
+    .map((part) => decodeURIComponent(part))
+    .join("/");
+}
+
+function joinGitPath(...parts) {
+  return normalizeGitPath(parts.filter(Boolean).join("/"));
+}
+
+function encodeGitPath(value) {
+  return normalizeGitPath(value).split("/").map(encodeURIComponent).join("/");
+}
+
 function fetchText(url) {
   return new Promise((resolve, reject) => {
     https.get(url, { headers: { "User-Agent": `tasksai-install/${INSTALLER_VERSION}` } }, (response) => {