@thinkrun/mcp 0.3.5

package/README.md

@@ -0,0 +1,356 @@
+# @thinkrun/mcp
+
+MCP (Model Context Protocol) server for [ThinkRun](https://thinkbrowse.io). Gives AI agents the ability to control **your actual Chrome browser** — with all your cookies and active sessions — or a cloud browser for headless automation.
+
+## Why ThinkRun vs Playwright MCP
+
+| Capability | ThinkRun MCP | Playwright MCP |
+|---|---|---|
+| **Uses your real Chrome cookies** | ✅ Local mode — browse as you | ❌ Fresh context, no auth |
+| **Access sites you're logged into** | ✅ LinkedIn, Salesforce, internal tools | ❌ Requires scripted login every time |
+| **Cloud headless sessions** | ✅ Isolated Playwright browser on demand | ❌ Local browser only (no ThinkRun cloud) |
+| **Runtime local ↔ cloud switching** | ✅ `set_mode` tool, no restart | ❌ Single mode per server |
+| **Structured content extraction** | ✅ Reader layer (articles, structured data) | ❌ Raw DOM access only |
+| **Session recording + sharing** | ✅ Full video, screenshots, AI analysis | ❌ |
+| **Persistent sessions** | ✅ Resume across agent invocations | ❌ Single-run only |
+| **Direct browser actions** | ✅ Browser tools + `local_action_*` | ✅ Browser tools |
+| **AI task planning** | ✅ `task_create` / `task_execute` | ❌ |
+
+**TL;DR**: Use ThinkRun when you need to browse as yourself (authenticated sites, internal tools). Use Playwright MCP for stateless public-web automation.
+
+## Installation
+
+### Claude Code
+
+```bash
+claude mcp add thinkrun --transport stdio \
+  -e THINKRUN_API_KEY=your-key \
+  -- npx @thinkrun/mcp
+```
+
+### Claude Desktop / Cursor / VS Code
+
+Add to your MCP config file:
+
+| Tool | Config file |
+|------|------------|
+| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Cursor | `.cursor/mcp.json` in project root |
+| VS Code (Copilot) | `.vscode/mcp.json` in project root |
+
+**Auto mode (recommended)** — tries local Chrome first, falls back to cloud:
+
+```json
+{
+  "mcpServers": {
+    "thinkrun": {
+      "command": "npx",
+      "args": ["@thinkrun/mcp"],
+      "env": {
+        "THINKRUN_API_KEY": "your-key"
+      }
+    }
+  }
+}
+```
+
+**Local only** (Chrome extension, no API key needed):
+
+```json
+{
+  "mcpServers": {
+    "thinkrun": {
+      "command": "npx",
+      "args": ["@thinkrun/mcp", "--mode", "local"]
+    }
+  }
+}
+```
+
+**Cloud only**:
+
+```json
+{
+  "mcpServers": {
+    "thinkrun": {
+      "command": "npx",
+      "args": ["@thinkrun/mcp", "--mode", "cloud"],
+      "env": {
+        "THINKRUN_API_KEY": "your-key"
+      }
+    }
+  }
+}
+```
+
+**Security note**: MCP config files (`.cursor/mcp.json`, `.vscode/mcp.json`) are often committed to git. Use environment variable references where supported, or add these files to `.gitignore` to avoid leaking your API key.
+
+### Global install (alternative)
+
+```bash
+npm install -g @thinkrun/mcp
+thinkrun-mcp --mode auto
+```
+
+## Modes
+
+| Mode | Backend | Requires |
+|------|---------|----------|
+| `auto` | Tries local first, falls back to cloud | Either of the below |
+| `local` | Chrome extension + native host | Chrome with ThinkRun extension |
+| `cloud` | ThinkRun REST API (Fly.io) | API key from thinkbrowse.io |
+
+**Page cache tools** (`page_cache_html`, `page_cache_text`, `page_cache_screenshot`): stateless `POST /api/cache/*` on the service. In **local** mode, set `THINKRUN_BASE_URL` and `THINKRUN_API_KEY` (or pass `--base-url` / `--api-key` so the native host client can reach the API — the native host itself has no `/api/cache` routes).
+
+**Runtime switching**: Use the `set_mode` tool to switch between local and cloud without restarting.
+
+### Local mode setup
+
+```
+MCP Server  ──HTTP──>  Native Host  ──stdio──>  Chrome Extension  ──>  Chrome tabs
+```
+
+1. Install the [ThinkRun Chrome extension](https://thinkbrowse.io)
+2. Set up the native host binary (extension guides you through this)
+3. Verify: `curl http://localhost:$(cat ~/.thinkbrowse/port)/health`
+4. Add MCP config above
+
+## Available Tools (51 + 1 optional)
+
+> 51 tools are always registered. `set_mode` is registered when the server is started with mode-switch support (the default CLI binary enables it).
+
+### Session Lifecycle
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `session_create` | Create a new browser session | all |
+| `session_status` | Get session URL, title, action count | all |
+| `session_delete` | Terminate session, preserve artifacts | all |
+| `session_list` | List all active sessions | all |
+| `session_wait_ready` | Poll until session is ready (use after create in cloud mode) | all |
+| `session_use` | Set default session ID for subsequent tool calls | all |
+| `session_release` | Release the current local session ownership without closing the tab | local |
+| `session_artifacts` | List screenshots and recordings for a session | cloud |
+
+### Mode Switching
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `set_mode` | Switch between local/cloud/auto at runtime without restart | all |
+
+### Stateless Page Cache
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `page_cache_html` | Fetch rendered HTML without creating a session | all |
+| `page_cache_text` | Extract plain text without creating a session | all |
+| `page_cache_screenshot` | Capture a screenshot without creating a session | all |
+
+### Navigation
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `navigate` | Go to a URL, wait for page load | all |
+| `go_back` | Navigate back in browser history | all |
+| `go_forward` | Navigate forward in browser history | all |
+| `wait_for_element` | Wait for a CSS selector to appear | all |
+
+### Interaction
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `click` | Click an element by CSS selector | all |
+| `type_text` | Type text into an element (appends) | all |
+| `fill` | Fill a form field (replaces content) | all |
+| `press_key` | Press a keyboard key (Enter, Tab, Escape, etc.) | all |
+| `scroll` | Scroll the page or a specific element | all |
+| `hover` | Hover over an element (triggers tooltips/menus) | all |
+| `select_option` | Select from a `<select>` dropdown | all |
+
+### Observation
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `snapshot` | Get accessibility tree (lightweight page overview) | all |
+| `screenshot` | Capture page screenshot (png/jpeg/webp, full-page option) | all |
+| `extract` | Extract text, HTML, or structured data from elements | all |
+| `evaluate` | Run JavaScript in the page context | all |
+| `get_url` | Return the current page URL | all |
+| `get_title` | Return the current page title | all |
+| `get_html` | Return current page HTML with explicit truncation metadata when large | all |
+| `sleep` | Pause for a bounded duration in milliseconds | all |
+
+### Tab Management
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `tab_list` | List all open browser tabs | local |
+| `tab_new` | Open a new tab (optionally with URL) | local |
+| `tab_close` | Close a tab by ID | local |
+| `tab_attach` | Attach to an existing local tab and bind it as the default session | local |
+| `tab_switch` | Switch the active local browser tab without rebinding the default session | local |
+| `focus` | Bring the currently bound local browser tab/window to the foreground | local |
+| `window_new` | Open a new local browser window and bind it as the default session | local |
+
+### Dialog Handling
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `get_dialog` | Check for open alert/confirm/prompt dialogs | all |
+| `handle_dialog` | Accept or dismiss a dialog with optional text | all |
+
+### Wait
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `wait_for_text` | Wait for specific text to appear on the page | all |
+
+### Monitoring
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `console_messages` | Get browser console messages (log, warn, error) | all |
+| `network_requests` | Get network requests made by the page | all |
+| `clear_logs` | Clear console and network logs for a clean capture | all |
+
+### Local Actions
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `local_action_run` | Run a direct native-host action against the currently attached local tab | local |
+| `local_action_status` | Check the status of a previously started local action | local |
+| `local_action_cancel` | Cancel a running local action | local |
+
+### Local Diagnostics And Recovery
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `local_diagnostics` | Inspect the current local continuity, lock owner, reclaim audit, and bridge recovery state | local |
+| `local_reset_connection` | Reset the local bridge connection using the bounded circuit-breaker recovery path | local |
+
+### Task Planning
+| Tool | Description | Modes |
+|------|-------------|-------|
+| `task_create` | Create an AI task plan from natural language | cloud |
+| `task_execute` | Execute a task plan | cloud |
+| `task_status` | Check task execution status | cloud |
+
+## Local Session Semantics
+
+The new local lifecycle tools intentionally distinguish between **ownership-changing** operations and **focus-only** operations:
+
+- `tab_attach` rebinding:
+  attaches to an existing local Chrome tab and sets it as the default session for subsequent session-scoped tool calls.
+- `window_new` rebinding:
+  opens a fresh local window and sets the resulting tab as the default session.
+- `tab_switch` focus-only:
+  changes the active local browser tab, but does **not** steal or rewrite the current default session just because browser focus changed.
+- `focus` focus-only:
+  foregrounds the currently bound local tab/window without rebinding or switching the default session.
+- `session_release` clearing:
+  releases the current local session ownership and clears the default session when that bound local context is released.
+
+Lock safety follows the same high-level contract as the CLI:
+
+- contested live local locks fail explicitly
+- same-owner rebinds can succeed idempotently
+- stale locks may be replaced only when the existing owner is no longer live
+
+This package also exposes structured local diagnostics and bounded recovery rather than full CLI admin commands:
+
+- `local_diagnostics` is the MCP equivalent for continuity/bridge truth that CLI users get from `doctor` and `session debug`
+- `local_reset_connection` is the MCP equivalent for the CLI’s bounded `reset-connection` recovery path
+- install/bootstrap/config flows remain CLI-only
+
+This package now exposes the CLI's local native-host execution flow as:
+
+- `local_action_run`
+- `local_action_status`
+- `local_action_cancel`
+
+The naming is intentional:
+
+- `action` means a direct operation against a browser context
+- `task` means a higher-level cloud multi-step planning/execution workflow
+
+## CLI Options
+
+```
+thinkrun-mcp [options]
+
+Options:
+  --mode <mode>        cloud, local, or auto (default: auto)
+  --api-key <key>      API key for cloud mode (or set THINKRUN_API_KEY)
+  --base-url <url>     Cloud API URL (default: https://api.thinkbrowse.io)
+  --port <port>        Override native host port
+  --session-id <id>    Default session ID (enables session_use)
+  -h, --help           Show help
+  -v, --version        Show version
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `THINKRUN_API_KEY` | API key for cloud mode |
+| `THINKRUN_BASE_URL` | Cloud API base URL |
+| `THINKRUN_BRIDGE_PORT` | Override native host port |
+| `THINKRUN_LOCAL` | Set to `true` to force local mode |
+
+## Port Discovery
+
+The native host writes its port to `~/.thinkbrowse/port` on startup. This path stays stable until the native-host cutover moves it to `~/.thinkrun/port`. The MCP server reads this automatically.
+
+Priority: `--port` flag > `THINKRUN_BRIDGE_PORT` env > `~/.thinkbrowse/port` > `3012`
+
+## Testing
+
+```bash
+# Unit tests
+bun test
+
+# Smoke test — full session lifecycle against cloud
+THINKRUN_API_KEY=your-key bun run scripts/smoke-mcp-parity.ts
+
+# Manual local parity smoke — requires live native host + extension bridge
+bun run smoke:local-parity
+
+# Manual local parity soak — repeats the same local parity assertions
+THINKRUN_MCP_SOAK_ITERATIONS=50 bun run soak:local-parity
+
+# Smoke test — clear_logs only
+bun run test:smoke
+```
+
+## Programmatic Usage
+
+**Basic:**
+
+```typescript
+import { createServer, CloudClient } from '@thinkrun/mcp';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+
+const client = new CloudClient({
+  baseUrl: 'https://api.thinkbrowse.io',
+  apiKey: process.env.THINKRUN_API_KEY!,
+});
+
+const server = createServer(client);
+await server.connect(new StdioServerTransport());
+```
+
+**With runtime mode switching:**
+
+```typescript
+import { createServer, CloudClient } from '@thinkrun/mcp';
+import type { ClientRef } from '@thinkrun/mcp';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+
+const client = new CloudClient({
+  baseUrl: 'https://api.thinkbrowse.io',
+  apiKey: process.env.THINKRUN_API_KEY!,
+});
+
+const clientRef: ClientRef = { current: client };
+const server = createServer(client, {
+  clientRef,
+  onSetMode: async (mode) => {
+    // Return a new client for the requested mode
+    return new CloudClient({ baseUrl: '...', apiKey: '...' });
+  },
+});
+
+await server.connect(new StdioServerTransport());
+```
+
+## License
+
+MIT

package/dist/bin/thinkrun-mcp.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=thinkrun-mcp.d.ts.map

package/dist/bin/thinkrun-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinkrun-mcp.d.ts","sourceRoot":"","sources":["../../bin/thinkrun-mcp.ts"],"names":[],"mappings":""}

package/dist/bin/thinkrun-mcp.js

@@ -0,0 +1,305 @@
+#!/usr/bin/env node
+/**
+ * ThinkRun MCP Server CLI
+ *
+ * Usage:
+ *   npx @thinkrun/mcp --mode cloud --api-key YOUR_KEY
+ *   npx @thinkrun/mcp --mode local --port 3012
+ *   npx @thinkrun/mcp  (auto-detect: tries native host, falls back to cloud)
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from '../src/server.js';
+import { CloudClient } from '../src/cloud-client.js';
+import { LocalClient } from '../src/local-client.js';
+import { readPackageVersion } from '../src/package-version.js';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+const DEFAULT_CLOUD_URL = 'https://api.thinkbrowse.io';
+const DEFAULT_PORT = 3012;
+/** Read port from ~/.thinkbrowse/port discovery file. */
+function readDiscoveredPort() {
+    try {
+        const portFile = join(process.env.HOME || process.env.USERPROFILE || '/tmp', '.thinkbrowse', 'port');
+        if (existsSync(portFile)) {
+            const port = parseInt(readFileSync(portFile, 'utf-8').trim(), 10);
+            if (!isNaN(port) && port > 0 && port <= 65535)
+                return port;
+        }
+    }
+    catch {
+        // unreadable
+    }
+    return undefined;
+}
+function nextArg(argv, i, flag) {
+    const val = argv[i + 1];
+    if (!val || val.startsWith('--') || val.startsWith('-')) {
+        console.error(`[thinkrun-mcp] Error: ${flag} requires a value`);
+        process.exit(1);
+    }
+    return val;
+}
+function parsePort(value) {
+    const port = parseInt(value, 10);
+    if (isNaN(port) || port < 1 || port > 65535)
+        return undefined;
+    return port;
+}
+function parseArgs() {
+    const args = {};
+    const argv = process.argv.slice(2);
+    for (let i = 0; i < argv.length; i++) {
+        switch (argv[i]) {
+            case '--mode': {
+                const mode = nextArg(argv, i, '--mode');
+                if (mode !== 'cloud' && mode !== 'local' && mode !== 'auto') {
+                    console.error(`[thinkrun-mcp] Error: invalid mode "${mode}". Must be cloud, local, or auto`);
+                    process.exit(1);
+                }
+                args.mode = mode;
+                i++;
+                break;
+            }
+            case '--api-key':
+                args.apiKey = nextArg(argv, i, '--api-key');
+                i++;
+                break;
+            case '--base-url':
+                args.baseUrl = nextArg(argv, i, '--base-url');
+                i++;
+                break;
+            case '--port':
+            case '--bridge-port': { // backwards compat
+                const portStr = nextArg(argv, i, argv[i]);
+                const port = parsePort(portStr);
+                if (!port) {
+                    console.error(`[thinkrun-mcp] Error: invalid port "${portStr}". Must be 1-65535`);
+                    process.exit(1);
+                }
+                args.port = port;
+                args.explicitPort = true;
+                i++;
+                break;
+            }
+            case '--session-id':
+                args.sessionId = nextArg(argv, i, '--session-id');
+                i++;
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+                break;
+            case '--version':
+            case '-v':
+                console.error(`@thinkrun/mcp v${readPackageVersion(new URL('../../package.json', import.meta.url))}`);
+                process.exit(0);
+                break;
+        }
+    }
+    // Environment variable fallbacks
+    args.apiKey = args.apiKey || process.env.THINKRUN_API_KEY || process.env.THINKBROWSE_API_KEY;
+    args.baseUrl = args.baseUrl || process.env.THINKRUN_BASE_URL || DEFAULT_CLOUD_URL;
+    // Port priority: CLI flag > env var > discovery file > default
+    if (!args.port) {
+        const envPort = parsePort(process.env.THINKRUN_BRIDGE_PORT || '');
+        if (envPort) {
+            args.port = envPort;
+            args.explicitPort = true;
+        }
+        else {
+            args.port = readDiscoveredPort() ?? DEFAULT_PORT;
+        }
+    }
+    args.sessionId = args.sessionId || process.env.SESSION_ID;
+    if (process.env.THINKRUN_LOCAL === 'true' && !args.mode) {
+        args.mode = 'local';
+    }
+    return args;
+}
+function printHelp() {
+    console.error(`
+ThinkRun MCP Server - Browser automation for AI agents
+
+Usage:
+  thinkrun-mcp [options]
+
+Options:
+  --mode <mode>        Connection mode: cloud, local, or auto (default: auto)
+  --api-key <key>      API key for cloud mode (or set THINKRUN_API_KEY)
+  --base-url <url>     Cloud API base URL (default: ${DEFAULT_CLOUD_URL})
+  --port <port>        Native host port (overrides discovery file)
+  --session-id <id>   Default session ID (enables session_use to switch default)
+  -h, --help           Show this help
+  -v, --version        Show version
+
+Port Discovery:
+  The native host writes its port to ~/.thinkbrowse/port on startup.
+  This is read automatically — no port configuration needed.
+  Priority: --port flag > THINKRUN_BRIDGE_PORT env > ~/.thinkbrowse/port > ${DEFAULT_PORT}
+
+Environment Variables:
+  THINKRUN_API_KEY      API key for cloud mode
+  THINKRUN_BASE_URL     Cloud API base URL
+  THINKRUN_BRIDGE_PORT  Override native host port
+  THINKRUN_LOCAL         Set to "true" to force local mode
+
+Modes:
+  cloud   Connect to ThinkRun cloud API (requires API key)
+  local   Connect to Chrome extension native host (auto-discovered port)
+  auto    Try native host first, fall back to cloud
+
+Examples:
+  # Cloud mode
+  thinkrun-mcp --mode cloud --api-key sk-abc123
+
+  # Local mode (Chrome + extension must be running)
+  thinkrun-mcp --mode local
+
+  # Auto-detect (default)
+  thinkrun-mcp
+
+Claude Desktop / Claude Code configuration:
+  {
+    "mcpServers": {
+      "thinkrun": {
+        "command": "npx",
+        "args": ["@thinkrun/mcp", "--mode", "local"]
+      }
+    }
+  }
+`.trim());
+}
+async function detectNativeHost(port) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 2000);
+    try {
+        const response = await fetch(`http://localhost:${port}/health`, {
+            signal: controller.signal,
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** LocalClient needs API URL + key for `/api/cache/*`; native host does not expose those routes. */
+function localClientConfig(args) {
+    return {
+        port: args.port,
+        serviceBaseUrl: args.baseUrl,
+        serviceApiKey: args.apiKey,
+    };
+}
+async function createClient(args) {
+    const mode = args.mode || 'auto';
+    if (mode === 'local') {
+        console.error(`[thinkrun-mcp] Local mode → native host at localhost:${args.port}`);
+        return new LocalClient(localClientConfig(args));
+    }
+    if (mode === 'cloud') {
+        if (!args.apiKey) {
+            console.error('[thinkrun-mcp] Error: --api-key or THINKRUN_API_KEY required for cloud mode');
+            process.exit(1);
+        }
+        console.error(`[thinkrun-mcp] Cloud mode → ${args.baseUrl}`);
+        return new CloudClient({ baseUrl: args.baseUrl, apiKey: args.apiKey });
+    }
+    // Auto-detect: try native host first
+    console.error('[thinkrun-mcp] Auto-detecting mode...');
+    const nativeHostAvailable = await detectNativeHost(args.port);
+    if (nativeHostAvailable) {
+        console.error(`[thinkrun-mcp] Native host detected → localhost:${args.port}`);
+        return new LocalClient(localClientConfig(args));
+    }
+    if (args.apiKey) {
+        console.error(`[thinkrun-mcp] No native host, using cloud → ${args.baseUrl}`);
+        return new CloudClient({ baseUrl: args.baseUrl, apiKey: args.apiKey });
+    }
+    console.error('[thinkrun-mcp] Error: Native host not running and no API key configured.');
+    console.error('  Open Chrome, Helium, or another supported Chromium browser with the ThinkRun extension for local mode, or set THINKRUN_API_KEY for cloud mode.');
+    process.exit(1);
+}
+async function main() {
+    const args = parseArgs();
+    const client = await createClient(args);
+    const defaultSessionRef = { current: args.sessionId ?? undefined };
+    const clientRef = { current: client };
+    const onSetMode = async (mode) => {
+        // Re-discover port only when startup port was not explicitly set (CLI/env).
+        // Explicit overrides stay sticky across mode switches.
+        const freshPort = args.explicitPort
+            ? args.port ?? DEFAULT_PORT
+            : readDiscoveredPort() ?? args.port ?? DEFAULT_PORT;
+        // Pre-flight validation — createClient calls process.exit on failure,
+        // which is uncatchable. Validate before delegating so set_mode returns
+        // a structured error instead of crashing the server.
+        if (mode === 'cloud' && !args.apiKey) {
+            throw new Error('Cloud mode requires an API key (set THINKRUN_API_KEY)');
+        }
+        // For local and auto, probe the native host once and resolve the effective mode
+        // so createClient doesn't repeat the health check.
+        let effectiveMode = mode === 'cloud' ? 'cloud' : 'local';
+        if (mode === 'local' || mode === 'auto') {
+            const hasNativeHost = await detectNativeHost(freshPort);
+            if (mode === 'local' && !hasNativeHost) {
+                throw new Error(`Local mode failed: native host not running on port ${freshPort}`);
+            }
+            if (mode === 'auto') {
+                if (hasNativeHost) {
+                    effectiveMode = 'local';
+                }
+                else if (args.apiKey) {
+                    effectiveMode = 'cloud';
+                }
+                else {
+                    throw new Error('Auto mode failed: native host not running and no API key configured');
+                }
+            }
+        }
+        const oldClient = clientRef.current;
+        const newArgs = { ...args, mode: effectiveMode, port: freshPort };
+        const newClient = await createClient(newArgs);
+        // Best-effort cleanup of old client resources (bounded to 2s)
+        if (oldClient && 'close' in oldClient && typeof oldClient.close === 'function') {
+            let timer;
+            const closePromise = oldClient.close();
+            const timeoutPromise = new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error('close timeout')), 2000);
+            });
+            try {
+                await Promise.race([closePromise, timeoutPromise]);
+            }
+            catch (err) {
+                console.error('[thinkrun-mcp] Warning: failed to close previous client:', err);
+            }
+            finally {
+                if (timer)
+                    clearTimeout(timer);
+                // Ensure close() rejection after timeout doesn't become unhandled
+                closePromise.catch(() => { });
+            }
+        }
+        // Clear default session — old session ID is invalid for the new client
+        defaultSessionRef.current = undefined;
+        console.error(`[thinkrun-mcp] Mode switched to: ${effectiveMode}`);
+        return { client: newClient, resolvedMode: effectiveMode };
+    };
+    const server = createServer(client, {
+        defaultSessionId: defaultSessionRef.current,
+        defaultSessionRef,
+        clientRef,
+        onSetMode,
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[thinkrun-mcp] Server running. Waiting for MCP client connection...');
+}
+main().catch((error) => {
+    console.error('[thinkrun-mcp] Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=thinkrun-mcp.js.map

package/dist/bin/thinkrun-mcp.js.map

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