fastmode-mcp 1.0.0

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

@@ -0,0 +1,81 @@
+/**
+ * Centralized API client for FastMode API requests
+ * Uses stored credentials with automatic refresh, or falls back to env var
+ */
+export interface ApiConfig {
+    apiUrl: string;
+    authToken: string | null;
+}
+/**
+ * Get API URL from environment or default
+ */
+export declare function getApiUrl(): string;
+/**
+ * Get API configuration - tries stored credentials first, then env var
+ */
+export declare function getApiConfigAsync(): Promise<ApiConfig>;
+/**
+ * Synchronous version - only checks env var (for quick checks)
+ */
+export declare function getApiConfig(): ApiConfig;
+/**
+ * Check if authentication is configured (either stored credentials or env var)
+ */
+export declare function isAuthConfigured(): boolean;
+/**
+ * Check if we need to trigger the device flow
+ */
+export declare function needsAuthentication(): Promise<boolean>;
+/**
+ * Get a helpful message for authentication
+ */
+export declare function getAuthRequiredMessage(): string;
+/**
+ * API request options
+ */
+export interface ApiRequestOptions {
+    tenantId?: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    body?: unknown;
+}
+/**
+ * API error response
+ */
+export interface ApiError {
+    success: false;
+    error: string;
+    statusCode: number;
+    needsAuth?: boolean;
+}
+/**
+ * Make an authenticated API request
+ * Uses stored credentials with auto-refresh, or falls back to env var
+ */
+export declare function apiRequest<T>(endpoint: string, options?: ApiRequestOptions): Promise<{
+    data: T;
+} | ApiError>;
+/**
+ * Check if a response is an error
+ */
+export declare function isApiError(response: unknown): response is ApiError;
+/**
+ * Check if error requires authentication
+ */
+export declare function needsAuthError(error: ApiError): boolean;
+/**
+ * Resolve a project identifier to a tenant ID
+ * Accepts either a UUID or a project name
+ */
+export declare function resolveProjectId(projectIdentifier: string): Promise<{
+    tenantId: string;
+} | {
+    error: string;
+}>;
+/**
+ * Make an authenticated external API request
+ * Uses the /external/* endpoints with tenant context
+ */
+export declare function externalApiRequest<T>(tenantId: string, endpoint: string, options?: Omit<ApiRequestOptions, 'tenantId'>): Promise<{
+    data: T;
+} | ApiError>;
+//# sourceMappingURL=api-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/lib/api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,SAAS,CAAC,CAgB5D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAW5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAS/C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG,QAAQ,CAAC,CAoEjC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,QAAQ,CAOlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAEvD;AAYD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCnH;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAM,GAChD,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG,QAAQ,CAAC,CAOjC"}

package/dist/lib/api-client.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * Centralized API client for FastMode API requests
+ * Uses stored credentials with automatic refresh, or falls back to env var
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApiUrl = getApiUrl;
+exports.getApiConfigAsync = getApiConfigAsync;
+exports.getApiConfig = getApiConfig;
+exports.isAuthConfigured = isAuthConfigured;
+exports.needsAuthentication = needsAuthentication;
+exports.getAuthRequiredMessage = getAuthRequiredMessage;
+exports.apiRequest = apiRequest;
+exports.isApiError = isApiError;
+exports.needsAuthError = needsAuthError;
+exports.resolveProjectId = resolveProjectId;
+exports.externalApiRequest = externalApiRequest;
+const credentials_1 = require("./credentials");
+/**
+ * Get API URL from environment or default
+ */
+function getApiUrl() {
+    return process.env.FASTMODE_API_URL || 'https://api.fastmode.ai';
+}
+/**
+ * Get API configuration - tries stored credentials first, then env var
+ */
+async function getApiConfigAsync() {
+    // First, try to get valid stored credentials
+    const credentials = await (0, credentials_1.getValidCredentials)();
+    if (credentials) {
+        return {
+            apiUrl: getApiUrl(),
+            authToken: credentials.accessToken,
+        };
+    }
+    // Fall back to environment variable (for backward compatibility)
+    return {
+        apiUrl: getApiUrl(),
+        authToken: process.env.FASTMODE_AUTH_TOKEN || null,
+    };
+}
+/**
+ * Synchronous version - only checks env var (for quick checks)
+ */
+function getApiConfig() {
+    return {
+        apiUrl: getApiUrl(),
+        authToken: process.env.FASTMODE_AUTH_TOKEN || null,
+    };
+}
+/**
+ * Check if authentication is configured (either stored credentials or env var)
+ */
+function isAuthConfigured() {
+    return (0, credentials_1.hasCredentials)() || !!process.env.FASTMODE_AUTH_TOKEN;
+}
+/**
+ * Check if we need to trigger the device flow
+ */
+async function needsAuthentication() {
+    // Wait for any startup auth that might be in progress
+    const { waitForAuth } = await Promise.resolve().then(() => __importStar(require('./auth-state')));
+    await waitForAuth();
+    const credentials = await (0, credentials_1.getValidCredentials)();
+    if (credentials)
+        return false;
+    if (process.env.FASTMODE_AUTH_TOKEN)
+        return false;
+    return true;
+}
+/**
+ * Get a helpful message for authentication
+ */
+function getAuthRequiredMessage() {
+    return `# Authentication Required
+
+You need to authenticate to use this tool.
+
+**Starting authentication flow...**
+
+A browser window will open for you to log in. If it doesn't open automatically, you'll see a URL to visit.
+`;
+}
+/**
+ * Make an authenticated API request
+ * Uses stored credentials with auto-refresh, or falls back to env var
+ */
+async function apiRequest(endpoint, options = {}) {
+    const config = await getApiConfigAsync();
+    if (!config.authToken) {
+        return {
+            success: false,
+            error: 'Not authenticated',
+            statusCode: 401,
+            needsAuth: true,
+        };
+    }
+    const url = `${config.apiUrl}${endpoint.startsWith('/') ? endpoint : '/' + endpoint}`;
+    const headers = {
+        'Authorization': `Bearer ${config.authToken}`,
+        'Content-Type': 'application/json',
+    };
+    if (options.tenantId) {
+        headers['X-Tenant-Id'] = options.tenantId;
+    }
+    try {
+        const response = await fetch(url, {
+            method: options.method || 'GET',
+            headers,
+            body: options.body ? JSON.stringify(options.body) : undefined,
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            // Check if this is an auth error
+            if (response.status === 401) {
+                return {
+                    success: false,
+                    error: 'Authentication expired or invalid',
+                    statusCode: 401,
+                    needsAuth: true,
+                };
+            }
+            return {
+                success: false,
+                error: data.error || `API request failed with status ${response.status}`,
+                statusCode: response.status,
+            };
+        }
+        return data;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('fetch') || message.includes('network') || message.includes('ECONNREFUSED')) {
+            return {
+                success: false,
+                error: `Network error: Unable to connect to ${config.apiUrl}`,
+                statusCode: 0,
+            };
+        }
+        return {
+            success: false,
+            error: message,
+            statusCode: 0,
+        };
+    }
+}
+/**
+ * Check if a response is an error
+ */
+function isApiError(response) {
+    return (typeof response === 'object' &&
+        response !== null &&
+        'success' in response &&
+        response.success === false);
+}
+/**
+ * Check if error requires authentication
+ */
+function needsAuthError(error) {
+    return error.needsAuth === true || error.statusCode === 401;
+}
+/**
+ * Resolve a project identifier to a tenant ID
+ * Accepts either a UUID or a project name
+ */
+async function resolveProjectId(projectIdentifier) {
+    // Check if it looks like a UUID
+    const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidPattern.test(projectIdentifier)) {
+        return { tenantId: projectIdentifier };
+    }
+    // Look up by name using /api/tenants
+    const response = await apiRequest('/api/tenants');
+    if (isApiError(response)) {
+        return { error: `Failed to look up project: ${response.error}` };
+    }
+    const projects = response.data;
+    // Find by exact name match (case-insensitive)
+    const match = projects.find(p => p.name.toLowerCase() === projectIdentifier.toLowerCase());
+    if (match) {
+        return { tenantId: match.id };
+    }
+    // Try partial match
+    const partialMatch = projects.find(p => p.name.toLowerCase().includes(projectIdentifier.toLowerCase()));
+    if (partialMatch) {
+        return { tenantId: partialMatch.id };
+    }
+    const availableProjects = projects.map(p => `- ${p.name} (${p.id})`).join('\n');
+    return {
+        error: `Project "${projectIdentifier}" not found.\n\nAvailable projects:\n${availableProjects || 'None'}`
+    };
+}
+/**
+ * Make an authenticated external API request
+ * Uses the /external/* endpoints with tenant context
+ */
+async function externalApiRequest(tenantId, endpoint, options = {}) {
+    // External API endpoints are at /external/...
+    const fullEndpoint = endpoint.startsWith('/external')
+        ? endpoint
+        : `/external${endpoint.startsWith('/') ? endpoint : '/' + endpoint}`;
+    return apiRequest(fullEndpoint, { ...options, tenantId });
+}

package/dist/lib/auth-state.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared authentication state
+ * Separate file to avoid circular dependencies
+ */
+/**
+ * Set the in-progress auth promise
+ */
+export declare function setAuthInProgress(promise: Promise<string> | null): void;
+/**
+ * Wait for any in-progress authentication to complete
+ */
+export declare function waitForAuth(): Promise<void>;
+//# sourceMappingURL=auth-state.d.ts.map

package/dist/lib/auth-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-state.d.ts","sourceRoot":"","sources":["../../src/lib/auth-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}

package/dist/lib/auth-state.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Shared authentication state
+ * Separate file to avoid circular dependencies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setAuthInProgress = setAuthInProgress;
+exports.waitForAuth = waitForAuth;
+// Track in-progress authentication
+let authInProgress = null;
+/**
+ * Set the in-progress auth promise
+ */
+function setAuthInProgress(promise) {
+    authInProgress = promise;
+}
+/**
+ * Wait for any in-progress authentication to complete
+ */
+async function waitForAuth() {
+    if (authInProgress) {
+        await authInProgress;
+    }
+}

package/dist/lib/context-fetcher.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Context Fetcher
+ *
+ * Centralizes logic for fetching project state, collections, and content.
+ * Used by get_started and other tools that need project context.
+ */
+export interface ProjectSummary {
+    id: string;
+    name: string;
+    subdomain: string;
+    customDomain: string | null;
+    status: 'pending' | 'building' | 'published' | 'failed';
+    hasCollections: boolean;
+    collectionCount: number;
+    hasContent: boolean;
+    totalItems: number;
+    hasPendingChanges: boolean;
+    lastDeployedAt: string | null;
+    githubConnected: boolean;
+    githubRepo: string | null;
+}
+export interface CollectionField {
+    slug: string;
+    name: string;
+    type: string;
+    isRequired: boolean;
+    referenceCollection?: string;
+}
+export interface CollectionSummary {
+    slug: string;
+    name: string;
+    nameSingular: string;
+    fieldCount: number;
+    itemCount: number;
+    fields: CollectionField[];
+}
+export interface ProjectDetail {
+    id: string;
+    name: string;
+    subdomain: string;
+    customDomain: string | null;
+    status: 'pending' | 'building' | 'published' | 'failed';
+    collections: CollectionSummary[];
+    hasPendingChanges: boolean;
+    lastDeployedAt: string | null;
+    githubConnected: boolean;
+}
+export interface ProjectContext {
+    isAuthenticated: boolean;
+    projects: ProjectSummary[];
+    selectedProject?: ProjectDetail;
+}
+/**
+ * Fetch complete project context
+ *
+ * @param projectId - Optional specific project to get detailed info for
+ */
+export declare function fetchProjectContext(projectId?: string): Promise<ProjectContext>;
+/**
+ * Resolve a project identifier to a tenant ID
+ */
+export declare function resolveProjectId(projectIdentifier: string): Promise<{
+    tenantId: string;
+    name: string;
+    subdomain: string;
+} | null>;
+//# sourceMappingURL=context-fetcher.d.ts.map

package/dist/lib/context-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-fetcher.d.ts","sourceRoot":"","sources":["../../src/lib/context-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxD,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxD,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,aAAa,CAAC;CACjC;AAgHD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA6GrF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsCvI"}

package/dist/lib/context-fetcher.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Context Fetcher
+ *
+ * Centralizes logic for fetching project state, collections, and content.
+ * Used by get_started and other tools that need project context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchProjectContext = fetchProjectContext;
+exports.resolveProjectId = resolveProjectId;
+const api_client_1 = require("./api-client");
+// ============ Helper Functions ============
+/**
+ * Fetch all projects for the authenticated user
+ */
+async function fetchProjects() {
+    const response = await (0, api_client_1.apiRequest)('/api/tenants');
+    if ((0, api_client_1.isApiError)(response)) {
+        return [];
+    }
+    return response.data;
+}
+/**
+ * Fetch collections for a specific project
+ */
+async function fetchCollections(tenantId) {
+    const response = await (0, api_client_1.apiRequest)('/api/collections', { tenantId });
+    if ((0, api_client_1.isApiError)(response)) {
+        return [];
+    }
+    return response.data;
+}
+/**
+ * Fetch GitHub connection status for a project
+ */
+async function fetchGitHubStatus(tenantId) {
+    const response = await (0, api_client_1.apiRequest)('/api/github/site-connection', { tenantId });
+    if ((0, api_client_1.isApiError)(response)) {
+        return null;
+    }
+    return response.data;
+}
+// Note: fetchLatestDeploy could be used for detailed deploy state in the future
+// async function fetchLatestDeploy(tenantId: string): Promise<DeployLog | null> {
+//   const response = await apiRequest<DeployLog[]>('/api/deploy/history?limit=1', { tenantId });
+//   if (isApiError(response) || !response.data || response.data.length === 0) {
+//     return null;
+//   }
+//   return response.data[0];
+// }
+/**
+ * Fetch item counts for collections
+ */
+async function fetchCollectionItemCounts(tenantId, collectionSlugs) {
+    const counts = new Map();
+    // Fetch counts in parallel (limit concurrency)
+    const promises = collectionSlugs.slice(0, 10).map(async (slug) => {
+        const response = await (0, api_client_1.apiRequest)(`/api/collections/${slug}/items?limit=0`, { tenantId });
+        if (!(0, api_client_1.isApiError)(response) && response.data) {
+            counts.set(slug, response.data.total || 0);
+        }
+    });
+    await Promise.all(promises);
+    return counts;
+}
+// ============ Main Functions ============
+/**
+ * Fetch complete project context
+ *
+ * @param projectId - Optional specific project to get detailed info for
+ */
+async function fetchProjectContext(projectId) {
+    // Check authentication
+    const isAuthenticated = !(await (0, api_client_1.needsAuthentication)());
+    if (!isAuthenticated) {
+        return {
+            isAuthenticated: false,
+            projects: [],
+        };
+    }
+    // Fetch all projects
+    const tenants = await fetchProjects();
+    // Build project summaries
+    const projects = await Promise.all(tenants.map(async (tenant) => {
+        // Fetch collections for this project (for count)
+        const collections = await fetchCollections(tenant.id);
+        const collectionCount = collections.length;
+        // Calculate total items
+        let totalItems = 0;
+        for (const col of collections) {
+            if (col._count?.items) {
+                totalItems += col._count.items;
+            }
+        }
+        // Fetch GitHub status
+        const github = await fetchGitHubStatus(tenant.id);
+        return {
+            id: tenant.id,
+            name: tenant.name,
+            subdomain: tenant.subdomain,
+            customDomain: tenant.customDomain || null,
+            status: (tenant.site?.status || 'pending'),
+            hasCollections: collectionCount > 0,
+            collectionCount,
+            hasContent: totalItems > 0,
+            totalItems,
+            hasPendingChanges: tenant.site?.hasPendingChanges || false,
+            lastDeployedAt: tenant.site?.updatedAt || null,
+            githubConnected: github?.connected || false,
+            githubRepo: github?.repo || null,
+        };
+    }));
+    // If a specific project is requested, get detailed info
+    let selectedProject;
+    if (projectId) {
+        // Find the project
+        const tenant = tenants.find(t => t.id === projectId ||
+            t.name.toLowerCase() === projectId.toLowerCase() ||
+            t.subdomain.toLowerCase() === projectId.toLowerCase());
+        if (tenant) {
+            // Fetch collections with full field details
+            const collections = await fetchCollections(tenant.id);
+            // Fetch item counts
+            const itemCounts = await fetchCollectionItemCounts(tenant.id, collections.map(c => c.slug));
+            // Fetch GitHub status
+            const github = await fetchGitHubStatus(tenant.id);
+            // Build collection summaries
+            const collectionSummaries = collections.map(col => ({
+                slug: col.slug,
+                name: col.name,
+                nameSingular: col.nameSingular,
+                fieldCount: col.fields.length,
+                itemCount: itemCounts.get(col.slug) || col._count?.items || 0,
+                fields: col.fields.map(f => ({
+                    slug: f.slug,
+                    name: f.name,
+                    type: f.type,
+                    isRequired: f.isRequired || false,
+                    referenceCollection: f.referenceCollection,
+                })),
+            }));
+            selectedProject = {
+                id: tenant.id,
+                name: tenant.name,
+                subdomain: tenant.subdomain,
+                customDomain: tenant.customDomain || null,
+                status: (tenant.site?.status || 'pending'),
+                collections: collectionSummaries,
+                hasPendingChanges: tenant.site?.hasPendingChanges || false,
+                lastDeployedAt: tenant.site?.updatedAt || null,
+                githubConnected: github?.connected || false,
+            };
+        }
+    }
+    return {
+        isAuthenticated: true,
+        projects,
+        selectedProject,
+    };
+}
+/**
+ * Resolve a project identifier to a tenant ID
+ */
+async function resolveProjectId(projectIdentifier) {
+    const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    const tenants = await fetchProjects();
+    // Try exact UUID match
+    if (uuidPattern.test(projectIdentifier)) {
+        const tenant = tenants.find(t => t.id === projectIdentifier);
+        if (tenant) {
+            return { tenantId: tenant.id, name: tenant.name, subdomain: tenant.subdomain };
+        }
+    }
+    // Try exact name match
+    const exactMatch = tenants.find(t => t.name.toLowerCase() === projectIdentifier.toLowerCase());
+    if (exactMatch) {
+        return { tenantId: exactMatch.id, name: exactMatch.name, subdomain: exactMatch.subdomain };
+    }
+    // Try subdomain match
+    const subdomainMatch = tenants.find(t => t.subdomain.toLowerCase() === projectIdentifier.toLowerCase());
+    if (subdomainMatch) {
+        return { tenantId: subdomainMatch.id, name: subdomainMatch.name, subdomain: subdomainMatch.subdomain };
+    }
+    // Try partial match
+    const partialMatch = tenants.find(t => t.name.toLowerCase().includes(projectIdentifier.toLowerCase()));
+    if (partialMatch) {
+        return { tenantId: partialMatch.id, name: partialMatch.name, subdomain: partialMatch.subdomain };
+    }
+    return null;
+}

package/dist/lib/credentials.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Stored credentials for the MCP server
+ */
+export interface StoredCredentials {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: string;
+    email: string;
+    name?: string;
+}
+/**
+ * Get the path to the credentials file
+ */
+export declare function getCredentialsPath(): string;
+/**
+ * Load stored credentials from disk
+ */
+export declare function loadCredentials(): StoredCredentials | null;
+/**
+ * Save credentials to disk
+ */
+export declare function saveCredentials(credentials: StoredCredentials): void;
+/**
+ * Delete stored credentials
+ */
+export declare function deleteCredentials(): void;
+/**
+ * Check if credentials exist
+ */
+export declare function hasCredentials(): boolean;
+/**
+ * Check if the access token is expired or about to expire
+ */
+export declare function isTokenExpired(credentials: StoredCredentials, bufferMinutes?: number): boolean;
+/**
+ * Get the API URL from environment or default
+ */
+export declare function getApiUrl(): string;
+/**
+ * Refresh the access token using the refresh token
+ */
+export declare function refreshAccessToken(credentials: StoredCredentials): Promise<StoredCredentials | null>;
+/**
+ * Get valid credentials, refreshing if needed
+ * Returns null if no credentials or refresh fails
+ */
+export declare function getValidCredentials(): Promise<StoredCredentials | null>;
+/**
+ * Get the current auth token (access token) if available and valid
+ */
+export declare function getAuthToken(): Promise<string | null>;
+//# sourceMappingURL=credentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/lib/credentials.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAYD;;GAEG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,GAAG,IAAI,CAoB1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAUpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,iBAAiB,EAAE,aAAa,GAAE,MAAU,GAAG,OAAO,CAIjG;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAyC1G;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAoB7E;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG3D"}