latitude-mcp-server 1.0.0

package/dist/types/latitude.types.js

@@ -0,0 +1,311 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateLogInputSchema = exports.StopConversationInputSchema = exports.GetConversationInputSchema = exports.ChatInputSchema = exports.PushChangesInputSchema = exports.RunPromptInputSchema = exports.PushPromptFromFileInputSchema = exports.PushPromptInputSchema = exports.GetPromptInputSchema = exports.ListPromptsInputSchema = exports.PublishVersionInputSchema = exports.CreateVersionInputSchema = exports.GetVersionInputSchema = exports.ListVersionsInputSchema = exports.CreateProjectInputSchema = exports.ListProjectsInputSchema = exports.LatitudeErrorSchema = exports.StreamEventSchema = exports.StreamEventTypeEnum = exports.CreateLogRequestSchema = exports.ChatRequestSchema = exports.ConversationSchema = exports.MessageSchema = exports.ContentPartSchema = exports.FileContentSchema = exports.ImageContentSchema = exports.TextContentSchema = exports.MessageRoleEnum = exports.RunRequestSchema = exports.RunSourceEnum = exports.PushChangesSchema = exports.DocumentChangeSchema = exports.ChangeStatusEnum = exports.DocumentListSchema = exports.DocumentSchema = exports.ParameterTypeSchema = exports.ProviderEnum = exports.VersionListSchema = exports.VersionSchema = exports.ProjectListSchema = exports.ProjectSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Latitude API Types and Zod Schemas
+ *
+ * Based on OpenAPI spec from openapi.json
+ * API Version: 1.0.2
+ * Base URL: https://gateway.latitude.so
+ */
+// ============================================================================
+// Project Types
+// ============================================================================
+exports.ProjectSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    name: zod_1.z.string(),
+    workspaceId: zod_1.z.number(),
+    createdAt: zod_1.z.string(),
+    updatedAt: zod_1.z.string(),
+    lastEditedAt: zod_1.z.string().optional(),
+    deletedAt: zod_1.z.string().nullable().optional(),
+});
+exports.ProjectListSchema = zod_1.z.array(exports.ProjectSchema);
+// ============================================================================
+// Version Types
+// ============================================================================
+exports.VersionSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    uuid: zod_1.z.string(),
+    title: zod_1.z.string(),
+    description: zod_1.z.string().nullable(),
+    projectId: zod_1.z.number(),
+    version: zod_1.z.number().nullable(),
+    userId: zod_1.z.string(),
+    mergedAt: zod_1.z.string().nullable(),
+    createdAt: zod_1.z.string(),
+    updatedAt: zod_1.z.string(),
+    deletedAt: zod_1.z.string().nullable(),
+    status: zod_1.z.string().optional(),
+    message: zod_1.z.string().optional(),
+    authorName: zod_1.z.string().nullable().optional(),
+    authorEmail: zod_1.z.string().nullable().optional(),
+    authorId: zod_1.z.number().nullable().optional(),
+    parentCommitUuid: zod_1.z.string().nullable().optional(),
+});
+exports.VersionListSchema = zod_1.z.array(exports.VersionSchema);
+// ============================================================================
+// Document/Prompt Types
+// ============================================================================
+exports.ProviderEnum = zod_1.z.enum([
+    'openai',
+    'anthropic',
+    'groq',
+    'mistral',
+    'azure',
+    'google',
+    'google_vertex',
+    'anthropic_vertex',
+    'custom',
+    'xai',
+    'amazon_bedrock',
+    'deepseek',
+    'perplexity',
+]);
+exports.ParameterTypeSchema = zod_1.z.object({
+    type: zod_1.z.enum(['text', 'image', 'file']),
+});
+exports.DocumentSchema = zod_1.z.object({
+    versionUuid: zod_1.z.string(),
+    uuid: zod_1.z.string(),
+    path: zod_1.z.string(),
+    content: zod_1.z.string(),
+    contentHash: zod_1.z.string().optional(),
+    config: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    parameters: zod_1.z.record(zod_1.z.string(), exports.ParameterTypeSchema).optional(),
+    provider: exports.ProviderEnum.optional(),
+});
+exports.DocumentListSchema = zod_1.z.array(exports.DocumentSchema);
+// ============================================================================
+// Document Change Types (for Push)
+// ============================================================================
+exports.ChangeStatusEnum = zod_1.z.enum(['added', 'modified', 'deleted', 'unchanged']);
+exports.DocumentChangeSchema = zod_1.z.object({
+    path: zod_1.z.string(),
+    content: zod_1.z.string(),
+    status: exports.ChangeStatusEnum.default('modified'),
+    contentHash: zod_1.z.string().optional(),
+});
+exports.PushChangesSchema = zod_1.z.object({
+    changes: zod_1.z.array(exports.DocumentChangeSchema),
+});
+// ============================================================================
+// Run/Execute Types
+// ============================================================================
+exports.RunSourceEnum = zod_1.z.enum([
+    'api',
+    'agent_as_tool',
+    'copilot',
+    'email_trigger',
+    'evaluation',
+    'experiment',
+    'integration_trigger',
+    'playground',
+    'scheduled_trigger',
+    'shared_prompt',
+    'user',
+]);
+exports.RunRequestSchema = zod_1.z.object({
+    path: zod_1.z.string(),
+    stream: zod_1.z.boolean().default(false),
+    customIdentifier: zod_1.z.string().optional(),
+    parameters: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    tools: zod_1.z.array(zod_1.z.string()).optional(),
+    userMessage: zod_1.z.string().optional(),
+    background: zod_1.z.boolean().optional(),
+    __internal: zod_1.z
+        .object({
+        source: exports.RunSourceEnum.optional(),
+    })
+        .optional(),
+});
+// ============================================================================
+// Conversation Types
+// ============================================================================
+exports.MessageRoleEnum = zod_1.z.enum(['system', 'user', 'assistant', 'tool']);
+exports.TextContentSchema = zod_1.z.object({
+    type: zod_1.z.literal('text'),
+    text: zod_1.z.string(),
+});
+exports.ImageContentSchema = zod_1.z.object({
+    type: zod_1.z.literal('image'),
+    image: zod_1.z.string(),
+    mimeType: zod_1.z.string().optional(),
+});
+exports.FileContentSchema = zod_1.z.object({
+    type: zod_1.z.literal('file'),
+    file: zod_1.z.string(),
+    mimeType: zod_1.z.string(),
+});
+exports.ContentPartSchema = zod_1.z.union([
+    exports.TextContentSchema,
+    exports.ImageContentSchema,
+    exports.FileContentSchema,
+]);
+exports.MessageSchema = zod_1.z.object({
+    role: exports.MessageRoleEnum,
+    content: zod_1.z.union([zod_1.z.string(), zod_1.z.array(exports.ContentPartSchema)]),
+    name: zod_1.z.string().optional(),
+});
+exports.ConversationSchema = zod_1.z.object({
+    uuid: zod_1.z.string(),
+    messages: zod_1.z.array(exports.MessageSchema).optional(),
+    createdAt: zod_1.z.string().optional(),
+    updatedAt: zod_1.z.string().optional(),
+});
+// ============================================================================
+// Chat Types
+// ============================================================================
+exports.ChatRequestSchema = zod_1.z.object({
+    messages: zod_1.z.array(exports.MessageSchema),
+    stream: zod_1.z.boolean().default(false),
+});
+// ============================================================================
+// Log Types
+// ============================================================================
+exports.CreateLogRequestSchema = zod_1.z.object({
+    path: zod_1.z.string(),
+    messages: zod_1.z.array(exports.MessageSchema),
+});
+// ============================================================================
+// Streaming Event Types
+// ============================================================================
+exports.StreamEventTypeEnum = zod_1.z.enum([
+    'text-delta',
+    'step-complete',
+    'provider-event',
+    'tool-call-started',
+    'tool-call',
+    'chain-complete',
+    'chain-error',
+]);
+exports.StreamEventSchema = zod_1.z.object({
+    event: exports.StreamEventTypeEnum,
+    data: zod_1.z.any(),
+});
+// ============================================================================
+// Error Types
+// ============================================================================
+exports.LatitudeErrorSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    errorCode: zod_1.z.string(),
+    message: zod_1.z.string(),
+    details: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+});
+// ============================================================================
+// Tool Input Schemas (for MCP tools)
+// ============================================================================
+// Project tools
+exports.ListProjectsInputSchema = zod_1.z.object({});
+exports.CreateProjectInputSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Project name'),
+});
+// Version tools
+exports.ListVersionsInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+});
+exports.GetVersionInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    versionUuid: zod_1.z.string().describe('Version UUID'),
+});
+exports.CreateVersionInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    name: zod_1.z.string().describe('Version/commit name'),
+});
+exports.PublishVersionInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    versionUuid: zod_1.z.string().describe('Version UUID to publish'),
+    title: zod_1.z.string().optional().describe('Publication title'),
+    description: zod_1.z.string().optional().describe('Publication description'),
+});
+// Document/Prompt tools
+exports.ListPromptsInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    versionUuid: zod_1.z
+        .string()
+        .default('live')
+        .describe("Version UUID or 'live' for published version"),
+});
+exports.GetPromptInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    versionUuid: zod_1.z.string().default('live').describe("Version UUID or 'live'"),
+    path: zod_1.z
+        .string()
+        .describe("Prompt path (e.g., '/my-prompt' or 'folder/prompt')"),
+});
+exports.PushPromptInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    versionUuid: zod_1.z
+        .string()
+        .describe("Target version UUID (must be draft, not 'live')"),
+    path: zod_1.z.string().describe('Prompt path'),
+    content: zod_1.z.string().describe('Prompt content in PromptL format'),
+    force: zod_1.z.boolean().default(false).describe('Force overwrite if exists'),
+});
+exports.PushPromptFromFileInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    versionUuid: zod_1.z
+        .string()
+        .describe("Target version UUID (must be draft, not 'live')"),
+    filePath: zod_1.z
+        .string()
+        .describe('Absolute path to the prompt file (e.g., /path/to/my-prompt.md)'),
+    promptPath: zod_1.z
+        .string()
+        .optional()
+        .describe("Optional: Prompt path in Latitude. If omitted, derived from filename (e.g., 'my-prompt.md' → 'my-prompt')"),
+    force: zod_1.z.boolean().default(false).describe('Force overwrite if exists'),
+});
+exports.RunPromptInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    versionUuid: zod_1.z.string().default('live').describe("Version UUID or 'live'"),
+    path: zod_1.z.string().describe('Prompt path to run'),
+    parameters: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.unknown())
+        .optional()
+        .describe('Prompt parameters as key-value pairs'),
+    stream: zod_1.z.boolean().default(false).describe('Enable streaming response'),
+    tools: zod_1.z.array(zod_1.z.string()).optional().describe('Tool names to enable'),
+    userMessage: zod_1.z.string().optional().describe('Additional user message'),
+});
+exports.PushChangesInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    versionUuid: zod_1.z.string().describe('Target version UUID'),
+    changes: zod_1.z
+        .array(zod_1.z.object({
+        path: zod_1.z.string().describe('Document path'),
+        content: zod_1.z.string().describe('Document content'),
+        status: zod_1.z
+            .enum(['added', 'modified', 'deleted'])
+            .default('modified')
+            .describe('Change status'),
+    }))
+        .describe('Array of document changes'),
+});
+// Conversation tools
+exports.ChatInputSchema = zod_1.z.object({
+    conversationUuid: zod_1.z
+        .string()
+        .describe('Conversation UUID from previous run'),
+    message: zod_1.z.string().describe('User message to send'),
+    stream: zod_1.z.boolean().default(false).describe('Enable streaming response'),
+});
+exports.GetConversationInputSchema = zod_1.z.object({
+    conversationUuid: zod_1.z.string().describe('Conversation UUID'),
+});
+exports.StopConversationInputSchema = zod_1.z.object({
+    conversationUuid: zod_1.z.string().describe('Conversation UUID to stop'),
+});
+// Log tools
+exports.CreateLogInputSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('Project ID'),
+    versionUuid: zod_1.z.string().describe('Version UUID'),
+    path: zod_1.z.string().describe('Prompt path'),
+    messages: zod_1.z
+        .array(zod_1.z.object({
+        role: zod_1.z.enum(['system', 'user', 'assistant']),
+        content: zod_1.z.string(),
+    }))
+        .describe('Conversation messages to log'),
+});

package/dist/utils/cli.test.util.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Utility for testing CLI commands with real execution
+ */
+export declare class CliTestUtil {
+    /**
+     * Executes a CLI command and returns the result
+     *
+     * @param args - CLI arguments to pass to the command
+     * @param options - Test options
+     * @returns Promise with stdout, stderr, and exit code
+     */
+    static runCommand(args: string[], options?: {
+        timeoutMs?: number;
+        env?: Record<string, string>;
+    }): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    /**
+     * Validates that stdout contains expected strings/patterns
+     */
+    static validateOutputContains(output: string, expectedPatterns: (string | RegExp)[]): void;
+    /**
+     * Validates TOON output format
+     * TOON uses "key: value" syntax for objects
+     */
+    static validateToonOutput(output: string): void;
+    /**
+     * Validates Markdown output format
+     * @deprecated Use validateToonOutput for new code - output is now TOON by default
+     */
+    static validateMarkdownOutput(output: string): void;
+}

package/dist/utils/cli.test.util.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliTestUtil = void 0;
+const child_process_1 = require("child_process");
+const path_1 = require("path");
+/**
+ * Utility for testing CLI commands with real execution
+ */
+class CliTestUtil {
+    /**
+     * Executes a CLI command and returns the result
+     *
+     * @param args - CLI arguments to pass to the command
+     * @param options - Test options
+     * @returns Promise with stdout, stderr, and exit code
+     */
+    static async runCommand(args, options = {}) {
+        // Default timeout of 30 seconds
+        const timeoutMs = options.timeoutMs || 30000;
+        // CLI execution path - points to the built CLI script
+        const cliPath = (0, path_1.join)(process.cwd(), 'dist', 'index.js');
+        // Log what command we're about to run
+        console.log(`Running CLI command: node ${cliPath} ${args.join(' ')}`);
+        return new Promise((resolve, reject) => {
+            // Set up timeout handler
+            const timeoutId = setTimeout(() => {
+                child.kill();
+                reject(new Error(`CLI command timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            // Capture stdout and stderr
+            let stdout = '';
+            let stderr = '';
+            // Spawn the process with given arguments and enhanced environment
+            const child = (0, child_process_1.spawn)('node', [cliPath, ...args], {
+                env: {
+                    ...process.env,
+                    ...options.env,
+                    DEBUG: 'true', // Enable debug logging
+                    NODE_ENV: 'test', // Ensure tests are detected
+                },
+            });
+            // Collect stdout data
+            child.stdout.on('data', (data) => {
+                const chunk = data.toString();
+                stdout += chunk;
+                console.log(`STDOUT chunk: ${chunk.substring(0, 50)}...`);
+            });
+            // Collect stderr data
+            child.stderr.on('data', (data) => {
+                const chunk = data.toString();
+                stderr += chunk;
+                console.log(`STDERR chunk: ${chunk.substring(0, 50)}...`);
+            });
+            // Handle process completion
+            child.on('close', (exitCode) => {
+                clearTimeout(timeoutId);
+                console.log(`Command completed with exit code: ${exitCode}`);
+                console.log(`Total STDOUT length: ${stdout.length} chars`);
+                // Get the non-debug output for debugging purposes
+                const nonDebugOutput = stdout
+                    .split('\n')
+                    .filter((line) => !line.match(/^\[\d{2}:\d{2}:\d{2}\]/))
+                    .join('\n');
+                console.log(`Non-debug output length: ${nonDebugOutput.length} chars`);
+                console.log(`STDOUT excerpt: ${stdout.substring(0, 100)}...`);
+                console.log(`Filtered excerpt: ${nonDebugOutput.substring(0, 100)}...`);
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: exitCode ?? 0,
+                });
+            });
+            // Handle process errors
+            child.on('error', (err) => {
+                clearTimeout(timeoutId);
+                console.error(`Command error: ${err.message}`);
+                reject(err);
+            });
+        });
+    }
+    /**
+     * Validates that stdout contains expected strings/patterns
+     */
+    static validateOutputContains(output, expectedPatterns) {
+        // Filter out debug log lines for cleaner validation
+        const cleanOutput = output
+            .split('\n')
+            .filter((line) => !line.match(/^\[\d{2}:\d{2}:\d{2}\]/))
+            .join('\n');
+        console.log('==== Cleaned output for validation ====');
+        console.log(cleanOutput);
+        console.log('=======================================');
+        for (const pattern of expectedPatterns) {
+            if (typeof pattern === 'string') {
+                expect(cleanOutput).toContain(pattern);
+            }
+            else {
+                expect(cleanOutput).toMatch(pattern);
+            }
+        }
+    }
+    /**
+     * Validates TOON output format
+     * TOON uses "key: value" syntax for objects
+     */
+    static validateToonOutput(output) {
+        // Filter out debug log lines for cleaner validation
+        const cleanOutput = output
+            .split('\n')
+            .filter((line) => !line.match(/^\[\d{2}:\d{2}:\d{2}\]/))
+            .join('\n');
+        // TOON format characteristics:
+        // - Key-value pairs in "key: value" format
+        // - No curly braces for objects
+        // - Arrays use [count]{fields}: notation
+        const toonPatterns = [
+            /^\w+:\s*.+/m, // key: value pattern
+        ];
+        expect(toonPatterns.some((pattern) => pattern.test(cleanOutput))).toBe(true);
+    }
+    /**
+     * Validates Markdown output format
+     * @deprecated Use validateToonOutput for new code - output is now TOON by default
+     */
+    static validateMarkdownOutput(output) {
+        // Filter out debug log lines for cleaner validation
+        const cleanOutput = output
+            .split('\n')
+            .filter((line) => !line.match(/^\[\d{2}:\d{2}:\d{2}\]/))
+            .join('\n');
+        // Check for Markdown heading
+        expect(cleanOutput).toMatch(/^#\s.+/m);
+        // Check for markdown formatting elements like bold text, lists, etc.
+        const markdownElements = [
+            /\*\*.+\*\*/, // Bold text
+            /-\s.+/, // List items
+            /\|.+\|.+\|/, // Table rows
+            /\[.+\]\(.+\)/, // Links
+        ];
+        expect(markdownElements.some((pattern) => pattern.test(cleanOutput))).toBe(true);
+    }
+}
+exports.CliTestUtil = CliTestUtil;

package/dist/utils/config.util.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Configuration loader that handles multiple sources with priority:
+ * 1. Direct ENV pass (process.env)
+ * 2. .env file in project root
+ * 3. Global config file at $HOME/.mcp/configs.json
+ */
+declare class ConfigLoader {
+    private packageName;
+    private configLoaded;
+    /**
+     * Create a new ConfigLoader instance
+     * @param packageName The package name to use for global config lookup
+     */
+    constructor(packageName: string);
+    /**
+     * Load configuration from all sources with proper priority
+     */
+    load(): void;
+    /**
+     * Load configuration from .env file in project root
+     */
+    private loadFromEnvFile;
+    /**
+     * Load configuration from global config file at $HOME/.mcp/configs.json
+     */
+    private loadFromGlobalConfig;
+    /**
+     * Get a configuration value
+     * @param key The configuration key
+     * @param defaultValue The default value if the key is not found
+     * @returns The configuration value or the default value
+     */
+    get(key: string, defaultValue?: string): string | undefined;
+    /**
+     * Get a boolean configuration value
+     * @param key The configuration key
+     * @param defaultValue The default value if the key is not found
+     * @returns The boolean configuration value or the default value
+     */
+    getBoolean(key: string, defaultValue?: boolean): boolean;
+}
+export declare const config: ConfigLoader;
+export {};

package/dist/utils/config.util.js

@@ -0,0 +1,145 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const logger_util_js_1 = require("./logger.util.js");
+const dotenv_1 = __importDefault(require("dotenv"));
+const os_1 = __importDefault(require("os"));
+/**
+ * Configuration loader that handles multiple sources with priority:
+ * 1. Direct ENV pass (process.env)
+ * 2. .env file in project root
+ * 3. Global config file at $HOME/.mcp/configs.json
+ */
+class ConfigLoader {
+    /**
+     * Create a new ConfigLoader instance
+     * @param packageName The package name to use for global config lookup
+     */
+    constructor(packageName) {
+        this.configLoaded = false;
+        this.packageName = packageName;
+    }
+    /**
+     * Load configuration from all sources with proper priority
+     */
+    load() {
+        const methodLogger = logger_util_js_1.Logger.forContext('utils/config.util.ts', 'load');
+        if (this.configLoaded) {
+            methodLogger.debug('Configuration already loaded, skipping');
+            return;
+        }
+        methodLogger.debug('Loading configuration...');
+        // Priority 3: Load from global config file
+        this.loadFromGlobalConfig();
+        // Priority 2: Load from .env file
+        this.loadFromEnvFile();
+        // Priority 1: Direct ENV pass is already in process.env
+        // No need to do anything as it already has highest priority
+        this.configLoaded = true;
+        methodLogger.debug('Configuration loaded successfully');
+    }
+    /**
+     * Load configuration from .env file in project root
+     */
+    loadFromEnvFile() {
+        const methodLogger = logger_util_js_1.Logger.forContext('utils/config.util.ts', 'loadFromEnvFile');
+        try {
+            const result = dotenv_1.default.config({
+                // Suppress dotenv output in test environment
+                debug: process.env.NODE_ENV !== 'test' &&
+                    process.env.DEBUG === 'true',
+                // Suppress promotional messages in test environment (dotenv v17+)
+                quiet: process.env.NODE_ENV === 'test',
+            });
+            if (result.error) {
+                methodLogger.debug('No .env file found or error reading it');
+                return;
+            }
+            methodLogger.debug('Loaded configuration from .env file');
+        }
+        catch (error) {
+            methodLogger.error('Error loading .env file', error);
+        }
+    }
+    /**
+     * Load configuration from global config file at $HOME/.mcp/configs.json
+     */
+    loadFromGlobalConfig() {
+        const methodLogger = logger_util_js_1.Logger.forContext('utils/config.util.ts', 'loadFromGlobalConfig');
+        try {
+            const homedir = os_1.default.homedir();
+            const globalConfigPath = path_1.default.join(homedir, '.mcp', 'configs.json');
+            if (!fs_1.default.existsSync(globalConfigPath)) {
+                methodLogger.debug('Global config file not found');
+                return;
+            }
+            const configContent = fs_1.default.readFileSync(globalConfigPath, 'utf8');
+            const config = JSON.parse(configContent);
+            // Determine the potential keys for the current package
+            const shortKey = 'latitude'; // Project-specific short key
+            const fullPackageName = this.packageName; // e.g., '@anthropic/latitude-mcp-server'
+            const unscopedPackageName = fullPackageName.split('/')[1] || fullPackageName; // e.g., 'latitude-mcp-server'
+            const potentialKeys = [
+                shortKey,
+                fullPackageName,
+                unscopedPackageName,
+            ];
+            let foundConfigSection = null;
+            let usedKey = null;
+            for (const key of potentialKeys) {
+                if (config[key] &&
+                    typeof config[key] === 'object' &&
+                    config[key].environments) {
+                    foundConfigSection = config[key];
+                    usedKey = key;
+                    methodLogger.debug(`Found configuration using key: ${key}`);
+                    break; // Stop once found
+                }
+            }
+            if (!foundConfigSection || !foundConfigSection.environments) {
+                methodLogger.debug(`No configuration found for ${this.packageName} using keys: ${potentialKeys.join(', ')}`);
+                return;
+            }
+            const environments = foundConfigSection.environments;
+            for (const [key, value] of Object.entries(environments)) {
+                // Only set if not already defined in process.env
+                if (process.env[key] === undefined) {
+                    process.env[key] = String(value);
+                }
+            }
+            methodLogger.debug(`Loaded configuration from global config file using key: ${usedKey}`);
+        }
+        catch (error) {
+            methodLogger.error('Error loading global config file', error);
+        }
+    }
+    /**
+     * Get a configuration value
+     * @param key The configuration key
+     * @param defaultValue The default value if the key is not found
+     * @returns The configuration value or the default value
+     */
+    get(key, defaultValue) {
+        return process.env[key] || defaultValue;
+    }
+    /**
+     * Get a boolean configuration value
+     * @param key The configuration key
+     * @param defaultValue The default value if the key is not found
+     * @returns The boolean configuration value or the default value
+     */
+    getBoolean(key, defaultValue = false) {
+        const value = this.get(key);
+        if (value === undefined) {
+            return defaultValue;
+        }
+        return value.toLowerCase() === 'true';
+    }
+}
+// Create and export a singleton instance with the package name from package.json
+exports.config = new ConfigLoader('@anthropic/latitude-mcp-server');

package/dist/utils/config.util.test.d.ts

@@ -0,0 +1 @@
+export {};