@tasksai/install 0.1.12 → 0.1.14

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.12",
+  "version": "0.1.14",
   "description": "Shared TasksAI MCP installer CLI",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "src/",
-    "runtime/",
+    "runtime/server.py",
+    "runtime/requirements.txt",
     "README.md"
   ],
   "keywords": [
@@ -17,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,13 +10,14 @@ 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.14";
 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"
 };
 
@@ -147,8 +148,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
 
@@ -714,6 +716,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 +748,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 +787,7 @@ function parseSource(source, ref) {
     owner,
     repo,
     ref,
+    basePath: "",
     repoUrl: `https://github.com/${owner}/${repo}`
   };
 }
@@ -760,10 +800,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) => {