@stackmemoryai/stackmemory 0.2.3 → 0.2.6

package/dist/src/integrations/browser-mcp.js

@@ -0,0 +1,431 @@
+/**
+ * Browser MCP Integration for StackMemory
+ * Provides browser automation capabilities through MCP
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
+import puppeteer from 'puppeteer';
+import { logger } from '../core/logger.js';
+export class BrowserMCPIntegration {
+    config;
+    sessions = new Map();
+    server;
+    maxSessions = 5;
+    sessionTimeout = 30 * 60 * 1000; // 30 minutes
+    constructor(config = {}) {
+        this.config = config;
+        this.startCleanupInterval();
+    }
+    /**
+     * Initialize the Browser MCP server
+     */
+    async initialize(mcpServer) {
+        this.server = mcpServer || new Server({
+            name: 'stackmemory-browser',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupHandlers();
+        logger.info('Browser MCP integration initialized');
+    }
+    /**
+     * Set up MCP request handlers
+     */
+    setupHandlers() {
+        if (!this.server)
+            return;
+        // List available browser tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                {
+                    name: 'browser_navigate',
+                    description: 'Navigate to a URL in the browser',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            url: { type: 'string', description: 'URL to navigate to' },
+                            sessionId: { type: 'string', description: 'Optional session ID' },
+                        },
+                        required: ['url'],
+                    },
+                },
+                {
+                    name: 'browser_screenshot',
+                    description: 'Take a screenshot of the current page',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            sessionId: { type: 'string', description: 'Session ID' },
+                            fullPage: { type: 'boolean', description: 'Capture full page' },
+                            selector: { type: 'string', description: 'CSS selector to screenshot' },
+                        },
+                        required: ['sessionId'],
+                    },
+                },
+                {
+                    name: 'browser_click',
+                    description: 'Click an element on the page',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            sessionId: { type: 'string', description: 'Session ID' },
+                            selector: { type: 'string', description: 'CSS selector to click' },
+                        },
+                        required: ['sessionId', 'selector'],
+                    },
+                },
+                {
+                    name: 'browser_type',
+                    description: 'Type text into an input field',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            sessionId: { type: 'string', description: 'Session ID' },
+                            selector: { type: 'string', description: 'CSS selector of input' },
+                            text: { type: 'string', description: 'Text to type' },
+                        },
+                        required: ['sessionId', 'selector', 'text'],
+                    },
+                },
+                {
+                    name: 'browser_evaluate',
+                    description: 'Execute JavaScript in the browser context',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            sessionId: { type: 'string', description: 'Session ID' },
+                            script: { type: 'string', description: 'JavaScript code to execute' },
+                        },
+                        required: ['sessionId', 'script'],
+                    },
+                },
+                {
+                    name: 'browser_wait',
+                    description: 'Wait for an element or condition',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            sessionId: { type: 'string', description: 'Session ID' },
+                            selector: { type: 'string', description: 'CSS selector to wait for' },
+                            timeout: { type: 'number', description: 'Timeout in milliseconds' },
+                        },
+                        required: ['sessionId'],
+                    },
+                },
+                {
+                    name: 'browser_get_content',
+                    description: 'Get the text content of the page or element',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            sessionId: { type: 'string', description: 'Session ID' },
+                            selector: { type: 'string', description: 'CSS selector (optional)' },
+                        },
+                        required: ['sessionId'],
+                    },
+                },
+                {
+                    name: 'browser_close',
+                    description: 'Close a browser session',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            sessionId: { type: 'string', description: 'Session ID to close' },
+                        },
+                        required: ['sessionId'],
+                    },
+                },
+            ],
+        }));
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case 'browser_navigate':
+                        return await this.navigate(String(args.url), args.sessionId);
+                    case 'browser_screenshot':
+                        return await this.screenshot(String(args.sessionId), args.fullPage, args.selector);
+                    case 'browser_click':
+                        return await this.click(String(args.sessionId), String(args.selector));
+                    case 'browser_type':
+                        return await this.type(String(args.sessionId), String(args.selector), String(args.text));
+                    case 'browser_evaluate':
+                        return await this.evaluate(String(args.sessionId), String(args.script));
+                    case 'browser_wait':
+                        return await this.waitFor(String(args.sessionId), args.selector, args.timeout);
+                    case 'browser_get_content':
+                        return await this.getContent(String(args.sessionId), args.selector);
+                    case 'browser_close':
+                        return await this.closeSession(String(args.sessionId));
+                    default:
+                        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                logger.error('Browser MCP tool error', error);
+                throw new McpError(ErrorCode.InternalError, error.message);
+            }
+        });
+    }
+    /**
+     * Navigate to a URL
+     */
+    async navigate(url, sessionId) {
+        const session = await this.getOrCreateSession(sessionId);
+        await session.page.goto(url, { waitUntil: 'networkidle2' });
+        session.url = url;
+        session.lastActivity = new Date();
+        logger.info(`Browser navigated to ${url}`, { sessionId: session.id });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Navigated to ${url}`,
+                },
+            ],
+            sessionId: session.id,
+            url,
+        };
+    }
+    /**
+     * Take a screenshot
+     */
+    async screenshot(sessionId, fullPage = false, selector) {
+        const session = this.getSession(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        let screenshot;
+        if (selector) {
+            const element = await session.page.$(selector);
+            if (!element) {
+                throw new Error(`Element ${selector} not found`);
+            }
+            screenshot = Buffer.from(await element.screenshot());
+        }
+        else {
+            screenshot = Buffer.from(await session.page.screenshot({ fullPage }));
+        }
+        session.lastActivity = new Date();
+        return {
+            content: [
+                {
+                    type: 'image',
+                    data: screenshot.toString('base64'),
+                },
+            ],
+            sessionId: session.id,
+        };
+    }
+    /**
+     * Click an element
+     */
+    async click(sessionId, selector) {
+        const session = this.getSession(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        await session.page.click(selector);
+        session.lastActivity = new Date();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Clicked element: ${selector}`,
+                },
+            ],
+            sessionId: session.id,
+        };
+    }
+    /**
+     * Type text into an input
+     */
+    async type(sessionId, selector, text) {
+        const session = this.getSession(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        await session.page.type(selector, text);
+        session.lastActivity = new Date();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Typed "${text}" into ${selector}`,
+                },
+            ],
+            sessionId: session.id,
+        };
+    }
+    /**
+     * Execute JavaScript in page context
+     */
+    async evaluate(sessionId, script) {
+        const session = this.getSession(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        const result = await session.page.evaluate(script);
+        session.lastActivity = new Date();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+            sessionId: session.id,
+            result,
+        };
+    }
+    /**
+     * Wait for element or timeout
+     */
+    async waitFor(sessionId, selector, timeout = 5000) {
+        const session = this.getSession(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        if (selector) {
+            await session.page.waitForSelector(selector, { timeout });
+        }
+        else {
+            await new Promise(resolve => setTimeout(resolve, timeout));
+        }
+        session.lastActivity = new Date();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: selector ? `Element ${selector} found` : `Waited ${timeout}ms`,
+                },
+            ],
+            sessionId: session.id,
+        };
+    }
+    /**
+     * Get page content
+     */
+    async getContent(sessionId, selector) {
+        const session = this.getSession(sessionId);
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        let content;
+        if (selector) {
+            content = await session.page.$eval(selector, (el) => el.textContent || '');
+        }
+        else {
+            content = await session.page.content();
+        }
+        session.lastActivity = new Date();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: content,
+                },
+            ],
+            sessionId: session.id,
+        };
+    }
+    /**
+     * Get or create a browser session
+     */
+    async getOrCreateSession(sessionId) {
+        if (sessionId) {
+            const existing = this.sessions.get(sessionId);
+            if (existing) {
+                existing.lastActivity = new Date();
+                return existing;
+            }
+        }
+        // Clean up old sessions if at max
+        if (this.sessions.size >= this.maxSessions) {
+            const oldest = Array.from(this.sessions.values())
+                .sort((a, b) => a.lastActivity.getTime() - b.lastActivity.getTime())[0];
+            await this.closeSession(oldest.id);
+        }
+        // Create new session
+        const browser = await puppeteer.launch({
+            headless: this.config.headless ?? true,
+            defaultViewport: this.config.defaultViewport || { width: 1280, height: 720 },
+            userDataDir: this.config.userDataDir,
+            executablePath: this.config.executablePath,
+            args: ['--no-sandbox', '--disable-setuid-sandbox'], // For Railway/Docker
+        });
+        const page = await browser.newPage();
+        const id = sessionId || `session-${Date.now()}`;
+        const session = {
+            id,
+            browser,
+            page,
+            createdAt: new Date(),
+            lastActivity: new Date(),
+        };
+        this.sessions.set(id, session);
+        logger.info(`Created browser session ${id}`);
+        return session;
+    }
+    /**
+     * Get existing session
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Close a browser session
+     */
+    async closeSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Session ${sessionId} not found`,
+                    },
+                ],
+            };
+        }
+        await session.browser.close();
+        this.sessions.delete(sessionId);
+        logger.info(`Closed browser session ${sessionId}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Session ${sessionId} closed`,
+                },
+            ],
+        };
+    }
+    /**
+     * Clean up inactive sessions
+     */
+    startCleanupInterval() {
+        setInterval(async () => {
+            const now = Date.now();
+            for (const [id, session] of this.sessions.entries()) {
+                const inactiveTime = now - session.lastActivity.getTime();
+                if (inactiveTime > this.sessionTimeout) {
+                    logger.info(`Cleaning up inactive session ${id}`);
+                    await this.closeSession(id);
+                }
+            }
+        }, 60000); // Check every minute
+    }
+    /**
+     * Close all sessions
+     */
+    async cleanup() {
+        for (const sessionId of this.sessions.keys()) {
+            await this.closeSession(sessionId);
+        }
+    }
+}
+//# sourceMappingURL=browser-mcp.js.map

package/dist/src/integrations/browser-mcp.js.map

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

package/dist/src/integrations/linear/auth.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Linear OAuth Authentication Setup
+ * Handles initial OAuth flow and token management for Linear integration
+ */
+export interface LinearAuthConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    scopes: string[];
+}
+export interface LinearTokens {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt: number;
+    scope: string[];
+}
+export interface LinearAuthResult {
+    accessToken: string;
+    refreshToken?: string;
+    expiresIn: number;
+    scope: string;
+    tokenType: string;
+}
+export declare class LinearAuthManager {
+    private configPath;
+    private tokensPath;
+    private config?;
+    constructor(projectRoot: string);
+    /**
+     * Check if Linear integration is configured
+     */
+    isConfigured(): boolean;
+    /**
+     * Save OAuth application configuration
+     */
+    saveConfig(config: LinearAuthConfig): void;
+    /**
+     * Load OAuth configuration
+     */
+    loadConfig(): LinearAuthConfig | null;
+    /**
+     * Generate OAuth authorization URL with PKCE
+     */
+    generateAuthUrl(state?: string): {
+        url: string;
+        codeVerifier: string;
+    };
+    /**
+     * Exchange authorization code for access token
+     */
+    exchangeCodeForToken(authCode: string, codeVerifier: string): Promise<LinearTokens>;
+    /**
+     * Refresh access token using refresh token
+     */
+    refreshAccessToken(): Promise<LinearTokens>;
+    /**
+     * Get valid access token (refresh if needed)
+     */
+    getValidToken(): Promise<string>;
+    /**
+     * Save tokens to file
+     */
+    private saveTokens;
+    /**
+     * Load tokens from file
+     */
+    loadTokens(): LinearTokens | null;
+    /**
+     * Clear stored tokens and config
+     */
+    clearAuth(): void;
+}
+/**
+ * Default Linear OAuth scopes for task management
+ */
+export declare const DEFAULT_LINEAR_SCOPES: string[];
+/**
+ * Linear OAuth setup helper
+ */
+export declare class LinearOAuthSetup {
+    private authManager;
+    constructor(projectRoot: string);
+    /**
+     * Interactive setup for Linear OAuth
+     */
+    setupInteractive(): Promise<{
+        authUrl: string;
+        instructions: string[];
+    }>;
+    /**
+     * Complete OAuth flow with authorization code
+     */
+    completeAuth(authCode: string): Promise<boolean>;
+    /**
+     * Test the Linear connection
+     */
+    testConnection(): Promise<boolean>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/integrations/linear/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/integrations/linear/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAmB;gBAEtB,WAAW,EAAE,MAAM;IAM/B;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAM1C;;OAEG;IACH,UAAU,IAAI,gBAAgB,GAAG,IAAI;IAerC;;OAEG;IACH,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IA8BtE;;OAEG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC;IA8CxB;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC;IA8CjD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBtC;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,UAAU,IAAI,YAAY,GAAG,IAAI;IAcjC;;OAEG;IACH,SAAS,IAAI,IAAI;CASlB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAIjC,CAAC;AAEF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAoB;gBAE3B,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IAgDF;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBtD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAgCzC"}