@topolo/mcp 0.1.1 → 0.1.2

package/dist/index.js

@@ -1,12 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema
-} from "@modelcontextprotocol/sdk/types.js";
 
 // node_modules/@topolo/sdk/dist/index.js
 function applyAuthHeaders(headers, credential) {
@@ -86,6 +81,7 @@ var TopoloClient = class {
   requireConfirmForWrites;
   timeoutMs;
   fetchImpl;
+  debug;
   constructor(options) {
     if (!options.credential) throw new TopoloAuthError("credential is required");
     if (!options.agent?.clientName) throw new TopoloAuthError("agent.clientName is required");
@@ -95,6 +91,14 @@ var TopoloClient = class {
     this.requireConfirmForWrites = options.requireConfirmForWrites !== false;
     this.timeoutMs = options.timeoutMs ?? 3e4;
     this.fetchImpl = options.fetch ?? fetch;
+    this.debug = options.debug;
+  }
+  emit(event) {
+    if (!this.debug) return;
+    try {
+      this.debug(event);
+    } catch {
+    }
   }
   /**
    * Low-level JSON request. Prefer the typed module helpers (identity, crm, ...)
@@ -121,27 +125,56 @@ var TopoloClient = class {
     const platformServiceId = PLATFORM_SERVICE_IDS[opts.service];
     if (platformServiceId) headers.set("X-Service-ID", platformServiceId);
     applyAuthHeaders(headers, this.credential);
-    applyAuditHeaders(headers, this.agent, generateRequestId());
+    const requestId = generateRequestId();
+    applyAuditHeaders(headers, this.agent, requestId);
     if (opts.headers) {
       for (const [k, v] of Object.entries(opts.headers)) headers.set(k, v);
     }
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
     const signal = opts.signal ? mergeSignals(opts.signal, controller.signal) : controller.signal;
+    const urlStr = url.toString();
+    const startedAt = Date.now();
+    this.emit({ phase: "request", method, service: opts.service, path: opts.path, url: urlStr, requestId });
     let res;
     try {
-      res = await this.fetchImpl(url.toString(), {
+      res = await this.fetchImpl(urlStr, {
         method,
         headers,
         body: opts.body !== void 0 ? JSON.stringify(opts.body) : null,
         signal
       });
+    } catch (err) {
+      this.emit({
+        phase: "error",
+        method,
+        service: opts.service,
+        path: opts.path,
+        url: urlStr,
+        requestId,
+        durationMs: Date.now() - startedAt,
+        error: err instanceof Error ? err.message : String(err)
+      });
+      throw err;
     } finally {
       clearTimeout(timeoutId);
     }
     const contentType = res.headers.get("Content-Type") ?? "";
     const parsed = contentType.includes("application/json") ? await res.json().catch(() => null) : await res.text().catch(() => null);
     if (!res.ok) {
+      const durationMs = Date.now() - startedAt;
+      const message = describeError(parsed, `HTTP ${res.status}`);
+      this.emit({
+        phase: "error",
+        method,
+        service: opts.service,
+        path: opts.path,
+        url: urlStr,
+        requestId,
+        durationMs,
+        error: message,
+        status: res.status
+      });
       if (res.status === 401) throw new TopoloAuthError(describeError(parsed, "Unauthorized"));
       if (res.status === 403) {
         throw new TopoloPermissionError(
@@ -151,6 +184,16 @@ var TopoloClient = class {
       }
       throw new TopoloHttpError(opts.service, opts.path, res.status, parsed);
     }
+    this.emit({
+      phase: "response",
+      method,
+      service: opts.service,
+      path: opts.path,
+      url: urlStr,
+      requestId,
+      status: res.status,
+      durationMs: Date.now() - startedAt
+    });
     return parsed;
   }
   /**
@@ -308,6 +351,13 @@ function resolveServiceUrlsFromEnv() {
   return Object.keys(out).length > 0 ? out : void 0;
 }
 
+// src/server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+
 // src/gating.ts
 function hasScope(set, required) {
   if (set.role === "super_admin") return true;
@@ -409,37 +459,12 @@ function filterToolsByScopes(tools, scopes) {
 // src/version.ts
 var MCP_VERSION = "0.1.0";
 
-// src/index.ts
-async function main() {
-  const credential = resolveCredentialFromEnv();
-  if (!credential) {
-    process.stderr.write(
-      "TopoloMCP: TOPOLO_API_KEY or TOPOLO_ACCESS_TOKEN must be set in the environment.\n"
-    );
-    process.exit(1);
-  }
-  const agentName = process.env.TOPOLO_AGENT_NAME;
-  const serviceUrls = resolveServiceUrlsFromEnv();
-  const topolo = createTopolo({
-    credential,
-    agent: {
-      clientName: "topolo-mcp",
-      clientVersion: MCP_VERSION,
-      ...agentName ? { agentName } : {}
-    },
-    serviceUrls,
-    requireConfirmForWrites: true
-  });
-  const scopes = await loadScopes(topolo);
-  const availableTools = filterToolsByScopes(TOOLS, scopes);
+// src/server.ts
+function buildServer(topolo, scopes, tools = TOOLS) {
+  const availableTools = filterToolsByScopes(tools, scopes);
   const server = new Server(
-    {
-      name: "topolo",
-      version: MCP_VERSION
-    },
-    {
-      capabilities: { tools: {} }
-    }
+    { name: "topolo", version: MCP_VERSION },
+    { capabilities: { tools: {} } }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: availableTools.map((t) => ({
@@ -469,9 +494,7 @@ async function main() {
     try {
       const result = await tool.handler(topolo, params.arguments ?? {});
       return {
-        content: [
-          { type: "text", text: JSON.stringify(result, null, 2) }
-        ]
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
       };
     } catch (err) {
       if (err instanceof TopoloPermissionError) {
@@ -483,10 +506,46 @@ async function main() {
       return toolError(err instanceof Error ? err.message : String(err));
     }
   });
+  return server;
+}
+function advertisedToolNames(scopes, tools = TOOLS) {
+  return filterToolsByScopes(tools, scopes).map((t) => t.name);
+}
+function toolError(message) {
+  return {
+    isError: true,
+    content: [{ type: "text", text: message }]
+  };
+}
+
+// src/index.ts
+async function main() {
+  const credential = resolveCredentialFromEnv();
+  if (!credential) {
+    process.stderr.write(
+      "TopoloMCP: TOPOLO_API_KEY or TOPOLO_ACCESS_TOKEN must be set in the environment.\n"
+    );
+    process.exit(1);
+  }
+  const agentName = process.env.TOPOLO_AGENT_NAME;
+  const serviceUrls = resolveServiceUrlsFromEnv();
+  const topolo = createTopolo({
+    credential,
+    agent: {
+      clientName: "topolo-mcp",
+      clientVersion: MCP_VERSION,
+      ...agentName ? { agentName } : {}
+    },
+    serviceUrls,
+    requireConfirmForWrites: true
+  });
+  const scopes = await loadScopes(topolo);
+  const server = buildServer(topolo, scopes);
   const transport = new StdioServerTransport();
   await server.connect(transport);
+  const toolNames = advertisedToolNames(scopes);
   process.stderr.write(
-    `TopoloMCP v${MCP_VERSION} connected. Tools available: ${availableTools.map((t) => t.name).join(", ") || "(none)"}
+    `TopoloMCP v${MCP_VERSION} connected. Tools available: ${toolNames.join(", ") || "(none)"}
 `
   );
 }
@@ -506,12 +565,6 @@ async function loadScopes(topolo) {
     throw err;
   }
 }
-function toolError(message) {
-  return {
-    isError: true,
-    content: [{ type: "text", text: message }]
-  };
-}
 main().catch((err) => {
   process.stderr.write(`TopoloMCP fatal: ${err instanceof Error ? err.message : String(err)}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topolo/mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Model Context Protocol server for the Topolo platform. Exposes scope-gated tools that third-party agents (Claude, Codex, etc.) can call natively.",
   "type": "module",
   "bin": {