@danainnovations/cortex-mcp 1.0.39 → 1.0.40

package/dist/index.d.ts

@@ -141,7 +141,7 @@ declare const AVAILABLE_MCPS: readonly [{
 }, {
     readonly name: "m365";
     readonly displayName: "Microsoft 365";
-    readonly description: "Email, calendar, OneDrive, Teams, meetings, contacts, tasks, notes (32 tools)";
+    readonly description: "Email, calendar, OneDrive, Teams, meetings, contacts, tasks, notes (33 tools)";
     readonly serverName: "cortex-m365";
     readonly authMode: "personal";
 }, {
@@ -189,4 +189,119 @@ declare function readCredentials(): CortexCredentials | null;
  */
 declare function getEffectiveApiKey(): string;
 
-export { AVAILABLE_MCPS, type ClientType, type CortexCredentials, CortexHttpClient, type CortexMcpConfig, DEFAULT_API_KEY, DEFAULT_SERVER_URL, type DetectedClient, MCP_NAMES, configureClaudeCode, configureClaudeDesktop, configureClient, configureCursor, createConfig, detectClients, generateStdioSnippet, getEffectiveApiKey, isValidApiKey, readConfig, readCredentials, startStdioServer, validateApiKeyRemote, writeConfig };
+/** Metadata for a single MCP tool */
+interface ToolInfo {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/** Base error class for all Cortex SDK errors */
+declare class CortexError extends Error {
+    readonly mcpName?: string | undefined;
+    constructor(message: string, mcpName?: string | undefined);
+}
+/**
+ * Thrown when a tool executes but returns isError: true
+ * (e.g., bad SOQL query, missing OAuth connection, invalid record ID).
+ */
+declare class CortexToolError extends CortexError {
+    readonly mcpName: string;
+    readonly toolName: string;
+    constructor(message: string, mcpName: string, toolName: string);
+}
+/**
+ * Thrown on transport/auth failures — the tool never executed
+ * (e.g., invalid API key, network error, server down).
+ */
+declare class CortexNetworkError extends CortexError {
+    readonly code?: number | undefined;
+    constructor(message: string, code?: number | undefined, mcpName?: string);
+}
+/**
+ * Provides a call interface for a single Cortex MCP.
+ * Lazily initializes the underlying HTTP session on first use.
+ */
+declare class MCPNamespace {
+    readonly mcpName: string;
+    private readonly client;
+    private initPromise;
+    constructor(mcpName: string, serverUrl: string, apiKey: string);
+    private ensureInitialized;
+    private doInit;
+    /**
+     * Call a tool on this MCP. Returns the parsed result.
+     *
+     * @example
+     * const ns = new MCPNamespace('salesforce', serverUrl, apiKey);
+     * const result = await ns.call('run_soql_query', {
+     *   query: 'SELECT Id, Name FROM Account LIMIT 10'
+     * });
+     */
+    call(toolName: string, args?: Record<string, unknown>): Promise<unknown>;
+    /** List all tools available on this MCP. */
+    listTools(): Promise<ToolInfo[]>;
+    /** Release the session. The next call() will re-initialize. */
+    close(): void;
+}
+
+interface CortexClientOptions {
+    /** API key. Defaults to auto-resolved key (env > credentials > config > shared). */
+    apiKey?: string;
+    /** Cortex server URL. Defaults to https://cortex-bice.vercel.app */
+    serverUrl?: string;
+}
+/**
+ * High-level SDK client for calling Cortex MCP tools from custom apps.
+ * Auto-resolves credentials and lazily initializes per-MCP sessions.
+ *
+ * @example
+ * ```typescript
+ * import { CortexClient } from '@danainnovations/cortex-mcp';
+ *
+ * const cortex = new CortexClient();
+ *
+ * // Salesforce — no Connected App needed
+ * const accounts = await cortex.salesforce.call('run_soql_query', {
+ *   query: 'SELECT Id, Name FROM Account LIMIT 10'
+ * });
+ *
+ * // Microsoft 365
+ * const emails = await cortex.m365.call('list_emails', { count: 5 });
+ *
+ * // GitHub
+ * const repos = await cortex.github.call('list_repositories', { per_page: 5 });
+ *
+ * // Cleanup when done
+ * cortex.close();
+ * ```
+ */
+declare class CortexClient {
+    private readonly apiKey;
+    private readonly serverUrl;
+    private readonly namespaces;
+    constructor(options?: CortexClientOptions);
+    get asana(): MCPNamespace;
+    get github(): MCPNamespace;
+    get vercel(): MCPNamespace;
+    get supabase(): MCPNamespace;
+    get m365(): MCPNamespace;
+    get salesforce(): MCPNamespace;
+    get monday(): MCPNamespace;
+    get slack(): MCPNamespace;
+    get bestbuy(): MCPNamespace;
+    /**
+     * Call any MCP tool when the MCP name is determined at runtime.
+     *
+     * @example
+     * const result = await cortex.call('github', 'list_repositories', { per_page: 5 });
+     */
+    call(mcpName: string, toolName: string, args?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Release all sessions. Safe to call multiple times.
+     * The next call after close() will re-initialize automatically.
+     */
+    close(): void;
+    private getNamespace;
+}
+
+export { AVAILABLE_MCPS, type ClientType, CortexClient, type CortexClientOptions, type CortexCredentials, CortexError, CortexHttpClient, type CortexMcpConfig, CortexNetworkError, CortexToolError, DEFAULT_API_KEY, DEFAULT_SERVER_URL, type DetectedClient, MCPNamespace, MCP_NAMES, type ToolInfo, configureClaudeCode, configureClaudeDesktop, configureClient, configureCursor, createConfig, detectClients, generateStdioSnippet, getEffectiveApiKey, isValidApiKey, readConfig, readCredentials, startStdioServer, validateApiKeyRemote, writeConfig };

package/dist/index.js

@@ -33,7 +33,7 @@ var AVAILABLE_MCPS = [
   {
     name: "m365",
     displayName: "Microsoft 365",
-    description: "Email, calendar, OneDrive, Teams, meetings, contacts, tasks, notes (32 tools)",
+    description: "Email, calendar, OneDrive, Teams, meetings, contacts, tasks, notes (33 tools)",
     serverName: "cortex-m365",
     authMode: "personal"
   },
@@ -107,7 +107,8 @@ var CortexHttpClient = class {
     const headers = {
       "Content-Type": "application/json",
       "x-api-key": this.apiKey,
-      "mcp-protocol-version": PROTOCOL_VERSION
+      "mcp-protocol-version": PROTOCOL_VERSION,
+      "x-cortex-client": "cortex-mcp-stdio"
     };
     if (this.sessionId) {
       headers["mcp-session-id"] = this.sessionId;
@@ -117,7 +118,7 @@ var CortexHttpClient = class {
       method: "POST",
       headers,
       body: JSON.stringify(body),
-      signal: AbortSignal.timeout(3e4)
+      signal: AbortSignal.timeout(6e4)
     });
     const newSessionId = response.headers.get("mcp-session-id");
     if (newSessionId) {
@@ -142,7 +143,8 @@ var CortexHttpClient = class {
     const headers = {
       "Content-Type": "application/json",
       "x-api-key": this.apiKey,
-      "mcp-protocol-version": PROTOCOL_VERSION
+      "mcp-protocol-version": PROTOCOL_VERSION,
+      "x-cortex-client": "cortex-mcp-stdio"
     };
     if (this.sessionId) {
       headers["mcp-session-id"] = this.sessionId;
@@ -184,7 +186,7 @@ import {
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 var UPLOAD_TOOLS = /* @__PURE__ */ new Set(["upload_file", "upload_file_to_sharepoint"]);
-var INLINE_UPLOAD_MAX = 3.5 * 1024 * 1024;
+var INLINE_UPLOAD_MAX = 3 * 1024 * 1024;
 function overrideUploadToolSchema(tool) {
   const name = tool.name;
   const baseName = name.includes("__") ? name.split("__").pop() : name;
@@ -310,48 +312,57 @@ async function handleLocalFileUpload(cortex, toolName, args) {
     };
   }
   const fileBuffer = readFileSync(filePath);
-  const chunkSize = 10 * 1024 * 1024;
+  const chunkSize = 2.5 * 1024 * 1024;
   const total = fileBuffer.length;
-  let lastResponse = null;
+  let driveItem = {};
   for (let start = 0; start < total; start += chunkSize) {
     const end = Math.min(start + chunkSize, total);
     const chunk = fileBuffer.subarray(start, end);
+    const chunkBase64 = Buffer.from(chunk).toString("base64");
     console.error(
-      `[cortex-mcp] Uploading chunk ${start}-${end - 1}/${total}`
+      `[cortex-mcp] Uploading chunk ${start}-${end - 1}/${total} via backend relay`
     );
-    lastResponse = await fetch(uploadUrl, {
-      method: "PUT",
-      headers: {
-        "Content-Length": String(chunk.length),
-        "Content-Range": `bytes ${start}-${end - 1}/${total}`
-      },
-      body: chunk,
-      signal: AbortSignal.timeout(12e4)
-      // 2 min per chunk
+    const chunkResponse = await cortex.callTool(`${prefix}upload_file_chunk`, {
+      upload_url: uploadUrl,
+      chunk: chunkBase64,
+      range_start: start,
+      range_end: end - 1,
+      total_size: total
     });
-    if (!lastResponse.ok && lastResponse.status !== 202) {
-      const errText = await lastResponse.text();
+    if (chunkResponse.error) {
+      return {
+        content: [{ type: "text", text: chunkResponse.error.message }],
+        isError: true
+      };
+    }
+    const chunkResult = chunkResponse.result;
+    let chunkData;
+    try {
+      chunkData = JSON.parse(chunkResult.content[0].text);
+    } catch {
       return {
         content: [{ type: "text", text: JSON.stringify({
           success: false,
-          error: `Upload chunk failed (${lastResponse.status}): ${errText.slice(0, 200)}`
+          error: "Failed to parse chunk upload response from backend"
         }) }],
         isError: true
       };
     }
-  }
-  let driveItem = {};
-  if (lastResponse) {
-    try {
-      driveItem = await lastResponse.json();
-    } catch {
+    if (!chunkData.success) {
+      return {
+        content: [{ type: "text", text: JSON.stringify(chunkData) }],
+        isError: true
+      };
+    }
+    if (chunkData.status === 200 || chunkData.status === 201) {
+      driveItem = chunkData.data ?? {};
     }
   }
   return {
     content: [{ type: "text", text: JSON.stringify({
       success: true,
       file: driveItem,
-      message: `Uploaded '${args.path}' (${(fileSize / 1024).toFixed(1)}KB) via upload session`
+      message: `Uploaded '${args.path}' (${(fileSize / 1024 / 1024).toFixed(1)}MB) via upload session`
     }) }],
     isError: false
   };
@@ -694,11 +705,181 @@ function getEffectiveApiKey() {
   if (config?.apiKey) return config.apiKey;
   return DEFAULT_API_KEY;
 }
+
+// src/client/mcp-namespace.ts
+var CortexError = class extends Error {
+  constructor(message, mcpName) {
+    super(message);
+    this.mcpName = mcpName;
+    this.name = "CortexError";
+  }
+};
+var CortexToolError = class extends CortexError {
+  constructor(message, mcpName, toolName) {
+    super(message, mcpName);
+    this.mcpName = mcpName;
+    this.toolName = toolName;
+    this.name = "CortexToolError";
+  }
+};
+var CortexNetworkError = class extends CortexError {
+  constructor(message, code, mcpName) {
+    super(message, mcpName);
+    this.code = code;
+    this.name = "CortexNetworkError";
+  }
+};
+var MCPNamespace = class {
+  constructor(mcpName, serverUrl, apiKey) {
+    this.mcpName = mcpName;
+    this.client = new CortexHttpClient(serverUrl, apiKey, mcpName);
+  }
+  client;
+  initPromise = null;
+  async ensureInitialized() {
+    if (this.initPromise !== null) return this.initPromise;
+    this.initPromise = this.doInit();
+    return this.initPromise;
+  }
+  async doInit() {
+    const response = await this.client.initialize();
+    if (response.error) {
+      this.initPromise = null;
+      throw new CortexNetworkError(
+        response.error.message,
+        response.error.code,
+        this.mcpName
+      );
+    }
+  }
+  /**
+   * Call a tool on this MCP. Returns the parsed result.
+   *
+   * @example
+   * const ns = new MCPNamespace('salesforce', serverUrl, apiKey);
+   * const result = await ns.call('run_soql_query', {
+   *   query: 'SELECT Id, Name FROM Account LIMIT 10'
+   * });
+   */
+  async call(toolName, args = {}) {
+    await this.ensureInitialized();
+    const response = await this.client.callTool(toolName, args);
+    if (response.error) {
+      throw new CortexNetworkError(
+        response.error.message,
+        response.error.code,
+        this.mcpName
+      );
+    }
+    const result = response.result;
+    const text = result?.content?.[0]?.text ?? "";
+    if (result?.isError) {
+      throw new CortexToolError(text, this.mcpName, toolName);
+    }
+    return parseText(text);
+  }
+  /** List all tools available on this MCP. */
+  async listTools() {
+    await this.ensureInitialized();
+    const response = await this.client.listTools();
+    if (response.error) {
+      throw new CortexNetworkError(
+        response.error.message,
+        response.error.code,
+        this.mcpName
+      );
+    }
+    const result = response.result;
+    return result?.tools ?? [];
+  }
+  /** Release the session. The next call() will re-initialize. */
+  close() {
+    this.initPromise = null;
+  }
+};
+function parseText(text) {
+  if (!text) return text;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+
+// src/client/cortex-client.ts
+var CortexClient = class {
+  apiKey;
+  serverUrl;
+  namespaces = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    this.apiKey = options.apiKey ?? getEffectiveApiKey();
+    this.serverUrl = options.serverUrl ?? DEFAULT_SERVER_URL;
+  }
+  get asana() {
+    return this.getNamespace("asana");
+  }
+  get github() {
+    return this.getNamespace("github");
+  }
+  get vercel() {
+    return this.getNamespace("vercel");
+  }
+  get supabase() {
+    return this.getNamespace("supabase");
+  }
+  get m365() {
+    return this.getNamespace("m365");
+  }
+  get salesforce() {
+    return this.getNamespace("salesforce");
+  }
+  get monday() {
+    return this.getNamespace("monday");
+  }
+  get slack() {
+    return this.getNamespace("slack");
+  }
+  get bestbuy() {
+    return this.getNamespace("bestbuy");
+  }
+  /**
+   * Call any MCP tool when the MCP name is determined at runtime.
+   *
+   * @example
+   * const result = await cortex.call('github', 'list_repositories', { per_page: 5 });
+   */
+  async call(mcpName, toolName, args = {}) {
+    return this.getNamespace(mcpName).call(toolName, args);
+  }
+  /**
+   * Release all sessions. Safe to call multiple times.
+   * The next call after close() will re-initialize automatically.
+   */
+  close() {
+    for (const ns of this.namespaces.values()) {
+      ns.close();
+    }
+    this.namespaces.clear();
+  }
+  getNamespace(name) {
+    let ns = this.namespaces.get(name);
+    if (!ns) {
+      ns = new MCPNamespace(name, this.serverUrl, this.apiKey);
+      this.namespaces.set(name, ns);
+    }
+    return ns;
+  }
+};
 export {
   AVAILABLE_MCPS,
+  CortexClient,
+  CortexError,
   CortexHttpClient,
+  CortexNetworkError,
+  CortexToolError,
   DEFAULT_API_KEY,
   DEFAULT_SERVER_URL,
+  MCPNamespace,
   MCP_NAMES,
   configureClaudeCode,
   configureClaudeDesktop,