atproto-mcp 0.1.0

package/dist/utils/atp-client.js

@@ -0,0 +1,451 @@
+/**
+ * AT Protocol client wrapper with authentication and session management
+ * Supports both authenticated and unauthenticated modes
+ */
+import { AtpAgent } from '@atproto/api';
+import { AtpError, AuthenticationError, RateLimitError, ValidationError, } from '../types/index.js';
+import { Logger } from './logger.js';
+/**
+ * AT Protocol client wrapper with comprehensive authentication and session management
+ * Supports both authenticated and unauthenticated modes for maximum flexibility
+ */
+export class AtpClient {
+    agent;
+    publicAgent;
+    logger;
+    session = null;
+    config;
+    sessionRefreshPromise = null;
+    isAuthenticationRequired;
+    constructor(config) {
+        this.config = config;
+        this.logger = new Logger('AtpClient');
+        // Determine if authentication is required based on available credentials
+        this.isAuthenticationRequired = this.hasAuthenticationCredentials();
+        // Create authenticated agent (for user's PDS)
+        this.agent = new AtpAgent({
+            service: config.service,
+            persistSession: (evt, sess) => {
+                this.handleSessionEvent(evt, sess);
+            },
+        });
+        // Create public agent for unauthenticated requests
+        this.publicAgent = new AtpAgent({
+            service: 'https://public.api.bsky.app',
+        });
+    }
+    /**
+     * Check if authentication credentials are available
+     */
+    hasAuthenticationCredentials() {
+        if (this.config.authMethod === 'app-password') {
+            return !!(this.config.identifier && this.config.password);
+        }
+        else if (this.config.authMethod === 'oauth') {
+            return !!(this.config.clientId && this.config.clientSecret);
+        }
+        return false;
+    }
+    /**
+     * Initialize the AT Protocol client
+     * In unauthenticated mode, this will skip authentication
+     * In authenticated mode, this will perform authentication
+     */
+    async initialize() {
+        try {
+            this.logger.info('Initializing AT Protocol client', {
+                service: this.config.service,
+                authMethod: this.config.authMethod,
+                authenticationRequired: this.isAuthenticationRequired,
+            });
+            if (this.isAuthenticationRequired) {
+                await this.authenticate();
+                this.logger.info('AT Protocol client initialized successfully with authentication');
+            }
+            else {
+                this.logger.info('AT Protocol client initialized successfully in unauthenticated mode');
+            }
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize AT Protocol client', error);
+            throw error;
+        }
+    }
+    /**
+     * Authenticate with AT Protocol using configured method
+     */
+    async authenticate() {
+        if (this.config.authMethod === 'app-password') {
+            await this.authenticateWithAppPassword();
+        }
+        else if (this.config.authMethod === 'oauth') {
+            await this.authenticateWithOAuth();
+        }
+        else {
+            throw new AuthenticationError(`Unsupported authentication method: ${this.config.authMethod}`, undefined, { authMethod: this.config.authMethod });
+        }
+    }
+    /**
+     * Authenticate using app password
+     */
+    async authenticateWithAppPassword() {
+        if (!this.config.identifier || !this.config.password) {
+            throw new AuthenticationError('App password authentication requires identifier and password', undefined, { authMethod: 'app-password' });
+        }
+        try {
+            this.logger.debug('Authenticating with app password');
+            const response = await this.agent.login({
+                identifier: this.config.identifier,
+                password: this.config.password,
+            });
+            if (!response.success) {
+                throw new AuthenticationError('App password authentication failed', response, {
+                    identifier: this.config.identifier,
+                });
+            }
+            this.logger.info('App password authentication successful', {
+                did: response.data.did,
+                handle: response.data.handle,
+            });
+        }
+        catch (error) {
+            if (error instanceof AuthenticationError) {
+                throw error;
+            }
+            this.logger.error('App password authentication error', error);
+            throw new AuthenticationError('App password authentication failed', error, {
+                identifier: this.config.identifier,
+            });
+        }
+    }
+    /**
+     * Authenticate using OAuth
+     */
+    async authenticateWithOAuth() {
+        if (!this.config.clientId || !this.config.clientSecret) {
+            throw new AuthenticationError('OAuth authentication requires clientId and clientSecret', undefined, { authMethod: 'oauth' });
+        }
+        try {
+            this.logger.debug('Authenticating with OAuth');
+            const { AtpOAuthClient } = await import('./oauth-client.js');
+            const oauthClient = new AtpOAuthClient(this.config);
+            // For server environments, we need a different flow
+            // This implementation supports both interactive and programmatic flows
+            const identifier = this.config.identifier;
+            if (!identifier) {
+                throw new AuthenticationError('OAuth requires an identifier (handle or DID)', undefined, {
+                    authMethod: 'oauth',
+                });
+            }
+            // Check if we have stored OAuth tokens
+            const storedSession = await this.loadStoredOAuthSession();
+            if (storedSession && storedSession.expiresAt > new Date()) {
+                // Use stored session
+                this.logger.info('Using stored OAuth session', {
+                    did: storedSession.did,
+                    handle: storedSession.handle,
+                });
+                await this.agent.resumeSession({
+                    accessJwt: storedSession.accessToken,
+                    refreshJwt: storedSession.refreshToken,
+                    did: storedSession.did,
+                    handle: storedSession.handle,
+                    active: true,
+                });
+                return;
+            }
+            // Check if we have a refresh token to use
+            if (storedSession?.refreshToken) {
+                try {
+                    this.logger.info('Refreshing OAuth tokens');
+                    const newSession = await oauthClient.refreshTokens(storedSession.refreshToken);
+                    await this.storeOAuthSession(newSession);
+                    await this.agent.resumeSession({
+                        accessJwt: newSession.accessToken,
+                        refreshJwt: newSession.refreshToken,
+                        did: newSession.did,
+                        handle: newSession.handle,
+                        active: true,
+                    });
+                    return;
+                }
+                catch (refreshError) {
+                    this.logger.warn('OAuth token refresh failed, starting new flow', refreshError);
+                }
+            }
+            // Start new OAuth flow
+            const authRequest = await oauthClient.startAuthorization(identifier);
+            this.logger.info('OAuth authorization required', {
+                authUrl: authRequest.authUrl,
+                state: `${authRequest.state.substring(0, 8)}...`,
+            });
+            // In a real implementation, you would:
+            // 1. Open the authUrl in a browser or redirect user
+            // 2. Handle the callback with the authorization code
+            // 3. Complete the OAuth flow
+            // For now, we'll throw an informative error with the auth URL
+            throw new AuthenticationError(`OAuth flow requires user interaction. Please visit: ${authRequest.authUrl}`, undefined, {
+                authMethod: 'oauth',
+                authUrl: authRequest.authUrl,
+                state: authRequest.state,
+            });
+        }
+        catch (error) {
+            if (error instanceof AuthenticationError) {
+                throw error;
+            }
+            this.logger.error('OAuth authentication error', error);
+            throw new AuthenticationError('OAuth authentication failed', error, { authMethod: 'oauth' });
+        }
+    }
+    /**
+     * Handle session events from AtpAgent
+     */
+    handleSessionEvent(event, sessionData) {
+        this.logger.debug('Session event received', { event, hasSessionData: !!sessionData });
+        switch (event) {
+            case 'create':
+            case 'update':
+                if (sessionData) {
+                    this.session = {
+                        did: sessionData.did,
+                        handle: sessionData.handle,
+                        accessJwt: sessionData.accessJwt,
+                        refreshJwt: sessionData.refreshJwt,
+                        active: sessionData.active ?? true,
+                    };
+                    this.logger.debug('Session updated', {
+                        did: this.session.did,
+                        handle: this.session.handle,
+                        active: this.session.active,
+                    });
+                }
+                break;
+            case 'expired':
+                this.logger.warn('Session expired, attempting refresh');
+                this.refreshSession().catch(error => {
+                    this.logger.error('Failed to refresh expired session', error);
+                });
+                break;
+        }
+    }
+    /**
+     * Refresh the current session
+     */
+    async refreshSession() {
+        if (this.sessionRefreshPromise) {
+            return this.sessionRefreshPromise;
+        }
+        this.sessionRefreshPromise = this.performSessionRefresh();
+        try {
+            await this.sessionRefreshPromise;
+        }
+        finally {
+            this.sessionRefreshPromise = null;
+        }
+    }
+    /**
+     * Perform the actual session refresh
+     */
+    async performSessionRefresh() {
+        try {
+            this.logger.debug('Refreshing session');
+            // Note: refreshSession method may not exist in current @atproto/api version
+            // This is a placeholder for when the method becomes available
+            if ('refreshSession' in this.agent && typeof this.agent.refreshSession === 'function') {
+                const response = await this.agent.refreshSession();
+                if (!response.success) {
+                    throw new AuthenticationError('Session refresh failed', response, {
+                        sessionActive: this.session?.active,
+                    });
+                }
+                this.logger.info('Session refreshed successfully');
+            }
+            else {
+                // Fallback: re-authenticate if refresh is not available
+                this.logger.info('Session refresh not available, re-authenticating');
+                await this.authenticate();
+            }
+        }
+        catch (error) {
+            this.logger.error('Session refresh failed', error);
+            // If refresh fails, try to re-authenticate
+            if (this.config.authMethod === 'app-password') {
+                this.logger.info('Attempting re-authentication after refresh failure');
+                await this.authenticateWithAppPassword();
+            }
+            else {
+                throw new AuthenticationError('Session refresh failed and re-authentication not available', error);
+            }
+        }
+    }
+    /**
+     * Get the current session
+     */
+    getSession() {
+        return this.session;
+    }
+    /**
+     * Check if client is authenticated
+     */
+    isAuthenticated() {
+        return this.session?.active === true;
+    }
+    /**
+     * Check if authentication is required for this client instance
+     */
+    requiresAuthentication() {
+        return this.isAuthenticationRequired;
+    }
+    /**
+     * Get the underlying AtpAgent instance
+     * Returns the authenticated agent if available, otherwise the public agent
+     */
+    getAgent() {
+        return this.isAuthenticated() ? this.agent : this.publicAgent;
+    }
+    /**
+     * Get the authenticated agent (for operations that require authentication)
+     */
+    getAuthenticatedAgent() {
+        if (!this.isAuthenticated()) {
+            throw new AuthenticationError('Authentication required for this operation', undefined, {
+                operation: 'getAuthenticatedAgent',
+            });
+        }
+        return this.agent;
+    }
+    /**
+     * Get the public agent (for operations that don't require authentication)
+     */
+    getPublicAgent() {
+        return this.publicAgent;
+    }
+    /**
+     * Execute a request with automatic retry and error handling
+     * Supports both authenticated and unauthenticated operations
+     */
+    async executeRequest(operation, context, requiresAuth = false) {
+        try {
+            // Only authenticate if required and authentication is available
+            if (requiresAuth) {
+                if (!this.isAuthenticationRequired) {
+                    return {
+                        success: false,
+                        error: new AuthenticationError('This operation requires authentication, but no credentials were provided', undefined, { ...context, operation: 'executeRequest', requiresAuth }),
+                    };
+                }
+                if (!this.isAuthenticated()) {
+                    await this.authenticate();
+                }
+            }
+            const result = await operation();
+            return { success: true, data: result };
+        }
+        catch (error) {
+            return { success: false, error: this.handleError(error, context) };
+        }
+    }
+    /**
+     * Execute a public request that doesn't require authentication
+     */
+    async executePublicRequest(operation, context) {
+        try {
+            const result = await operation();
+            return { success: true, data: result };
+        }
+        catch (error) {
+            return { success: false, error: this.handleError(error, context) };
+        }
+    }
+    /**
+     * Execute an authenticated request that requires authentication
+     */
+    async executeAuthenticatedRequest(operation, context) {
+        return this.executeRequest(operation, context, true);
+    }
+    /**
+     * Handle and transform errors from AT Protocol operations
+     */
+    handleError(error, context) {
+        this.logger.error('AT Protocol operation failed', error, context);
+        if (error instanceof AtpError) {
+            return error;
+        }
+        // Handle common AT Protocol errors
+        if (typeof error === 'object' && error !== null) {
+            const errorObj = error;
+            if (errorObj.status === 401) {
+                return new AuthenticationError('Authentication required or invalid', errorObj, context);
+            }
+            if (errorObj.status === 429) {
+                const retryAfter = errorObj.headers?.['retry-after'];
+                return new RateLimitError('Rate limit exceeded', retryAfter ? parseInt(retryAfter, 10) : undefined, context);
+            }
+            if (errorObj.status >= 400 && errorObj.status < 500) {
+                return new ValidationError(errorObj.message || 'Client error', undefined, errorObj, context);
+            }
+        }
+        return new AtpError(error instanceof Error ? error.message : 'Unknown AT Protocol error', 'UNKNOWN_ERROR', undefined, error, context);
+    }
+    /**
+     * Cleanup resources
+     */
+    async cleanup() {
+        this.logger.info('Cleaning up AT Protocol client');
+        try {
+            // Cancel any pending session refresh
+            if (this.sessionRefreshPromise) {
+                await this.sessionRefreshPromise;
+            }
+            this.session = null;
+            this.logger.info('AT Protocol client cleanup completed');
+        }
+        catch (error) {
+            this.logger.error('Error during AT Protocol client cleanup', error);
+        }
+    }
+    /**
+     * Load stored OAuth session from secure storage
+     */
+    async loadStoredOAuthSession() {
+        try {
+            // In a real implementation, this would load from secure storage
+            // For now, we'll use environment variables or return null
+            const storedSession = process.env['OAUTH_STORED_SESSION'];
+            if (storedSession) {
+                const session = JSON.parse(storedSession);
+                return {
+                    ...session,
+                    expiresAt: new Date(session.expiresAt),
+                };
+            }
+            return null;
+        }
+        catch (error) {
+            this.logger.warn('Failed to load stored OAuth session', error);
+            return null;
+        }
+    }
+    /**
+     * Store OAuth session to secure storage
+     */
+    async storeOAuthSession(session) {
+        try {
+            // In a real implementation, this would store to secure storage
+            // For now, we'll log the session (without sensitive data)
+            this.logger.info('OAuth session stored', {
+                did: session.did,
+                handle: session.handle,
+                expiresAt: session.expiresAt.toISOString(),
+            });
+            // Store in environment variable for demo purposes
+            // In production, use proper secure storage
+            process.env['OAUTH_STORED_SESSION'] = JSON.stringify(session);
+        }
+        catch (error) {
+            this.logger.warn('Failed to store OAuth session', error);
+        }
+    }
+}
+//# sourceMappingURL=atp-client.js.map

package/dist/utils/atp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atp-client.js","sourceRoot":"","sources":["../../src/utils/atp-client.ts"],"names":[],"mappings":"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"}

package/dist/utils/config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Configuration management system for the AT Protocol MCP Server
+ * Handles environment variables, command-line arguments, and default settings
+ */
+import { type IAtpConfig, type IMcpServerConfig } from '../types/index.js';
+/**
+ * Configuration manager class
+ */
+export declare class ConfigManager {
+    private config;
+    constructor(overrides?: Partial<IMcpServerConfig>);
+    /**
+     * Build configuration from defaults, environment variables, and overrides
+     */
+    private buildConfig;
+    /**
+     * Apply environment variables to configuration
+     */
+    private applyEnvironmentVariables;
+    /**
+     * Parse environment variable value to appropriate type
+     */
+    private parseEnvValue;
+    /**
+     * Set nested property using dot notation
+     */
+    private setNestedProperty;
+    /**
+     * Deep merge configuration objects
+     */
+    private mergeConfig;
+    /**
+     * Validate configuration using Zod schema
+     */
+    private validateConfig;
+    /**
+     * Validate authentication configuration
+     * Authentication is now optional - only validate if auth method is specified
+     */
+    private validateAuthConfiguration;
+    /**
+     * Log configuration (excluding sensitive data)
+     */
+    private logConfiguration;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): IMcpServerConfig;
+    /**
+     * Get AT Protocol configuration
+     */
+    getAtpConfig(): IAtpConfig;
+    /**
+     * Update configuration at runtime
+     */
+    updateConfig(updates: Partial<IMcpServerConfig>): void;
+    /**
+     * Check if configuration is valid for the specified auth method
+     */
+    isValidForAuth(authMethod: 'app-password' | 'oauth'): boolean;
+    /**
+     * Check if authentication is configured
+     */
+    hasAuthentication(): boolean;
+    /**
+     * Get authentication mode description
+     */
+    getAuthMode(): 'unauthenticated' | 'app-password' | 'oauth';
+}
+/**
+ * Create a configuration manager instance
+ */
+export declare function createConfig(overrides?: Partial<IMcpServerConfig>): ConfigManager;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAsB,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAoG/F;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAmB;gBAErB,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAMrD;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAajC;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA4BjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACI,SAAS,IAAI,gBAAgB;IAIpC;;OAEG;IACI,YAAY,IAAI,UAAU;IAIjC;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAqB7D;;OAEG;IACI,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,GAAG,OAAO;IAkBpE;;OAEG;IACI,iBAAiB,IAAI,OAAO;IAgBnC;;OAEG;IACI,WAAW,IAAI,iBAAiB,GAAG,cAAc,GAAG,OAAO;CAMnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,aAAa,CAErF"}