latitude-mcp-server 1.0.0

package/dist/services/vendor.latitude.service.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const logger_util_js_1 = require("../utils/logger.util.js");
+const config_util_js_1 = require("../utils/config.util.js");
+const error_util_js_1 = require("../utils/error.util.js");
+const constants_util_js_1 = require("../utils/constants.util.js");
+const latitude_types_js_1 = require("../types/latitude.types.js");
+// Create a contextualized logger for this file
+const serviceLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts');
+// Log service initialization
+serviceLogger.debug('Latitude API service initialized');
+/**
+ * Get Latitude API credentials from configuration
+ */
+function getLatitudeCredentials() {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'getLatitudeCredentials');
+    const apiKey = config_util_js_1.config.get('LATITUDE_API_KEY');
+    const baseUrl = config_util_js_1.config.get('LATITUDE_BASE_URL') || constants_util_js_1.LATITUDE_BASE_URL;
+    if (!apiKey) {
+        methodLogger.error('LATITUDE_API_KEY is not configured');
+        throw (0, error_util_js_1.createAuthInvalidError)('LATITUDE_API_KEY is required. Set it in your environment or .env file.');
+    }
+    methodLogger.debug('Latitude credentials loaded successfully');
+    return { apiKey, baseUrl };
+}
+/**
+ * Generic fetch function for Latitude API
+ */
+async function fetchLatitudeApi(endpoint, options = {}) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'fetchLatitudeApi');
+    const { apiKey, baseUrl } = getLatitudeCredentials();
+    const url = `${baseUrl}/api/${constants_util_js_1.LATITUDE_API_VERSION}${endpoint}`;
+    const requestOptions = {
+        method: options.method || 'GET',
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            Authorization: `Bearer ${apiKey}`,
+            ...options.headers,
+        },
+        body: options.body ? JSON.stringify(options.body) : undefined,
+    };
+    methodLogger.debug(`Executing API call: ${requestOptions.method} ${url}`);
+    const startTime = performance.now();
+    try {
+        const response = await fetch(url, requestOptions);
+        const endTime = performance.now();
+        const duration = (endTime - startTime).toFixed(2);
+        methodLogger.debug(`API call completed in ${duration}ms with status: ${response.status}`);
+        if (!response.ok) {
+            const errorText = await response.text();
+            methodLogger.error(`API error response (${response.status}):`, errorText);
+            // Try to parse as Latitude error format
+            let errorData;
+            try {
+                const parsed = JSON.parse(errorText);
+                errorData = latitude_types_js_1.LatitudeErrorSchema.parse(parsed);
+            }
+            catch {
+                // Not a standard Latitude error format
+            }
+            if (response.status === 401) {
+                throw (0, error_util_js_1.createAuthInvalidError)(errorData?.message || 'Authentication failed. Check your LATITUDE_API_KEY.');
+            }
+            else if (response.status === 403) {
+                throw (0, error_util_js_1.createAuthInvalidError)(errorData?.message || 'Permission denied for the requested resource.');
+            }
+            else if (response.status === 404) {
+                throw (0, error_util_js_1.createApiError)(errorData?.message || 'Resource not found.', response.status, errorData || errorText);
+            }
+            else if (response.status === 422) {
+                throw (0, error_util_js_1.createApiError)(errorData?.message || 'Validation error.', response.status, errorData || errorText);
+            }
+            else {
+                throw (0, error_util_js_1.createApiError)(errorData?.message ||
+                    `API request failed with status ${response.status}`, response.status, errorData || errorText);
+            }
+        }
+        // Handle empty responses
+        const contentLength = response.headers.get('content-length');
+        if (contentLength === '0' || response.status === 204) {
+            return {};
+        }
+        const responseData = await response.json();
+        methodLogger.debug('Response body successfully parsed as JSON.');
+        return responseData;
+    }
+    catch (error) {
+        if (error instanceof error_util_js_1.McpError) {
+            throw error;
+        }
+        if (error instanceof TypeError) {
+            throw (0, error_util_js_1.createApiError)(`Network error during API call: ${error.message}`, undefined, error);
+        }
+        throw (0, error_util_js_1.createUnexpectedError)(`Unexpected error during API call: ${error instanceof Error ? error.message : String(error)}`, error);
+    }
+}
+/**
+ * Fetch with streaming support for run/chat endpoints
+ */
+async function fetchLatitudeStream(endpoint, body) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'fetchLatitudeStream');
+    const { apiKey, baseUrl } = getLatitudeCredentials();
+    const url = `${baseUrl}/api/${constants_util_js_1.LATITUDE_API_VERSION}${endpoint}`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'text/event-stream',
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw (0, error_util_js_1.createApiError)(`Stream request failed: ${response.status}`, response.status, errorText);
+    }
+    if (!response.body) {
+        throw (0, error_util_js_1.createApiError)('No response body for stream', 500, null);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    async function* streamGenerator() {
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                const chunk = decoder.decode(value, { stream: true });
+                yield chunk;
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    methodLogger.debug('Stream initiated successfully');
+    return streamGenerator();
+}
+// ============================================================================
+// Projects API
+// ============================================================================
+async function listProjects() {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'listProjects');
+    methodLogger.debug('Listing all projects');
+    const data = await fetchLatitudeApi('/projects');
+    return latitude_types_js_1.ProjectListSchema.parse(data);
+}
+async function createProject(name) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'createProject');
+    methodLogger.debug(`Creating project: ${name}`);
+    const data = await fetchLatitudeApi('/projects', {
+        method: 'POST',
+        body: { name },
+    });
+    return data;
+}
+// ============================================================================
+// Versions API
+// ============================================================================
+async function listVersions(projectId) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'listVersions');
+    methodLogger.debug(`Listing versions for project: ${projectId}`);
+    const data = await fetchLatitudeApi(`/projects/${projectId}/versions`);
+    return latitude_types_js_1.VersionListSchema.parse(data);
+}
+async function getVersion(projectId, versionUuid) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'getVersion');
+    methodLogger.debug(`Getting version: ${versionUuid} for project: ${projectId}`);
+    const data = await fetchLatitudeApi(`/projects/${projectId}/versions/${versionUuid}`);
+    return latitude_types_js_1.VersionSchema.parse(data);
+}
+async function createVersion(projectId, name) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'createVersion');
+    methodLogger.debug(`Creating version: ${name} for project: ${projectId}`);
+    const data = await fetchLatitudeApi(`/projects/${projectId}/versions`, {
+        method: 'POST',
+        body: { name },
+    });
+    return latitude_types_js_1.VersionSchema.parse(data);
+}
+async function publishVersion(projectId, versionUuid, options) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'publishVersion');
+    methodLogger.debug(`Publishing version: ${versionUuid}`);
+    const data = await fetchLatitudeApi(`/projects/${projectId}/versions/${versionUuid}/publish`, {
+        method: 'POST',
+        body: options || {},
+    });
+    return latitude_types_js_1.VersionSchema.parse(data);
+}
+async function pushChanges(projectId, versionUuid, changes) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'pushChanges');
+    methodLogger.debug(`Pushing ${changes.changes.length} changes to version: ${versionUuid}`);
+    return fetchLatitudeApi(`/projects/${projectId}/versions/${versionUuid}/push`, {
+        method: 'POST',
+        body: changes,
+    });
+}
+// ============================================================================
+// Documents/Prompts API
+// ============================================================================
+async function listDocuments(projectId, versionUuid) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'listDocuments');
+    methodLogger.debug(`Listing documents for project: ${projectId}, version: ${versionUuid}`);
+    const data = await fetchLatitudeApi(`/projects/${projectId}/versions/${versionUuid}/documents`);
+    return latitude_types_js_1.DocumentListSchema.parse(data);
+}
+async function getDocument(projectId, versionUuid, path) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'getDocument');
+    // Ensure path doesn't start with / for URL construction
+    const normalizedPath = path.startsWith('/') ? path.slice(1) : path;
+    methodLogger.debug(`Getting document: ${normalizedPath}`);
+    const data = await fetchLatitudeApi(`/projects/${projectId}/versions/${versionUuid}/documents/${normalizedPath}`);
+    return latitude_types_js_1.DocumentSchema.parse(data);
+}
+async function createOrUpdateDocument(projectId, versionUuid, path, prompt, force = false) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'createOrUpdateDocument');
+    methodLogger.debug(`Creating/updating document: ${path}`);
+    const data = await fetchLatitudeApi(`/projects/${projectId}/versions/${versionUuid}/documents/create-or-update`, {
+        method: 'POST',
+        body: { path, prompt, force },
+    });
+    return latitude_types_js_1.DocumentSchema.parse(data);
+}
+async function runDocument(projectId, versionUuid, options) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'runDocument');
+    methodLogger.debug(`Running document: ${options.path}`);
+    if (options.stream) {
+        return fetchLatitudeStream(`/projects/${projectId}/versions/${versionUuid}/documents/run`, options);
+    }
+    return fetchLatitudeApi(`/projects/${projectId}/versions/${versionUuid}/documents/run`, {
+        method: 'POST',
+        body: options,
+    });
+}
+async function createDocumentLog(projectId, versionUuid, path, messages) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'createDocumentLog');
+    methodLogger.debug(`Creating log for document: ${path}`);
+    return fetchLatitudeApi(`/projects/${projectId}/versions/${versionUuid}/documents/logs`, {
+        method: 'POST',
+        body: { path, messages },
+    });
+}
+// ============================================================================
+// Conversations API
+// ============================================================================
+async function getConversation(conversationUuid) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'getConversation');
+    methodLogger.debug(`Getting conversation: ${conversationUuid}`);
+    const data = await fetchLatitudeApi(`/conversations/${conversationUuid}`);
+    return data;
+}
+async function chatConversation(conversationUuid, messages, stream = false) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'chatConversation');
+    methodLogger.debug(`Chatting in conversation: ${conversationUuid}`);
+    if (stream) {
+        return fetchLatitudeStream(`/conversations/${conversationUuid}/chat`, { messages, stream: true });
+    }
+    return fetchLatitudeApi(`/conversations/${conversationUuid}/chat`, {
+        method: 'POST',
+        body: { messages, stream: false },
+    });
+}
+async function stopConversation(conversationUuid) {
+    const methodLogger = logger_util_js_1.Logger.forContext('services/vendor.latitude.service.ts', 'stopConversation');
+    methodLogger.debug(`Stopping conversation: ${conversationUuid}`);
+    return fetchLatitudeApi(`/conversations/${conversationUuid}/stop`, {
+        method: 'POST',
+    });
+}
+// ============================================================================
+// Export Service
+// ============================================================================
+exports.default = {
+    // Projects
+    listProjects,
+    createProject,
+    // Versions
+    listVersions,
+    getVersion,
+    createVersion,
+    publishVersion,
+    pushChanges,
+    // Documents/Prompts
+    listDocuments,
+    getDocument,
+    createOrUpdateDocument,
+    runDocument,
+    createDocumentLog,
+    // Conversations
+    getConversation,
+    chatConversation,
+    stopConversation,
+};

package/dist/tools/latitude.tool.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+declare function registerTools(server: McpServer): void;
+declare const _default: {
+    registerTools: typeof registerTools;
+};
+export default _default;