@dobbyai/mcp-external 1.1.0 → 1.2.0

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Dobby MCP Server
+ * Dobby MCP Server — CLI entry point
  *
  * Model Context Protocol server for Dobby AI Platform.
  * Enables access from Claude Desktop, Cursor, Windsurf, and other MCP clients.
@@ -9,17 +9,18 @@
  *   npx @dobbyai/mcp-external                    # STDIO mode (default)
  *   npx @dobbyai/mcp-external --transport http   # HTTP mode
  *   npx @dobbyai/mcp-external --setup            # Interactive setup
+ *
+ * The server factory (handler registration, tier enforcement) lives in
+ * server.ts — this file only parses the CLI and starts the transport.
+ * Importing THIS module runs main(); tests import server.ts instead.
  */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { Command } from 'commander';
-import dotenv from 'dotenv';
-import { createDobbyClient, DobbyClient } from './lib/dobby-client.js';
-import { getToolDefinitions, handleToolCall } from './tools/index.js';
-import { resourceDefinitions, resourceTemplates, handleResourceRead } from './resources/index.js';
-import { promptDefinitions, handlePromptGet } from './prompts/index.js';
-import { startHttpServer } from './http-server.js';
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Command } from "commander";
+import dotenv from "dotenv";
+import { createDobbyClient } from "./lib/dobby-client.js";
+import { createServer, resolveGatewayKey } from "./server.js";
+import { startHttpServer } from "./http-server.js";
+import { log, useStderrSink } from "./lib/log.js";
 // Load environment variables
 dotenv.config();
 // ============================================
@@ -27,205 +28,60 @@ dotenv.config();
 // ============================================
 const program = new Command();
 program
-    .name('dobby-mcp')
-    .description('Dobby MCP Server - Connect to Dobby from any MCP client')
-    .version('1.0.0')
-    .option('-t, --transport <type>', 'Transport type: stdio or http', 'stdio')
-    .option('-p, --port <number>', 'HTTP server port (for http transport)', '8080')
-    .option('--api-url <url>', 'Dobby API URL', process.env.DOBBY_API_URL)
-    .option('--api-key <key>', 'Dobby API Key', process.env.DOBBY_API_KEY)
-    .option('--tenant-id <id>', 'Dobby Tenant ID', process.env.DOBBY_TENANT_ID)
-    .option('--gateway-key <key>', 'Gateway API Key (gk_* format)', process.env.DOBBY_GATEWAY_KEY)
-    .option('--gateway-url <url>', 'Gateway API URL (defaults to API URL)', process.env.DOBBY_GATEWAY_URL)
-    .option('--setup', 'Run interactive setup')
+    .name("dobby-mcp")
+    .description("Dobby MCP Server - Connect to Dobby from any MCP client")
+    .version("1.2.0")
+    .option("-t, --transport <type>", "Transport type: stdio or http", "stdio")
+    .option("-p, --port <number>", "HTTP server port (for http transport)", "8080")
+    .option("--api-url <url>", "Dobby API URL", process.env.DOBBY_API_URL)
+    .option("--api-key <key>", "Dobby API Key", process.env.DOBBY_API_KEY)
+    .option("--tenant-id <id>", "Dobby Tenant ID", process.env.DOBBY_TENANT_ID)
+    .option("--gateway-key <key>", "Gateway API Key (gk_* format)", process.env.DOBBY_GATEWAY_KEY)
+    .option("--gateway-url <url>", "Gateway API URL (defaults to API URL)", process.env.DOBBY_GATEWAY_URL)
+    .option("--setup", "Run interactive setup")
+    .option("--doctor", "Run a connection/credential preflight and exit")
     .parse();
 const options = program.opts();
 // ============================================
-// Gateway Key Resolution
-// ============================================
-/**
- * Resolve the gateway key to use for auth + audit logging.
- * Priority: explicit DOBBY_GATEWAY_KEY > auto-detect gk_* in DOBBY_API_KEY > undefined (disabled)
- */
-function resolveGatewayKey(opts) {
-    if (opts.gatewayKey)
-        return opts.gatewayKey;
-    if (opts.apiKey && opts.apiKey.startsWith('gk_'))
-        return opts.apiKey;
-    return undefined;
-}
-/**
- * Create an MCP Server with all handlers registered.
- *
- * In STDIO mode: tenant context comes from env vars (DOBBY_TENANT_ID, DOBBY_API_KEY).
- * In HTTP mode: tenant context comes from OAuth token (extra.authInfo.extra.tenant_id).
- * The DobbyClient is created lazily per-request in HTTP mode.
- */
-async function createServer(opts = { mode: 'stdio' }) {
-    const apiUrl = options.apiUrl || process.env.DOBBY_API_URL || 'https://dobby-ai.com';
-    // In STDIO mode, create a shared client from env vars
-    let stdioClient;
-    if (opts.mode === 'stdio') {
-        stdioClient = createDobbyClient({
-            apiUrl: options.apiUrl,
-            apiKey: options.apiKey,
-            tenantId: options.tenantId,
-        });
-    }
-    // Create MCP server
-    const server = new Server({
-        name: 'dobby-mcp-server',
-        version: '1.1.0',
-    }, {
-        capabilities: {
-            tools: {},
-            resources: {},
-            prompts: {},
-        },
-    });
-    // STDIO user context
-    const userContext = {
-        userId: process.env.DOBBY_USER_ID || 'mcp-user',
-        userName: process.env.DOBBY_USER_NAME || 'MCP User',
-    };
-    // STDIO gateway auth context
-    const gatewayKey = resolveGatewayKey({
-        gatewayKey: options.gatewayKey,
-        apiKey: options.apiKey,
-    });
-    const gatewayUrl = options.gatewayUrl || apiUrl;
-    // ============================================
-    // Tools Handler
-    // ============================================
-    server.setRequestHandler(ListToolsRequestSchema, async (_request, extra) => {
-        // In HTTP mode, could filter by tier based on auth scopes
-        // For now, return all tools with annotations
-        return {
-            tools: getToolDefinitions('enterprise'),
-        };
-    });
-    server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-        const { name, arguments: args } = request.params;
-        try {
-            let client;
-            let userId;
-            let userName;
-            let tenantId;
-            let region;
-            let gwKey;
-            let gwUrl;
-            if (opts.mode === 'http' && extra.authInfo) {
-                // HTTP mode — resolve context from OAuth token
-                const tokenExtra = extra.authInfo.extra;
-                const tokenTenantId = tokenExtra?.tenant_id;
-                const tokenOrgId = tokenExtra?.org_id;
-                const tokenUserId = tokenExtra?.user_id || 'oauth-user';
-                if (!tokenTenantId) {
-                    return {
-                        content: [{ type: 'text', text: 'Error: OAuth token missing tenant_id' }],
-                        isError: true,
-                    };
-                }
-                // Create per-request client using the OAuth access token as the API key
-                client = new DobbyClient({
-                    apiUrl,
-                    apiKey: extra.authInfo.token,
-                    tenantId: tokenTenantId,
-                });
-                userId = tokenUserId;
-                userName = 'OAuth User';
-                tenantId = tokenTenantId;
-                region = undefined; // resolved by web app from tenant
-                gwKey = extra.authInfo.token; // use OAuth token for gateway auth
-                gwUrl = apiUrl;
-            }
-            else {
-                // STDIO mode — use env vars
-                client = stdioClient;
-                userId = userContext.userId;
-                userName = userContext.userName;
-                tenantId = client.tenantId;
-                region = process.env.DOBBY_REGION;
-                gwKey = gatewayKey;
-                gwUrl = gatewayUrl;
-            }
-            const result = await handleToolCall(name, args || {}, {
-                client,
-                userId,
-                userName,
-                gatewayKey: gwKey,
-                gatewayUrl: gwUrl,
-                tenantId,
-                region,
-            });
-            return result;
-        }
-        catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error.message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-    // ============================================
-    // Resources Handler
-    // ============================================
-    server.setRequestHandler(ListResourcesRequestSchema, async () => {
-        return {
-            resources: resourceDefinitions,
-            resourceTemplates: resourceTemplates,
-        };
-    });
-    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-        const { uri } = request.params;
-        const client = stdioClient || new DobbyClient({ apiUrl, apiKey: '', tenantId: '' });
-        try {
-            return await handleResourceRead(uri, client);
-        }
-        catch (error) {
-            throw new Error(`Failed to read resource ${uri}: ${error.message}`);
-        }
-    });
-    // ============================================
-    // Prompts Handler
-    // ============================================
-    server.setRequestHandler(ListPromptsRequestSchema, async () => {
-        return {
-            prompts: promptDefinitions,
-        };
-    });
-    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-        const { name, arguments: args } = request.params;
-        try {
-            return handlePromptGet(name, args || {});
-        }
-        catch (error) {
-            throw new Error(`Failed to get prompt ${name}: ${error.message}`);
-        }
-    });
-    return server;
-}
-// ============================================
 // Main Entry Point
 // ============================================
 async function main() {
     // Handle setup mode
     if (options.setup) {
-        const { runInteractiveSetup } = await import('./connectors/setup.js');
+        const { runInteractiveSetup } = await import("./connectors/setup.js");
         await runInteractiveSetup();
         return;
     }
-    console.error('Starting Dobby MCP Server...');
-    console.error(`Transport: ${options.transport}`);
+    // Preflight: validate credentials + transport, print a diagnosis, then exit
+    if (options.doctor) {
+        const { runDoctor, formatDoctorReport } = await import("./doctor.js");
+        const report = await runDoctor({
+            apiUrl: options.apiUrl,
+            apiKey: options.apiKey,
+            tenantId: options.tenantId,
+            gatewayKey: options.gatewayKey,
+            transport: options.transport,
+        });
+        console.log(formatDoctorReport(report));
+        process.exit(report.blocked ? 1 : 0);
+    }
     try {
-        if (options.transport === 'stdio') {
+        if (options.transport === "stdio") {
+            // STDIO: stdout is the JSON-RPC protocol channel — ALL diagnostics stay
+            // on stderr (human-readable; MCP clients surface stderr as server logs).
+            // Route any shared log.* call there too so it can never corrupt stdout.
+            useStderrSink();
+            console.error("Starting Dobby MCP Server...");
+            console.error("Transport: stdio");
             // STDIO transport (for Claude Desktop, Cursor, etc.)
-            const server = await createServer({ mode: 'stdio' });
+            const server = await createServer({
+                mode: "stdio",
+                apiUrl: options.apiUrl,
+                apiKey: options.apiKey,
+                tenantId: options.tenantId,
+                gatewayKey: options.gatewayKey,
+                gatewayUrl: options.gatewayUrl,
+            });
             // Verify connection
             const client = createDobbyClient({
                 apiUrl: options.apiUrl,
@@ -234,33 +90,41 @@ async function main() {
             });
             const healthy = await client.checkHealth();
             if (!healthy) {
-                console.error('Warning: Could not connect to Dobby API');
+                console.error("Warning: Could not connect to Dobby API");
             }
             else {
-                console.error('Connected to Dobby API');
+                console.error("Connected to Dobby API");
             }
             // Gateway auth status
-            const gwKey = resolveGatewayKey({ gatewayKey: options.gatewayKey, apiKey: options.apiKey });
+            const gwKey = resolveGatewayKey({
+                gatewayKey: options.gatewayKey,
+                apiKey: options.apiKey,
+            });
             if (gwKey) {
                 console.error(`Gateway auth enabled (key prefix: ${gwKey.slice(0, 12)}...)`);
             }
             else {
-                console.error('Gateway auth disabled (no gateway key configured)');
+                console.error("Gateway auth disabled (no gateway key configured)");
             }
             const transport = new StdioServerTransport();
             await server.connect(transport);
-            console.error('Dobby MCP Server running on STDIO');
+            console.error("Dobby MCP Server running on STDIO");
         }
-        else if (options.transport === 'http') {
-            // HTTP transport (for remote clients via OAuth)
-            const issuerUrl = process.env.OAUTH_ISSUER_URL || options.apiUrl || 'https://dobby-ai.com';
+        else if (options.transport === "http") {
+            // HTTP transport (for remote clients via OAuth). Structured JSON on
+            // stdout — GKE ingests it at the declared severity (the old stderr
+            // banner landed at severity ERROR).
+            log.info("Starting Dobby MCP Server", { transport: "http" });
+            const issuerUrl = process.env.OAUTH_ISSUER_URL ||
+                options.apiUrl ||
+                "https://dobby-ai.com";
             const mcpPublicUrl = process.env.MCP_PUBLIC_URL || `http://localhost:${options.port}`;
             const port = parseInt(options.port, 10);
             await startHttpServer({
                 port,
                 issuerUrl,
                 mcpPublicUrl,
-                createMcpServer: () => createServer({ mode: 'http' }),
+                createMcpServer: () => createServer({ mode: "http", apiUrl: options.apiUrl }),
             });
         }
         else {
@@ -269,12 +133,12 @@ async function main() {
         }
     }
     catch (error) {
-        console.error('Failed to start server:', error.message);
+        console.error("Failed to start server:", error.message);
         process.exit(1);
     }
 }
 main().catch((error) => {
-    console.error('Fatal error:', error);
+    console.error("Fatal error:", error);
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAY,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,6BAA6B;AAC7B,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,+CAA+C;AAC/C,YAAY;AACZ,+CAA+C;AAE/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,wBAAwB,EAAE,+BAA+B,EAAE,OAAO,CAAC;KAC1E,MAAM,CAAC,qBAAqB,EAAE,uCAAuC,EAAE,MAAM,CAAC;KAC9E,MAAM,CAAC,iBAAiB,EAAE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;KACrE,MAAM,CAAC,iBAAiB,EAAE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;KACrE,MAAM,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;KAC1E,MAAM,CAAC,qBAAqB,EAAE,+BAA+B,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;KAC7F,MAAM,CAAC,qBAAqB,EAAE,uCAAuC,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;KACrG,MAAM,CAAC,SAAS,EAAE,uBAAuB,CAAC;KAC1C,KAAK,EAAE,CAAC;AAEX,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;AAE/B,+CAA+C;AAC/C,yBAAyB;AACzB,+CAA+C;AAE/C;;;GAGG;AACH,SAAS,iBAAiB,CAAC,IAA8C;IACvE,IAAI,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC,UAAU,CAAC;IAC5C,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IACrE,OAAO,SAAS,CAAC;AACnB,CAAC;AAWD;;;;;;GAMG;AACH,KAAK,UAAU,YAAY,CAAC,OAA4B,EAAE,IAAI,EAAE,OAAO,EAAE;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,sBAAsB,CAAC;IAErF,sDAAsD;IACtD,IAAI,WAAoC,CAAC;IACzC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,WAAW,GAAG,iBAAiB,CAAC;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,qBAAqB;IACrB,MAAM,WAAW,GAAG;QAClB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,UAAU;QAC/C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,UAAU;KACpD,CAAC;IAEF,6BAA6B;IAC7B,MAAM,UAAU,GAAG,iBAAiB,CAAC;QACnC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC;IAEhD,+CAA+C;IAC/C,gBAAgB;IAChB,+CAA+C;IAE/C,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QACzE,0DAA0D;QAC1D,6CAA6C;QAC7C,OAAO;YACL,KAAK,EAAE,kBAAkB,CAAC,YAAY,CAAC;SACxC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,IAAI,CAAC;YACH,IAAI,MAAmB,CAAC;YACxB,IAAI,MAAc,CAAC;YACnB,IAAI,QAAgB,CAAC;YACrB,IAAI,QAA4B,CAAC;YACjC,IAAI,MAA0B,CAAC;YAC/B,IAAI,KAAyB,CAAC;YAC9B,IAAI,KAAa,CAAC;YAElB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC3C,+CAA+C;gBAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,KAIrB,CAAC;gBAEd,MAAM,aAAa,GAAG,UAAU,EAAE,SAAS,CAAC;gBAC5C,MAAM,UAAU,GAAG,UAAU,EAAE,MAAM,CAAC;gBACtC,MAAM,WAAW,GAAG,UAAU,EAAE,OAAO,IAAI,YAAY,CAAC;gBAExD,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC;wBAClF,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBAED,wEAAwE;gBACxE,MAAM,GAAG,IAAI,WAAW,CAAC;oBACvB,MAAM;oBACN,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK;oBAC5B,QAAQ,EAAE,aAAa;iBACxB,CAAC,CAAC;gBAEH,MAAM,GAAG,WAAW,CAAC;gBACrB,QAAQ,GAAG,YAAY,CAAC;gBACxB,QAAQ,GAAG,aAAa,CAAC;gBACzB,MAAM,GAAG,SAAS,CAAC,CAAC,kCAAkC;gBACtD,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,mCAAmC;gBACjE,KAAK,GAAG,MAAM,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,4BAA4B;gBAC5B,MAAM,GAAG,WAAY,CAAC;gBACtB,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;gBAC5B,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;gBAChC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;gBAC3B,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;gBAClC,KAAK,GAAG,UAAU,CAAC;gBACnB,KAAK,GAAG,UAAU,CAAC;YACrB,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE;gBACpD,MAAM;gBACN,MAAM;gBACN,QAAQ;gBACR,UAAU,EAAE,KAAK;gBACjB,UAAU,EAAE,KAAK;gBACjB,QAAQ;gBACR,MAAM;aACP,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE;qBAChC;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,+CAA+C;IAC/C,oBAAoB;IACpB,+CAA+C;IAE/C,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QAC9D,OAAO;YACL,SAAS,EAAE,mBAAmB;YAC9B,iBAAiB,EAAE,iBAAiB;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,MAAM,MAAM,GAAG,WAAW,IAAI,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAEpF,IAAI,CAAC;YACH,OAAO,MAAM,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,+CAA+C;IAC/C,kBAAkB;IAClB,+CAA+C;IAE/C,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QAC5D,OAAO;YACL,OAAO,EAAE,iBAAiB;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,IAAI,CAAC;YACH,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,KAAK,UAAU,IAAI;IACjB,oBAAoB;IACpB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACtE,MAAM,mBAAmB,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,CAAC,cAAc,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;YAClC,qDAAqD;YACrD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAErD,oBAAoB;YACpB,MAAM,MAAM,GAAG,iBAAiB,CAAC;gBAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC1C,CAAC;YAED,sBAAsB;YACtB,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5F,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,qCAAqC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;YAC/E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAErD,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YACxC,gDAAgD;YAChD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,CAAC,MAAM,IAAI,sBAAsB,CAAC;YAC3F,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,oBAAoB,OAAO,CAAC,IAAI,EAAE,CAAC;YACtF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAExC,MAAM,eAAe,CAAC;gBACpB,IAAI;gBACJ,SAAS;gBACT,YAAY;gBACZ,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;aACtD,CAAC,CAAC;QAEL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,sBAAsB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/consts.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared constants for the Dobby MCP external server.
+ */
+/**
+ * Canonical production API host for the Dobby platform.
+ * Single source of truth for the default DOBBY_API_URL used by the client
+ * and every connector generator, to prevent host drift.
+ */
+export declare const DEFAULT_API_URL = "https://dobby-ai.com";
+/**
+ * Issued-key prefixes, the single source of truth for classifying a
+ * DOBBY_API_KEY / bearer token into what it can do. Reused by the `doctor`
+ * preflight and the `whoami` tool so both agree on key semantics.
+ */
+export declare const GATEWAY_KEY_PREFIXES: readonly ["gk_user_", "gk_svc_", "gk_tmp_"];
+export declare const TENANT_KEY_PREFIX = "sk_live_";
+export declare const PAT_KEY_PREFIX = "dobby_pat_";
+export type KeyType = "gateway" | "tenant" | "pat" | "unknown" | "none";
+/** Classify an API key / bearer token by prefix into its key family. */
+export declare function classifyKeyType(key: string | undefined | null): KeyType;
+//# sourceMappingURL=consts.d.ts.map

package/dist/lib/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/lib/consts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe,yBAAyB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,6CAA8C,CAAC;AAChF,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAC5C,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;AAExE,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAMvE"}

package/dist/lib/consts.js

@@ -0,0 +1,30 @@
+/**
+ * Shared constants for the Dobby MCP external server.
+ */
+/**
+ * Canonical production API host for the Dobby platform.
+ * Single source of truth for the default DOBBY_API_URL used by the client
+ * and every connector generator, to prevent host drift.
+ */
+export const DEFAULT_API_URL = "https://dobby-ai.com";
+/**
+ * Issued-key prefixes, the single source of truth for classifying a
+ * DOBBY_API_KEY / bearer token into what it can do. Reused by the `doctor`
+ * preflight and the `whoami` tool so both agree on key semantics.
+ */
+export const GATEWAY_KEY_PREFIXES = ["gk_user_", "gk_svc_", "gk_tmp_"];
+export const TENANT_KEY_PREFIX = "sk_live_";
+export const PAT_KEY_PREFIX = "dobby_pat_";
+/** Classify an API key / bearer token by prefix into its key family. */
+export function classifyKeyType(key) {
+    if (!key)
+        return "none";
+    if (GATEWAY_KEY_PREFIXES.some((p) => key.startsWith(p)))
+        return "gateway";
+    if (key.startsWith(TENANT_KEY_PREFIX))
+        return "tenant";
+    if (key.startsWith(PAT_KEY_PREFIX))
+        return "pat";
+    return "unknown";
+}
+//# sourceMappingURL=consts.js.map

package/dist/lib/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/lib/consts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAI3C,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,GAA8B;IAC5D,IAAI,CAAC,GAAG;QAAE,OAAO,MAAM,CAAC;IACxB,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1E,IAAI,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvD,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/dobby-client.d.ts

@@ -3,11 +3,23 @@
  *
  * Client for communicating with the Dobby API from the MCP server.
  */
-import { z } from 'zod';
+import { z } from "zod";
 export interface DobbyClientConfig {
     apiUrl: string;
     apiKey: string;
     tenantId: string;
+    organizationId?: string;
+    /**
+     * Static gateway key (gk_*) for gateway-scoped endpoints — STDIO mode
+     * (DOBBY_GATEWAY_KEY, or auto-detected when the API key is itself gk_*).
+     */
+    gatewayKey?: string;
+    /**
+     * Lazy gateway-key provider — HTTP mode. Resolves a tenant+user-bound
+     * gk_tmp_* key server-side from the session token (memoized per session by
+     * the caller). Takes precedence over `gatewayKey`.
+     */
+    getGatewayKey?: () => Promise<string | undefined>;
 }
 export declare const TaskSchema: z.ZodObject<{
     task_id: z.ZodString;
@@ -22,24 +34,24 @@ export declare const TaskSchema: z.ZodObject<{
     branch_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     result_summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
+    task_id: string;
     tenant_id: string;
+    title: string;
     description: string | null;
+    status: "pending" | "in_progress" | "completed" | "failed" | "cancelled";
     priority: "high" | "medium" | "low" | null;
-    title: string;
-    status: "completed" | "failed" | "cancelled" | "pending" | "in_progress";
-    task_id: string;
     created_at: string;
     updated_at: string;
     pr_url?: string | null | undefined;
     branch_name?: string | null | undefined;
     result_summary?: string | null | undefined;
 }, {
+    task_id: string;
     tenant_id: string;
+    title: string;
     description: string | null;
+    status: "pending" | "in_progress" | "completed" | "failed" | "cancelled";
     priority: "high" | "medium" | "low" | null;
-    title: string;
-    status: "completed" | "failed" | "cancelled" | "pending" | "in_progress";
-    task_id: string;
     created_at: string;
     updated_at: string;
     pr_url?: string | null | undefined;
@@ -56,54 +68,54 @@ export declare const MessageSchema: z.ZodObject<{
         name: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         type: "user" | "agent" | "system";
-        name: string;
         id: string;
+        name: string;
     }, {
         type: "user" | "agent" | "system";
-        name: string;
         id: string;
+        name: string;
     }>;
     message: z.ZodObject<{
         type: z.ZodString;
         content: z.ZodString;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     }, "strip", z.ZodTypeAny, {
-        content: string;
         type: string;
+        content: string;
         metadata?: Record<string, any> | undefined;
     }, {
-        content: string;
         type: string;
+        content: string;
         metadata?: Record<string, any> | undefined;
     }>;
     created_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    id: string;
     task_id: string;
     message: {
-        content: string;
         type: string;
+        content: string;
         metadata?: Record<string, any> | undefined;
     };
     created_at: string;
+    id: string;
     sender: {
         type: "user" | "agent" | "system";
-        name: string;
         id: string;
+        name: string;
     };
 }, {
-    id: string;
     task_id: string;
     message: {
-        content: string;
         type: string;
+        content: string;
         metadata?: Record<string, any> | undefined;
     };
     created_at: string;
+    id: string;
     sender: {
         type: "user" | "agent" | "system";
-        name: string;
         id: string;
+        name: string;
     };
 }>;
 export type Message = z.infer<typeof MessageSchema>;
@@ -117,20 +129,20 @@ export declare const ApprovalSchema: z.ZodObject<{
     created_at: z.ZodString;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, "strip", z.ZodTypeAny, {
+    task_id: string;
     description: string;
     status: "pending" | "approved" | "rejected";
-    id: string;
-    task_id: string;
     created_at: string;
+    id: string;
     approval_type: string;
     requested_by: string;
     metadata?: Record<string, any> | undefined;
 }, {
+    task_id: string;
     description: string;
     status: "pending" | "approved" | "rejected";
-    id: string;
-    task_id: string;
     created_at: string;
+    id: string;
     approval_type: string;
     requested_by: string;
     metadata?: Record<string, any> | undefined;
@@ -145,10 +157,25 @@ export declare class DobbyClient {
     get apiKey(): string;
     /** Tenant ID for scoped requests */
     get tenantId(): string;
+    /** Organization ID for org-scoped requests (e.g. memory stores) */
+    get organizationId(): string | undefined;
+    /** Static gateway key (gk_*), if configured — STDIO mode */
+    get gatewayKey(): string | undefined;
+    /**
+     * Bearer credential for GATEWAY-scoped endpoints (routes guarded by
+     * authenticateGatewayRequest hard-require a gk_* key — the tenant apiKey is
+     * NOT one for OAuth/sk_live_ sessions).
+     *
+     * Precedence: lazy provider (HTTP mode, resolved server-side from the
+     * session token) > static gatewayKey (STDIO) > apiKey (legacy fallback —
+     * only works when the API key is itself a gk_*).
+     */
+    gatewayBearer(): Promise<string>;
     private fetch;
     request<T = any>(endpoint: string, options?: RequestInit): Promise<T>;
     get<T = any>(endpoint: string): Promise<T>;
     post<T = any>(endpoint: string, body?: unknown): Promise<T>;
+    delete<T = any>(endpoint: string): Promise<T>;
     listTasks(options?: {
         status?: string;
         priority?: string;
@@ -159,7 +186,7 @@ export declare class DobbyClient {
     createTask(data: {
         title: string;
         description?: string;
-        priority?: 'high' | 'medium' | 'low';
+        priority?: "high" | "medium" | "low";
         link_to_task_id?: string;
     }): Promise<{
         task_id: string;
@@ -200,7 +227,7 @@ export declare class DobbyClient {
         message?: string;
     }>;
     listServices(options?: {
-        category?: 'all' | 'llm' | 'mcp_tools' | 'mcp_servers' | 'managed_services';
+        category?: "all" | "llm" | "mcp_tools" | "mcp_servers" | "managed_services";
     }): Promise<any>;
     createSchedule(data: {
         name: string;

package/dist/lib/dobby-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dobby-client.d.ts","sourceRoot":"","sources":["../../src/lib/dobby-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dobby-client.d.ts","sourceRoot":"","sources":["../../src/lib/dobby-client.ts"],"names":[],"mappings":"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"}