api-helpers.ts — mcp Source File

Source Code

/**
 * Shared utilities for API operations across graph tools.
 * Extracted to eliminate code duplication between graph-tools.ts and create-supermodel-graph.ts.
 */

import { execSync } from 'child_process';
import { createHash } from 'crypto';
import { basename, resolve } from 'path';
import { StructuredError } from '../types';

const REPORT_REPO = 'https://github.com/supermodeltools/mcp.git';
const REPORT_SUGGESTION = 'This may be a bug in the MCP server. You can help by opening an issue at https://github.com/supermodeltools/mcp/issues with the error details, or fork the repo and open a PR with a fix.';

/**
 * Generate an idempotency key in format {repo}-{pathHash}:{graphType}:{hash}
 * Includes path hash to prevent collisions between same-named repos
 */
export function generateIdempotencyKey(directory: string, graphType = 'supermodel'): string {
  const repoName = basename(directory);
  const absolutePath = resolve(directory);

  // Always include path hash to prevent collisions
  const pathHash = createHash('sha1').update(absolutePath).digest('hex').substring(0, 7);

  let hash: string;
  let statusHash = '';

  try {
    // Get git commit hash
    hash = execSync('git rev-parse --short HEAD', {
      cwd: directory,
      encoding: 'utf-8',
    }).trim();

    // Include working tree status in hash to detect uncommitted changes
    const statusOutput = execSync('git status --porcelain', {
      cwd: directory,
      encoding: 'utf-8',
    }).toString();

    if (statusOutput) {
      // Create hash of status output
      statusHash = '-' + createHash('sha1')
        .update(statusOutput)
        .digest('hex')
        .substring(0, 7);
    }
  } catch {
    // Fallback for non-git directories: use path hash as main identifier
    hash = pathHash;
  }

  return `${repoName}-${pathHash}:${graphType}:${hash}${statusHash}`;
}

/**
 * Classify an API error into a structured error response.
 * Extracts HTTP status, network conditions, and timeout signals
 * to produce an agent-actionable error with recovery guidance.
 */
// ... (134 more lines)