msteams-mcp 0.2.0

package/dist/browser/auth.js

@@ -0,0 +1,232 @@
+/**
+ * Authentication handling for Microsoft Teams.
+ * Manages login detection and manual authentication flows.
+ */
+import { saveSessionState } from './context.js';
+const TEAMS_URL = 'https://teams.microsoft.com';
+// URLs that indicate we're in a login flow
+const LOGIN_URL_PATTERNS = [
+    'login.microsoftonline.com',
+    'login.live.com',
+    'login.microsoft.com',
+];
+// Selectors that indicate successful authentication
+const AUTH_SUCCESS_SELECTORS = [
+    '[data-tid="app-bar"]',
+    '[data-tid="search-box"]',
+    'input[placeholder*="Search"]',
+    '[data-tid="chat-list"]',
+    '[data-tid="team-list"]',
+];
+/**
+ * Checks if the current page URL indicates a login flow.
+ */
+function isLoginUrl(url) {
+    return LOGIN_URL_PATTERNS.some(pattern => url.includes(pattern));
+}
+/**
+ * Checks if the page shows authenticated Teams content.
+ */
+async function hasAuthenticatedContent(page) {
+    for (const selector of AUTH_SUCCESS_SELECTORS) {
+        try {
+            const count = await page.locator(selector).count();
+            if (count > 0) {
+                return true;
+            }
+        }
+        catch {
+            // Selector not found, continue checking others
+        }
+    }
+    return false;
+}
+// Search input selectors - must match those in teams/search.ts
+const SEARCH_INPUT_SELECTORS = [
+    '[data-tid="searchInputField"]',
+    '[data-tid="app-search-input"]',
+    'input[data-tid*="search"]',
+    'input[placeholder*="Search"]',
+];
+const SEARCH_BUTTON_SELECTORS = [
+    '[data-tid="search-box"]',
+    '[data-tid="search-button"]',
+    '[data-tid="app-bar-search"]',
+    '[role="search"] input',
+];
+/**
+ * Triggers a search to cause MSAL to acquire the Substrate token.
+ * This is necessary because MSAL only acquires tokens for specific scopes
+ * when the app actually makes API calls requiring those scopes.
+ */
+async function triggerTokenAcquisition(page, log) {
+    log('Triggering token acquisition...');
+    try {
+        // Wait for the app to be ready
+        await page.waitForTimeout(3000);
+        // Try to find a search input directly
+        let searchInput = null;
+        for (const selector of SEARCH_INPUT_SELECTORS) {
+            const loc = page.locator(selector).first();
+            if (await loc.isVisible().catch(() => false)) {
+                searchInput = loc;
+                break;
+            }
+        }
+        // If no input visible, try clicking a search button first
+        if (!searchInput) {
+            for (const selector of SEARCH_BUTTON_SELECTORS) {
+                const btn = page.locator(selector).first();
+                if (await btn.isVisible().catch(() => false)) {
+                    await btn.click();
+                    await page.waitForTimeout(1000);
+                    // Now look for the input again
+                    for (const inputSelector of SEARCH_INPUT_SELECTORS) {
+                        const loc = page.locator(inputSelector).first();
+                        if (await loc.isVisible().catch(() => false)) {
+                            searchInput = loc;
+                            break;
+                        }
+                    }
+                    break;
+                }
+            }
+        }
+        if (searchInput) {
+            // Type a simple search query to trigger the API call
+            await searchInput.fill('test');
+            await page.keyboard.press('Enter');
+            // Wait for the search API call to complete
+            log('Waiting for search API response...');
+            await page.waitForTimeout(5000);
+            // Press Escape to close search and return to normal view
+            await page.keyboard.press('Escape');
+            await page.waitForTimeout(1000);
+            log('Token acquisition complete.');
+        }
+        else {
+            // Fallback: just wait and hope MSAL refreshes tokens
+            log('Search UI not found, waiting for background token refresh...');
+            await page.waitForTimeout(5000);
+        }
+    }
+    catch (error) {
+        // Non-fatal: tokens might still work from previous session
+        log(`Token acquisition warning: ${error instanceof Error ? error.message : String(error)}`);
+        await page.waitForTimeout(3000);
+    }
+}
+/**
+ * Gets the current authentication status.
+ */
+export async function getAuthStatus(page) {
+    const currentUrl = page.url();
+    const onLoginPage = isLoginUrl(currentUrl);
+    // If on login page, definitely not authenticated
+    if (onLoginPage) {
+        return {
+            isAuthenticated: false,
+            isOnLoginPage: true,
+            currentUrl,
+        };
+    }
+    // If on Teams domain, check for authenticated content
+    if (currentUrl.includes('teams.microsoft.com')) {
+        const hasContent = await hasAuthenticatedContent(page);
+        return {
+            isAuthenticated: hasContent,
+            isOnLoginPage: false,
+            currentUrl,
+        };
+    }
+    // Unknown state
+    return {
+        isAuthenticated: false,
+        isOnLoginPage: false,
+        currentUrl,
+    };
+}
+/**
+ * Navigates to Teams and checks authentication status.
+ */
+export async function navigateToTeams(page) {
+    await page.goto(TEAMS_URL, { waitUntil: 'domcontentloaded' });
+    // Wait a moment for redirects to complete
+    await page.waitForTimeout(2000);
+    return getAuthStatus(page);
+}
+/**
+ * Waits for the user to complete manual authentication.
+ * Returns when authenticated or throws after timeout.
+ *
+ * @param page - The page to monitor
+ * @param context - Browser context for saving session
+ * @param timeoutMs - Maximum time to wait (default: 5 minutes)
+ * @param onProgress - Callback for progress updates
+ */
+export async function waitForManualLogin(page, context, timeoutMs = 5 * 60 * 1000, onProgress) {
+    const startTime = Date.now();
+    const log = onProgress ?? console.log;
+    log('Waiting for manual login...');
+    while (Date.now() - startTime < timeoutMs) {
+        const status = await getAuthStatus(page);
+        if (status.isAuthenticated) {
+            log('Authentication successful!');
+            // Trigger a search to cause MSAL to acquire the Substrate token
+            await triggerTokenAcquisition(page, log);
+            // Save the session state with fresh tokens
+            await saveSessionState(context);
+            log('Session state saved.');
+            return;
+        }
+        // Check every 2 seconds
+        await page.waitForTimeout(2000);
+    }
+    throw new Error('Authentication timeout: user did not complete login within the allowed time');
+}
+/**
+ * Performs a full authentication flow:
+ * 1. Navigate to Teams
+ * 2. Check if already authenticated
+ * 3. If not, wait for manual login
+ *
+ * @param page - The page to use
+ * @param context - Browser context for session management
+ * @param onProgress - Callback for progress updates
+ */
+export async function ensureAuthenticated(page, context, onProgress) {
+    const log = onProgress ?? console.log;
+    log('Navigating to Teams...');
+    const status = await navigateToTeams(page);
+    if (status.isAuthenticated) {
+        log('Already authenticated.');
+        // Trigger a search to cause MSAL to acquire/refresh the Substrate token
+        await triggerTokenAcquisition(page, log);
+        // Save the session state with fresh tokens
+        await saveSessionState(context);
+        return;
+    }
+    if (status.isOnLoginPage) {
+        log('Login required. Please complete authentication in the browser window.');
+        await waitForManualLogin(page, context, undefined, onProgress);
+        // Navigate back to Teams after login (in case we're on a callback URL)
+        await navigateToTeams(page);
+    }
+    else {
+        // Unexpected state - might need manual intervention
+        log('Unexpected page state. Waiting for authentication...');
+        await waitForManualLogin(page, context, undefined, onProgress);
+    }
+}
+/**
+ * Forces a new login by clearing session and navigating to Teams.
+ */
+export async function forceNewLogin(page, context, onProgress) {
+    const log = onProgress ?? console.log;
+    log('Starting fresh login...');
+    // Clear cookies to force re-authentication
+    await context.clearCookies();
+    // Navigate and wait for login
+    await navigateToTeams(page);
+    await waitForManualLogin(page, context, undefined, onProgress);
+}

package/dist/browser/context.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Playwright browser context management.
+ * Creates and manages browser contexts with session persistence.
+ *
+ * Uses the system's installed Chrome or Edge browser rather than downloading
+ * Playwright's bundled Chromium. This significantly reduces install size.
+ */
+import { type Browser, type BrowserContext, type Page } from 'playwright';
+export interface BrowserManager {
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+    isNewSession: boolean;
+}
+export interface CreateBrowserOptions {
+    headless?: boolean;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Creates a browser context with optional session state restoration.
+ *
+ * Uses the system's installed Chrome or Edge browser to avoid downloading
+ * Playwright's bundled Chromium (~180MB savings).
+ *
+ * @param options - Browser configuration options
+ * @returns Browser manager with browser, context, and page
+ * @throws Error if system browser is not found (with helpful suggestions)
+ */
+export declare function createBrowserContext(options?: CreateBrowserOptions): Promise<BrowserManager>;
+/**
+ * Saves the current browser context's session state.
+ */
+export declare function saveSessionState(context: BrowserContext): Promise<void>;
+/**
+ * Closes the browser and optionally saves session state.
+ */
+export declare function closeBrowser(manager: BrowserManager, saveSession?: boolean): Promise<void>;

package/dist/browser/context.js

@@ -0,0 +1,121 @@
+/**
+ * Playwright browser context management.
+ * Creates and manages browser contexts with session persistence.
+ *
+ * Uses the system's installed Chrome or Edge browser rather than downloading
+ * Playwright's bundled Chromium. This significantly reduces install size.
+ */
+import { chromium } from 'playwright';
+import { ensureUserDataDir, hasSessionState, SESSION_STATE_PATH, isSessionLikelyExpired, writeSessionState, readSessionState, } from '../auth/session-store.js';
+import { areTokensExpired } from '../auth/token-extractor.js';
+const DEFAULT_OPTIONS = {
+    headless: true,
+    viewport: { width: 1280, height: 800 },
+};
+/**
+ * Determines the browser channel to use based on the platform.
+ * - Windows: Use Microsoft Edge (always installed on Windows 10+)
+ * - macOS/Linux: Use Chrome
+ *
+ * @returns The browser channel name for Playwright
+ */
+function getBrowserChannel() {
+    return process.platform === 'win32' ? 'msedge' : 'chrome';
+}
+/**
+ * Creates a browser context with optional session state restoration.
+ *
+ * Uses the system's installed Chrome or Edge browser to avoid downloading
+ * Playwright's bundled Chromium (~180MB savings).
+ *
+ * @param options - Browser configuration options
+ * @returns Browser manager with browser, context, and page
+ * @throws Error if system browser is not found (with helpful suggestions)
+ */
+export async function createBrowserContext(options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    ensureUserDataDir();
+    const channel = getBrowserChannel();
+    let browser;
+    try {
+        browser = await chromium.launch({
+            headless: opts.headless,
+            channel,
+        });
+    }
+    catch (error) {
+        const browserName = channel === 'msedge' ? 'Microsoft Edge' : 'Google Chrome';
+        const installHint = channel === 'msedge'
+            ? 'Edge should be pre-installed on Windows. Try updating Windows or reinstalling Edge.'
+            : 'Install Chrome from https://www.google.com/chrome/ or run: npx playwright install chromium';
+        throw new Error(`Could not launch ${browserName}. ${installHint}\n\n` +
+            `Original error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const hasSession = hasSessionState();
+    const sessionExpired = isSessionLikelyExpired();
+    const tokensExpired = areTokensExpired();
+    // Restore session if we have one and it's not ancient
+    const shouldRestoreSession = hasSession && !sessionExpired;
+    let context;
+    if (shouldRestoreSession) {
+        try {
+            // Read the decrypted session state
+            const state = readSessionState();
+            if (state) {
+                // Create a temporary file for Playwright (it needs a file path)
+                // We write the decrypted state to a temp location
+                const tempPath = SESSION_STATE_PATH + '.tmp';
+                const fs = await import('fs');
+                fs.writeFileSync(tempPath, JSON.stringify(state), { mode: 0o600 });
+                try {
+                    context = await browser.newContext({
+                        storageState: tempPath,
+                        viewport: opts.viewport,
+                    });
+                }
+                finally {
+                    // Clean up temp file
+                    fs.unlinkSync(tempPath);
+                }
+            }
+            else {
+                throw new Error('Failed to read session state');
+            }
+        }
+        catch (error) {
+            console.warn('Failed to restore session state, starting fresh:', error);
+            context = await browser.newContext({
+                viewport: opts.viewport,
+            });
+        }
+    }
+    else {
+        context = await browser.newContext({
+            viewport: opts.viewport,
+        });
+    }
+    const page = await context.newPage();
+    return {
+        browser,
+        context,
+        page,
+        isNewSession: !shouldRestoreSession,
+    };
+}
+/**
+ * Saves the current browser context's session state.
+ */
+export async function saveSessionState(context) {
+    const state = await context.storageState();
+    writeSessionState(state);
+}
+/**
+ * Closes the browser and optionally saves session state.
+ */
+export async function closeBrowser(manager, saveSession = true) {
+    if (saveSession) {
+        await saveSessionState(manager.context);
+    }
+    await manager.context.close();
+    await manager.browser.close();
+}

package/dist/browser/session.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Session persistence utilities.
+ * Handles saving and restoring browser session state.
+ */
+export declare const PROJECT_ROOT: string;
+export declare const USER_DATA_DIR: string;
+export declare const SESSION_STATE_PATH: string;
+/**
+ * Ensures the user data directory exists.
+ */
+export declare function ensureUserDataDir(): void;
+/**
+ * Checks if a saved session state exists.
+ */
+export declare function hasSessionState(): boolean;
+/**
+ * Deletes the saved session state.
+ */
+export declare function clearSessionState(): void;
+/**
+ * Gets the age of the session state file in hours.
+ * Returns null if no session state exists.
+ */
+export declare function getSessionAge(): number | null;
+/**
+ * Checks if the session is likely expired based on file age.
+ * Sessions older than 12 hours are considered potentially expired.
+ */
+export declare function isSessionLikelyExpired(): boolean;
+/**
+ * Checks if the tokens in the session state are expired.
+ * Returns true if no tokens found or if the Substrate search token is expired.
+ */
+export declare function areTokensExpired(): boolean;

package/dist/browser/session.js

@@ -0,0 +1,92 @@
+/**
+ * Session persistence utilities.
+ * Handles saving and restoring browser session state.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export const PROJECT_ROOT = path.resolve(__dirname, '../..');
+export const USER_DATA_DIR = path.join(PROJECT_ROOT, '.user-data');
+export const SESSION_STATE_PATH = path.join(PROJECT_ROOT, 'session-state.json');
+/**
+ * Ensures the user data directory exists.
+ */
+export function ensureUserDataDir() {
+    if (!fs.existsSync(USER_DATA_DIR)) {
+        fs.mkdirSync(USER_DATA_DIR, { recursive: true });
+    }
+}
+/**
+ * Checks if a saved session state exists.
+ */
+export function hasSessionState() {
+    return fs.existsSync(SESSION_STATE_PATH);
+}
+/**
+ * Deletes the saved session state.
+ */
+export function clearSessionState() {
+    if (fs.existsSync(SESSION_STATE_PATH)) {
+        fs.unlinkSync(SESSION_STATE_PATH);
+    }
+}
+/**
+ * Gets the age of the session state file in hours.
+ * Returns null if no session state exists.
+ */
+export function getSessionAge() {
+    if (!hasSessionState()) {
+        return null;
+    }
+    const stats = fs.statSync(SESSION_STATE_PATH);
+    const ageMs = Date.now() - stats.mtimeMs;
+    return ageMs / (1000 * 60 * 60); // Convert to hours
+}
+/**
+ * Checks if the session is likely expired based on file age.
+ * Sessions older than 12 hours are considered potentially expired.
+ */
+export function isSessionLikelyExpired() {
+    const age = getSessionAge();
+    if (age === null) {
+        return true;
+    }
+    return age > 12; // 12 hours
+}
+/**
+ * Checks if the tokens in the session state are expired.
+ * Returns true if no tokens found or if the Substrate search token is expired.
+ */
+export function areTokensExpired() {
+    if (!hasSessionState()) {
+        return true;
+    }
+    try {
+        const state = JSON.parse(fs.readFileSync(SESSION_STATE_PATH, 'utf8'));
+        const teamsOrigin = state.origins?.find((o) => o.origin === 'https://teams.microsoft.com');
+        if (!teamsOrigin)
+            return true;
+        // Look for Substrate search token
+        for (const item of teamsOrigin.localStorage) {
+            try {
+                const val = JSON.parse(item.value);
+                if (val.target?.includes('substrate.office.com/search/SubstrateSearch')) {
+                    const parts = val.secret.split('.');
+                    if (parts.length === 3) {
+                        const payload = JSON.parse(Buffer.from(parts[1], 'base64').toString());
+                        const expiry = new Date(payload.exp * 1000);
+                        return expiry.getTime() <= Date.now();
+                    }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    catch {
+        return true;
+    }
+    return true; // No token found = expired
+}

package/dist/constants.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared constants used across the codebase.
+ *
+ * Centralising these values makes the code more maintainable and
+ * allows for easier configuration changes.
+ */
+/** Minimum content length to be considered valid (characters). */
+export declare const MIN_CONTENT_LENGTH = 5;
+/** Default page size for search results. */
+export declare const DEFAULT_PAGE_SIZE = 25;
+/** Maximum page size for search results. */
+export declare const MAX_PAGE_SIZE = 100;
+/** Default limit for thread messages. */
+export declare const DEFAULT_THREAD_LIMIT = 50;
+/** Maximum limit for thread messages. */
+export declare const MAX_THREAD_LIMIT = 200;
+/** Default limit for people search. */
+export declare const DEFAULT_PEOPLE_LIMIT = 10;
+/** Maximum limit for people search. */
+export declare const MAX_PEOPLE_LIMIT = 50;
+/** Default limit for frequent contacts. */
+export declare const DEFAULT_CONTACTS_LIMIT = 50;
+/** Maximum limit for frequent contacts. */
+export declare const MAX_CONTACTS_LIMIT = 500;
+/** Default limit for channel search. */
+export declare const DEFAULT_CHANNEL_LIMIT = 10;
+/** Maximum limit for channel search. */
+export declare const MAX_CHANNEL_LIMIT = 50;
+/** Default timeout for waiting for search results. */
+export declare const SEARCH_RESULT_TIMEOUT_MS = 10000;
+/** Default HTTP request timeout. */
+export declare const HTTP_REQUEST_TIMEOUT_MS = 30000;
+/** Short delay for UI interactions. */
+export declare const UI_SHORT_DELAY_MS = 300;
+/** Medium delay for UI state changes. */
+export declare const UI_MEDIUM_DELAY_MS = 1000;
+/** Long delay for API responses to settle. */
+export declare const UI_LONG_DELAY_MS = 2000;
+/** Delay for MSAL token storage. */
+export declare const MSAL_TOKEN_DELAY_MS = 3000;
+/** Authentication check interval. */
+export declare const AUTH_CHECK_INTERVAL_MS = 2000;
+/** Default login timeout (5 minutes). */
+export declare const LOGIN_TIMEOUT_MS: number;
+/** Session expiry threshold in hours. */
+export declare const SESSION_EXPIRY_HOURS = 12;
+/** Default maximum retry attempts for HTTP requests. */
+export declare const DEFAULT_MAX_RETRIES = 3;
+/** Base delay for exponential backoff (milliseconds). */
+export declare const RETRY_BASE_DELAY_MS = 1000;
+/** Maximum delay between retries (milliseconds). */
+export declare const RETRY_MAX_DELAY_MS = 10000;
+/** Self-chat (notes) conversation ID. */
+export declare const SELF_CHAT_ID = "48:notes";

package/dist/constants.js

@@ -0,0 +1,72 @@
+/**
+ * Shared constants used across the codebase.
+ *
+ * Centralising these values makes the code more maintainable and
+ * allows for easier configuration changes.
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Content Thresholds
+// ─────────────────────────────────────────────────────────────────────────────
+/** Minimum content length to be considered valid (characters). */
+export const MIN_CONTENT_LENGTH = 5;
+// ─────────────────────────────────────────────────────────────────────────────
+// Pagination Defaults
+// ─────────────────────────────────────────────────────────────────────────────
+/** Default page size for search results. */
+export const DEFAULT_PAGE_SIZE = 25;
+/** Maximum page size for search results. */
+export const MAX_PAGE_SIZE = 100;
+/** Default limit for thread messages. */
+export const DEFAULT_THREAD_LIMIT = 50;
+/** Maximum limit for thread messages. */
+export const MAX_THREAD_LIMIT = 200;
+/** Default limit for people search. */
+export const DEFAULT_PEOPLE_LIMIT = 10;
+/** Maximum limit for people search. */
+export const MAX_PEOPLE_LIMIT = 50;
+/** Default limit for frequent contacts. */
+export const DEFAULT_CONTACTS_LIMIT = 50;
+/** Maximum limit for frequent contacts. */
+export const MAX_CONTACTS_LIMIT = 500;
+/** Default limit for channel search. */
+export const DEFAULT_CHANNEL_LIMIT = 10;
+/** Maximum limit for channel search. */
+export const MAX_CHANNEL_LIMIT = 50;
+// ─────────────────────────────────────────────────────────────────────────────
+// Timeouts (milliseconds)
+// ─────────────────────────────────────────────────────────────────────────────
+/** Default timeout for waiting for search results. */
+export const SEARCH_RESULT_TIMEOUT_MS = 10000;
+/** Default HTTP request timeout. */
+export const HTTP_REQUEST_TIMEOUT_MS = 30000;
+/** Short delay for UI interactions. */
+export const UI_SHORT_DELAY_MS = 300;
+/** Medium delay for UI state changes. */
+export const UI_MEDIUM_DELAY_MS = 1000;
+/** Long delay for API responses to settle. */
+export const UI_LONG_DELAY_MS = 2000;
+/** Delay for MSAL token storage. */
+export const MSAL_TOKEN_DELAY_MS = 3000;
+/** Authentication check interval. */
+export const AUTH_CHECK_INTERVAL_MS = 2000;
+/** Default login timeout (5 minutes). */
+export const LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
+// ─────────────────────────────────────────────────────────────────────────────
+// Session Management
+// ─────────────────────────────────────────────────────────────────────────────
+/** Session expiry threshold in hours. */
+export const SESSION_EXPIRY_HOURS = 12;
+// ─────────────────────────────────────────────────────────────────────────────
+// Retry Configuration
+// ─────────────────────────────────────────────────────────────────────────────
+/** Default maximum retry attempts for HTTP requests. */
+export const DEFAULT_MAX_RETRIES = 3;
+/** Base delay for exponential backoff (milliseconds). */
+export const RETRY_BASE_DELAY_MS = 1000;
+/** Maximum delay between retries (milliseconds). */
+export const RETRY_MAX_DELAY_MS = 10000;
+// ─────────────────────────────────────────────────────────────────────────────
+// Conversation IDs
+// ─────────────────────────────────────────────────────────────────────────────
+/** Self-chat (notes) conversation ID. */
+export const SELF_CHAT_ID = '48:notes';

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Teams MCP Server entry point.
+ *
+ * This MCP server enables AI assistants to search Microsoft Teams
+ * messages using browser automation.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Teams MCP Server entry point.
+ *
+ * This MCP server enables AI assistants to search Microsoft Teams
+ * messages using browser automation.
+ */
+import { runServer } from './server.js';
+runServer().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/dist/research/explore.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Research script to explore Teams web app behaviour.
+ *
+ * This script:
+ * 1. Launches a browser with persistent context
+ * 2. Navigates to Teams and handles authentication
+ * 3. Monitors network requests to discover API endpoints
+ * 4. Allows manual interaction to trigger searches
+ * 5. Logs discovered endpoints and data structures
+ */
+export {};