@inkeep/agents-manage-mcp 0.39.5 → 0.41.0

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.3",
   "name": "@inkeep/agents-manage-mcp",
-  "version": "0.0.12",
+  "version": "0.0.6",
   "description": "",
   "long_description": "Inkeep Agents Manage API: REST API for the management of the Inkeep Agent Framework.",
   "author": {
@@ -12,15 +12,64 @@
     "entry_point": "./bin/mcp-server.js",
     "mcp_config": {
       "command": "node",
-      "args": ["${__dirname}/bin/mcp-server.js", "start"]
+      "args": [
+        "${__dirname}/bin/mcp-server.js",
+        "start",
+        "--cookie-auth",
+        "${user_config.cookie_auth}",
+        "--bearer-auth",
+        "${user_config.bearer_auth}"
+      ]
     }
   },
   "display_name": "@inkeep/agents Manage Mcp",
+  "prompts": [],
+  "keywords": [
+    "@inkeep/agents",
+    "manage",
+    "mcp",
+    "inkeep",
+    "agents",
+    "api",
+    "rest"
+  ],
+  "user_config": {
+    "cookie_auth": {
+      "type": "string",
+      "title": "cookieAuth",
+      "description": "The cookieAuth to use for the request",
+      "required": true,
+      "sensitive": true
+    },
+    "bearer_auth": {
+      "type": "string",
+      "title": "bearerAuth",
+      "description": "The bearerAuth to use for the request",
+      "required": true,
+      "sensitive": true
+    }
+  },
   "tools": [
     {
       "name": "health",
       "description": "Health check\n\nCheck if the management service is healthy"
     },
+    {
+      "name": "user-organizations-get-api-users-user-id-organizations",
+      "description": "List user organizations\n\nGet all organizations associated with a user"
+    },
+    {
+      "name": "user-organizations-post-api-users-user-id-organizations",
+      "description": "Add user to organization\n\nAssociate a user with an organization"
+    },
+    {
+      "name": "cli-get-api-cli-me",
+      "description": "Get CLI user info\n\nGet the current authenticated user and their organization for CLI usage"
+    },
+    {
+      "name": "invitations-get-api-invitations-pending",
+      "description": "Get pending invitations\n\nGet all pending (non-expired) invitations for a given email address"
+    },
     {
       "name": "projects-list-projects",
       "description": "List Projects\n\nList all projects within a tenant with pagination"
@@ -385,6 +434,10 @@
       "name": "tools-delete-tool",
       "description": "Delete Tool"
     },
+    {
+      "name": "tools-get-user-credential-for-tool",
+      "description": "Get User Credential for Tool"
+    },
     {
       "name": "API-keys-list-api-keys",
       "description": "List API Keys\n\nList all API keys for a tenant with optional pagination"
@@ -429,6 +482,10 @@
       "name": "third-party-MCP-servers-get-third-party-mcp-server",
       "description": "Get Third-Party MCP Server Details\n\nFetch details for a specific third-party MCP server (e.g., Composio) including authentication status and connect URL"
     },
+    {
+      "name": "third-party-MCP-servers-get-oauth-redirect-url",
+      "description": "Get OAuth Redirect URL\n\nGet the OAuth redirect URL for a third-party MCP server. Call this after scope selection to get the correct URL for the selected scope."
+    },
     {
       "name": "full-project-create-full-project",
       "description": "Create Full Project\n\nCreate a complete project with all Agents, Sub Agents, tools, and relationships from JSON definition"
@@ -453,7 +510,5 @@
       "name": "O-auth-oauth-callback",
       "description": "OAuth authorization callback\n\nHandles OAuth authorization codes and completes the authentication flow"
     }
-  ],
-  "prompts": [],
-  "keywords": ["@inkeep/agents", "manage", "mcp", "inkeep", "agents", "api", "rest"]
-}
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-manage-mcp",
-  "version": "0.39.5",
+  "version": "0.41.0",
   "author": "Speakeasy",
   "type": "module",
   "sideEffects": false,
@@ -9,25 +9,28 @@
     "mcp": "bin/mcp-server.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.17.0",
     "@stricli/core": "^1.1.2",
     "bun": "^1.2.12",
-    "express": "^5.1.0"
+    "express": "^5.1.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^1.2.0",
     "@eslint/js": "^9.26.0",
     "@types/bun": "^1.2.13",
     "@types/express": "^5.0.1",
-    "@types/node": "^22.15.20",
-    "dotenv": "^16.4.7",
+    "@types/node": "^18.19.3",
+    "@modelcontextprotocol/sdk": "1.24.3",
     "eslint": "^9.26.0",
-    "find-up": "^7.0.0",
     "globals": "^16.0.0",
     "tsdown": "^0.18.0",
     "typescript": "~5.8.3",
     "typescript-eslint": "^8.31.1",
-    "zod": "^3.25.7"
+    "dotenv": "^16.4.7",
+    "find-up": "^7.0.0"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "1.24.3"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -50,12 +53,9 @@
   },
   "scripts": {
     "build": "bun i && bun src/mcp-server/build.mts && tsdown",
+    "mcpb:build": "bun i && bun src/mcp-server/build.mts --pack && tsdown",
     "check": "npm run lint",
     "lint": "eslint --cache --max-warnings=0 src",
-    "format": "biome format --write src",
-    "format:check": "biome format src",
-    "fetch-openapi": "node scripts/fetch-openapi.mjs",
-    "generate": "node scripts/generate.mjs",
-    "watch": "node scripts/watch-and-fetch.mjs"
+    "generate": "node scripts/generate.mjs"
   }
 }

package/scripts/fetch-openapi.mjs

@@ -22,7 +22,7 @@ if (fs.existsSync(packageEnv)) {
 
 const apiUrl = process.env.INKEEP_AGENTS_MANAGE_API_URL || 'http://localhost:3002';
 const openapiUrl = `${apiUrl}/openapi.json`;
-const outputPath = path.resolve(__dirname, '../openapi.json');
+const pidFile = path.resolve(__dirname, '../.speakeasy/manage-api.pid');
 
 async function checkApiRunning() {
   try {
@@ -48,11 +48,13 @@ async function startManageApi() {
   return new Promise((resolve, reject) => {
     const proc = spawn('pnpm', ['--filter', '@inkeep/agents-manage-api', 'dev'], {
       cwd: rootDir,
-      stdio: 'inherit',
-      detached: false,
+      stdio: 'ignore',
+      detached: true,
       shell: true,
     });
 
+    proc.unref();
+
     proc.on('error', (err) => {
       reject(new Error(`Failed to start manage-api: ${err.message}`));
     });
@@ -70,65 +72,45 @@ async function startManageApi() {
         resolve(proc);
       } else if (attempts >= maxAttempts) {
         clearInterval(checkInterval);
-        proc.kill();
+        try {
+          process.kill(-proc.pid, 'SIGTERM');
+        } catch {
+          // best-effort cleanup
+        }
         reject(new Error('Timeout waiting for manage-api to start'));
       }
     }, 1000);
   });
 }
 
-async function fetchOpenApiSpec() {
-  console.log(`Fetching OpenAPI spec from: ${openapiUrl}`);
-  console.log(`Writing to: ${outputPath}\n`);
-
-  try {
-    const response = await fetch(openapiUrl);
-
-    if (!response.ok) {
-      const errorText = await response.text().catch(() => '');
-      throw new Error(
-        `Failed to fetch OpenAPI spec: ${response.status} ${response.statusText}${errorText ? `\n${errorText}` : ''}`
-      );
-    }
-
-    const openapiJson = await response.json();
-
-    // Write the JSON file with proper formatting
-    fs.writeFileSync(outputPath, JSON.stringify(openapiJson, null, 2) + '\n', 'utf8');
-
-    console.log('✓ Successfully fetched and wrote OpenAPI spec');
-  } catch (error) {
-    throw error;
-  }
-}
-
 async function main() {
   try {
     // Check if manage-api is already running
     const isRunning = await checkApiRunning();
 
+    // Clear any stale pid file
+    if (fs.existsSync(pidFile)) {
+      fs.rmSync(pidFile);
+    }
+
     if (!isRunning) {
       console.log('⚠️  agents-manage-api is not running');
       console.log('💡 To avoid auto-starting, run: pnpm --filter @inkeep/agents-manage-api dev\n');
 
       const manageApiProc = await startManageApi();
 
-      try {
-        await fetchOpenApiSpec();
-      } finally {
-        // Clean up: stop the manage-api we started
-        console.log('\n🛑 Stopping agents-manage-api...');
-        manageApiProc.kill('SIGTERM');
+      // Record the process id so callers can shut it down after generation
+      fs.mkdirSync(path.dirname(pidFile), { recursive: true });
+      fs.writeFileSync(pidFile, String(manageApiProc.pid), 'utf8');
 
-        // Give it a moment to shut down gracefully
-        await new Promise((resolve) => setTimeout(resolve, 1000));
-      }
+      console.log(`PID recorded at ${pidFile}`);
+      console.log('Manage API will remain running until the caller stops it.\n');
     } else {
-      await fetchOpenApiSpec();
+      console.log('✓ agents-manage-api already running. No action needed.\n');
     }
   } catch (error) {
     if (error.cause) {
-      console.error('\n✗ Error fetching OpenAPI spec:', error.message);
+      console.error('\n✗ Error ensuring manage-api is running:', error.message);
       console.error('  Cause:', error.cause.message || error.cause);
       console.error(`\n  Make sure ${apiUrl} is running and accessible.`);
     } else {

package/scripts/generate.mjs

@@ -1,33 +1,11 @@
 import { spawn } from 'node:child_process';
-import { readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, rmSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-const PRESERVED_FIELDS = {
-  main: './esm/index.js',
-  types: './esm/index.d.ts',
-  exports: {
-    '.': {
-      types: './esm/index.d.ts',
-      import: './esm/index.js',
-    },
-  },
-  scripts: {
-    format: 'biome format --write src',
-    'format:check': 'biome format src',
-    'fetch-openapi': 'node scripts/fetch-openapi.mjs',
-    generate: 'node scripts/generate.mjs',
-    watch: 'node scripts/watch-and-fetch.mjs',
-  },
-  devDependencies: {
-    dotenv: '^16.4.7',
-    'find-up': '^7.0.0',
-  },
-};
-
 function runCommand(command, args = [], options = {}) {
   return new Promise((resolve, reject) => {
     const proc = spawn(command, args, {
@@ -59,39 +37,42 @@ async function checkSpeakeasyInstalled() {
   }
 }
 
-function restorePackageJsonFields() {
-  const packageJsonPath = path.resolve(__dirname, '../package.json');
-  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
-
-  // Add back preserved fields
-  packageJson.main = PRESERVED_FIELDS.main;
-  packageJson.types = PRESERVED_FIELDS.types;
-  packageJson.exports = PRESERVED_FIELDS.exports;
-
-  // Merge scripts (preserving existing ones from speakeasy)
-  packageJson.scripts = {
-    ...packageJson.scripts,
-    ...PRESERVED_FIELDS.scripts,
-  };
-
-  // Merge devDependencies (preserving existing ones from speakeasy)
-  packageJson.devDependencies = {
-    ...packageJson.devDependencies,
-    ...PRESERVED_FIELDS.devDependencies,
-  };
-
-  writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n', 'utf8');
-  console.log('✓ Restored custom fields to package.json\n');
+const pidFile = path.resolve(__dirname, '../.speakeasy/manage-api.pid');
+
+async function stopManageApiIfStarted() {
+  if (!existsSync(pidFile)) {
+    return;
+  }
+
+  const pidValue = readFileSync(pidFile, 'utf8').trim();
+  const pid = Number(pidValue);
+
+  rmSync(pidFile, { force: true });
+
+  if (!Number.isFinite(pid)) {
+    return;
+  }
+
+  // Kill process group (detached) and then direct pid as fallback
+  try {
+    process.kill(-pid, 'SIGTERM');
+  } catch {}
+
+  try {
+    process.kill(pid, 'SIGTERM');
+  } catch {}
+
+  console.log('🛑 Stopped agents-manage-api that was started for generation\n');
 }
 
 async function main() {
-  console.log('🔄 Step 1: Fetching OpenAPI spec...\n');
+  console.log('🔄 Step 1: Ensuring agents-manage-api is running...\n');
 
   try {
     await runCommand('node', [path.resolve(__dirname, './fetch-openapi.mjs')]);
-    console.log('\n✓ OpenAPI spec fetched successfully\n');
+    console.log('\n✓ agents-manage-api is ready\n');
   } catch (error) {
-    console.error('✗ Failed to fetch OpenAPI spec:', error.message);
+    console.error('✗ Failed to start or detect agents-manage-api:', error.message);
     process.exit(1);
   }
 
@@ -119,29 +100,15 @@ async function main() {
     console.log('\n✓ Successfully generated MCP server code\n');
   } catch (error) {
     console.error('\n✗ Speakeasy generation failed:', error.message);
+    await stopManageApiIfStarted();
     process.exit(1);
   }
-
-  console.log('🔄 Step 4: Restoring custom fields to package.json...\n');
-  restorePackageJsonFields();
-
-  console.log('🔄 Step 5: Running Biome to format code...\n');
-
-  try {
-    const packageDir = path.resolve(__dirname, '..');
-    const rootDir = path.resolve(packageDir, '../..');
-    const relativeSrcPath = path.relative(rootDir, path.join(packageDir, 'src'));
-    await runCommand('pnpm', ['biome', 'format', '--write', relativeSrcPath], { cwd: rootDir });
-    console.log('✓ Biome formatting applied successfully\n');
-  } catch {
-    console.log('⚠️  Biome formatting had issues (some manual fixes may be needed)');
-    console.log('  To format manually: pnpm biome format --write packages/agents-manage-mcp/src\n');
-  }
-
+  await stopManageApiIfStarted();
   console.log('✅ Generation complete!');
 }
 
 main().catch((error) => {
   console.error('Unexpected error:', error);
+  stopManageApiIfStarted().catch(() => {});
   process.exit(1);
 });

package/src/core.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a820f9ae298b
  */
 
 import { ClientSDK } from './lib/sdks.js';
@@ -10,4 +11,5 @@ import { ClientSDK } from './lib/sdks.js';
  * application and passed around through some dependency injection mechanism  to
  * parts of an application that need to make SDK calls.
  */
-export class InkeepAgentsCore extends ClientSDK {}
+export class InkeepAgentsManageCore extends ClientSDK {}
+export { InkeepAgentsManageCore as InkeepAgentsCore };