@nimrobo/mcporter-remote 0.1.0

package/dist/generate-cli.js

@@ -0,0 +1,155 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { bundleOutput, compileBundleWithBun, computeCompileTarget, resolveBundleTarget, } from './cli/generate/artifacts.js';
+import { ensureInvocationDefaults, fetchTools, resolveServerDefinition } from './cli/generate/definition.js';
+import { resolveRuntimeKind } from './cli/generate/runtime.js';
+import { readPackageMetadata, writeTemplate } from './cli/generate/template.js';
+import { buildToolMetadata, toolsTestHelpers } from './cli/generate/tools.js';
+import { serializeDefinition } from './cli-metadata.js';
+// generateCli produces a standalone CLI (and optional bundle/binary) for a given MCP server.
+export async function generateCli(options) {
+    const runtimeKind = await resolveRuntimeKind(options.runtime, options.compile);
+    const bundlerKind = options.bundler ?? (runtimeKind === 'bun' ? 'bun' : 'rolldown');
+    if (bundlerKind === 'bun' && runtimeKind !== 'bun') {
+        throw new Error('--bundler bun currently requires --runtime bun.');
+    }
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const { definition: baseDefinition, name } = await resolveServerDefinition(options.serverRef, options.configPath, options.rootDir);
+    const { tools: allTools, derivedDescription } = await fetchTools(baseDefinition, name, options.configPath, options.rootDir);
+    const tools = applyToolFilters(allTools, options.includeTools, options.excludeTools);
+    const definition = baseDefinition.description || !derivedDescription
+        ? baseDefinition
+        : { ...baseDefinition, description: derivedDescription };
+    const toolMetadata = tools.map((tool) => buildToolMetadata(tool));
+    const generator = await readPackageMetadata();
+    const baseInvocation = ensureInvocationDefaults({
+        serverRef: options.serverRef,
+        configPath: options.configPath,
+        rootDir: options.rootDir,
+        runtime: runtimeKind,
+        bundler: bundlerKind,
+        outputPath: options.outputPath,
+        bundle: options.bundle,
+        compile: options.compile,
+        timeoutMs,
+        minify: options.minify ?? false,
+        includeTools: options.includeTools,
+        excludeTools: options.excludeTools,
+    }, definition);
+    const embeddedMetadata = {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        generator,
+        server: {
+            name,
+            source: definition.source,
+            definition: serializeDefinition(definition),
+        },
+        artifact: {
+            path: '',
+            kind: 'template',
+        },
+        invocation: baseInvocation,
+    };
+    let templateTmpDir;
+    let templateOutputPath = options.outputPath;
+    if (!templateOutputPath && options.compile) {
+        const tmpPrefix = path.join(process.cwd(), 'tmp', 'mcporter-cli-');
+        await fs.mkdir(path.dirname(tmpPrefix), { recursive: true });
+        templateTmpDir = await fs.mkdtemp(tmpPrefix);
+        templateOutputPath = path.join(templateTmpDir, `${name}.ts`);
+    }
+    const outputPath = await writeTemplate({
+        outputPath: templateOutputPath,
+        runtimeKind,
+        timeoutMs,
+        definition,
+        serverName: name,
+        tools: toolMetadata,
+        generator,
+        metadata: embeddedMetadata,
+    });
+    let bundlePath;
+    let compilePath;
+    try {
+        const shouldBundle = Boolean(options.bundle ?? options.compile);
+        if (shouldBundle) {
+            const targetPath = resolveBundleTarget({
+                bundle: options.bundle,
+                compile: options.compile,
+                outputPath,
+            });
+            bundlePath = await bundleOutput({
+                sourcePath: outputPath,
+                runtimeKind,
+                targetPath,
+                minify: options.minify ?? false,
+                bundler: bundlerKind,
+            });
+            if (options.compile) {
+                if (runtimeKind !== 'bun') {
+                    throw new Error('--compile is only supported when --runtime bun');
+                }
+                const compileTarget = computeCompileTarget(options.compile, bundlePath, name);
+                await compileBundleWithBun(bundlePath, compileTarget);
+                compilePath = compileTarget;
+                if (!options.bundle) {
+                    await fs.rm(bundlePath).catch(() => { });
+                    bundlePath = undefined;
+                }
+            }
+        }
+    }
+    finally {
+        if (templateTmpDir) {
+            await fs.rm(templateTmpDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+    return { outputPath: options.outputPath ?? outputPath, bundlePath, compilePath };
+}
+function applyToolFilters(tools, includeTools, excludeTools) {
+    if (includeTools && excludeTools) {
+        throw new Error('Internal error: both includeTools and excludeTools provided to generateCli.');
+    }
+    if (includeTools && includeTools.length === 0) {
+        throw new Error('--include-tools requires at least one tool name.');
+    }
+    if (excludeTools && excludeTools.length === 0) {
+        throw new Error('--exclude-tools requires at least one tool name.');
+    }
+    if (!includeTools && !excludeTools) {
+        return tools;
+    }
+    const toolMap = new Map(tools.map((tool) => [tool.name, tool]));
+    if (includeTools && includeTools.length > 0) {
+        const result = [];
+        const missing = [];
+        for (const name of includeTools) {
+            const match = toolMap.get(name);
+            if (match) {
+                result.push(match);
+            }
+            else {
+                missing.push(name);
+            }
+        }
+        if (missing.length > 0) {
+            throw new Error(`Requested tools not found on server: ${missing.join(', ')}. Available tools: ${tools.map((tool) => tool.name).join(', ')}`);
+        }
+        if (result.length === 0) {
+            throw new Error('No tools remain after applying --include-tools filter.');
+        }
+        return result;
+    }
+    if (excludeTools && excludeTools.length > 0) {
+        const excludeSet = new Set(excludeTools);
+        const filtered = tools.filter((tool) => !excludeSet.has(tool.name));
+        if (filtered.length === 0) {
+            throw new Error(`All tools were excluded. Exclude list: ${[...excludeSet].join(', ')}. Available tools: ${tools.map((tool) => tool.name).join(', ')}`);
+        }
+        return filtered;
+    }
+    return tools;
+}
+export const __test = { ...toolsTestHelpers, applyToolFilters };
+//# sourceMappingURL=generate-cli.js.map

package/dist/generate-cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { CommandSpec, ServerDefinition } from './config.js';
+export { loadServerDefinitions } from './config.js';
+export type { CallResult, ConnectionIssue, ImageContent } from './result-utils.js';
+export { createCallResult, describeConnectionIssue, wrapCallResult } from './result-utils.js';
+export type { CallOptions, ListToolsOptions, Runtime, RuntimeLogger, ServerToolInfo, } from './runtime.js';
+export { callOnce, createRuntime } from './runtime.js';
+export type { ServerProxyOptions } from './server-proxy.js';
+export { createServerProxy } from './server-proxy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9F,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { loadServerDefinitions } from './config.js';
+export { createCallResult, describeConnectionIssue, wrapCallResult } from './result-utils.js';
+export { callOnce, createRuntime } from './runtime.js';
+export { createServerProxy } from './server-proxy.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQ9F,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,8 @@
+import type { CommandSpec, RawLifecycle, ServerDefinition, ServerLifecycle } from './config-schema.js';
+declare const DEFAULT_KEEP_ALIVE: Set<string>;
+export declare function resolveLifecycle(name: string, rawLifecycle: RawLifecycle | undefined, command: CommandSpec): ServerLifecycle | undefined;
+export declare function canonicalKeepAliveName(command: CommandSpec): string | undefined;
+export declare function isKeepAliveServer(definition: ServerDefinition | undefined): boolean;
+export declare function keepAliveIdleTimeout(definition: ServerDefinition): number | undefined;
+export { DEFAULT_KEEP_ALIVE };
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEvG,QAAA,MAAM,kBAAkB,aAA2D,CAAC;AAuBpF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,OAAO,EAAE,WAAW,GACnB,eAAe,GAAG,SAAS,CA8B7B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAS/E;AAwDD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAEnF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAKrF;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/lifecycle.js

@@ -0,0 +1,106 @@
+const DEFAULT_KEEP_ALIVE = new Set(['chrome-devtools', 'mobile-mcp', 'playwright']);
+const includeOverride = parseList(process.env.MCPORTER_KEEPALIVE);
+const excludeOverride = parseList(process.env.MCPORTER_DISABLE_KEEPALIVE ?? process.env.MCPORTER_NO_KEEPALIVE);
+const KEEP_ALIVE_COMMANDS = [
+    { label: 'chrome-devtools', fragments: ['chrome-devtools-mcp'] },
+    { label: 'mobile-mcp', fragments: ['@mobilenext/mobile-mcp', 'mobile-mcp'] },
+    { label: 'playwright', fragments: ['@playwright/mcp', 'playwright/mcp'] },
+];
+const CHROME_DEVTOOLS_URL_PLACEHOLDERS = [String.raw `\${CHROME_DEVTOOLS_URL}`, '$env:CHROME_DEVTOOLS_URL'];
+export function resolveLifecycle(name, rawLifecycle, command) {
+    const normalizedName = name.toLowerCase();
+    const canonicalName = canonicalKeepAliveName(command);
+    const candidateNames = new Set([normalizedName]);
+    if (canonicalName) {
+        candidateNames.add(canonicalName);
+    }
+    const forcedDisable = excludeOverride.all || matchesOverride(excludeOverride.names, candidateNames);
+    const forcedEnable = includeOverride.all || matchesOverride(includeOverride.names, candidateNames);
+    if (forcedEnable) {
+        return { mode: 'keep-alive' };
+    }
+    if (forcedDisable) {
+        return undefined;
+    }
+    const lifecycle = rawLifecycle ? coerceLifecycle(rawLifecycle) : undefined;
+    if (lifecycle) {
+        return lifecycle;
+    }
+    if (commandRequiresDynamicChromePort(command)) {
+        // Each Chrome DevTools MCP instance is tied to a specific Chrome port. Opt out of keep-alive so
+        // the runtime (and daemon) relaunches the bridge whenever CHROME_DEVTOOLS_URL changes.
+        return { mode: 'ephemeral' };
+    }
+    if (Array.from(candidateNames).some((candidate) => DEFAULT_KEEP_ALIVE.has(candidate))) {
+        return { mode: 'keep-alive' };
+    }
+    return undefined;
+}
+export function canonicalKeepAliveName(command) {
+    if (command.kind !== 'stdio') {
+        return undefined;
+    }
+    const tokens = [command.command, ...command.args].map((token) => token.toLowerCase());
+    const match = KEEP_ALIVE_COMMANDS.find((signature) => signature.fragments.some((fragment) => tokens.some((token) => token.includes(fragment))));
+    return match?.label;
+}
+function commandRequiresDynamicChromePort(command) {
+    if (command.kind !== 'stdio') {
+        return false;
+    }
+    const tokens = [command.command, ...command.args];
+    return tokens.some((token) => CHROME_DEVTOOLS_URL_PLACEHOLDERS.some((placeholder) => token.includes(placeholder)));
+}
+function parseList(value) {
+    if (!value) {
+        return { all: false, names: new Set() };
+    }
+    const names = value
+        .split(',')
+        .map((token) => token.trim().toLowerCase())
+        .filter((token) => token.length > 0);
+    if (names.includes('*')) {
+        return { all: true, names: new Set() };
+    }
+    return { all: false, names: new Set(names) };
+}
+function matchesOverride(names, candidates) {
+    for (const candidate of candidates) {
+        if (names.has(candidate)) {
+            return true;
+        }
+    }
+    return false;
+}
+function coerceLifecycle(raw) {
+    if (typeof raw === 'string') {
+        if (raw === 'keep-alive') {
+            return { mode: 'keep-alive' };
+        }
+        if (raw === 'ephemeral') {
+            return { mode: 'ephemeral' };
+        }
+        return undefined;
+    }
+    if (raw.mode === 'keep-alive') {
+        const timeout = typeof raw.idleTimeoutMs === 'number' && Number.isFinite(raw.idleTimeoutMs) && raw.idleTimeoutMs > 0
+            ? Math.trunc(raw.idleTimeoutMs)
+            : undefined;
+        return timeout ? { mode: 'keep-alive', idleTimeoutMs: timeout } : { mode: 'keep-alive' };
+    }
+    if (raw.mode === 'ephemeral') {
+        return { mode: 'ephemeral' };
+    }
+    return undefined;
+}
+export function isKeepAliveServer(definition) {
+    return definition?.lifecycle?.mode === 'keep-alive';
+}
+export function keepAliveIdleTimeout(definition) {
+    if (definition.lifecycle?.mode !== 'keep-alive') {
+        return undefined;
+    }
+    return definition.lifecycle.idleTimeoutMs;
+}
+export { DEFAULT_KEEP_ALIVE };
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

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

package/dist/logging.d.ts

@@ -0,0 +1,19 @@
+declare const LOG_LEVEL_ORDER: {
+    readonly debug: 10;
+    readonly info: 20;
+    readonly warn: 30;
+    readonly error: 40;
+};
+type LogLevelKey = keyof typeof LOG_LEVEL_ORDER;
+export type LogLevel = LogLevelKey;
+export interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string, error?: unknown): void;
+    debug?(message: string): void;
+}
+export declare function parseLogLevel(value: string | undefined, defaultLevel?: LogLevel): LogLevel;
+export declare function resolveLogLevelFromEnv(env?: NodeJS.ProcessEnv, defaultLevel?: LogLevel): LogLevel;
+export declare function createPrefixedConsoleLogger(prefix: string, level: LogLevel): Logger;
+export {};
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,eAAe;;;;;CAKX,CAAC;AAEX,KAAK,WAAW,GAAG,MAAM,OAAO,eAAe,CAAC;AAOhD,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEnC,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9C,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAGD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,GAAE,QAAiB,GAAG,QAAQ,CAiBlG;AAGD,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,YAAY,GAAE,QAAiB,GAC9B,QAAQ,CASV;AAQD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CA4BnF"}

package/dist/logging.js

@@ -0,0 +1,76 @@
+const LOG_LEVEL_ORDER = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+const LOG_LEVEL_ALIASES = {
+    warning: 'warn',
+    verbose: 'debug',
+};
+// parseLogLevel normalizes arbitrary input into one of the supported log level keywords.
+export function parseLogLevel(value, defaultLevel = 'warn') {
+    if (!value) {
+        return defaultLevel;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (!normalized) {
+        return defaultLevel;
+    }
+    const alias = LOG_LEVEL_ALIASES[normalized];
+    const candidate = alias ?? (normalized in LOG_LEVEL_ORDER ? normalized : undefined);
+    if (!candidate) {
+        const allowed = [...Object.keys(LOG_LEVEL_ORDER), ...Object.keys(LOG_LEVEL_ALIASES)]
+            .filter((key, index, array) => array.indexOf(key) === index)
+            .join(', ');
+        throw new Error(`Invalid log level '${value}'. Expected one of: ${allowed}.`);
+    }
+    return candidate;
+}
+// resolveLogLevelFromEnv reads MCPORTER_LOG_LEVEL and falls back to the provided default when invalid.
+export function resolveLogLevelFromEnv(env = process.env, defaultLevel = 'warn') {
+    try {
+        return parseLogLevel(env.MCPORTER_LOG_LEVEL, defaultLevel);
+    }
+    catch (error) {
+        const raw = env.MCPORTER_LOG_LEVEL;
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`[mcporter] Ignoring invalid MCPORTER_LOG_LEVEL value '${raw ?? ''}': ${message}`);
+        return defaultLevel;
+    }
+}
+// shouldLog determines whether a candidate level passes the configured threshold.
+function shouldLog(level, threshold) {
+    return LOG_LEVEL_ORDER[level] >= LOG_LEVEL_ORDER[threshold];
+}
+// createPrefixedConsoleLogger wraps console.* with a consistent prefix and level filtering.
+export function createPrefixedConsoleLogger(prefix, level) {
+    const threshold = parseLogLevel(level);
+    const format = (message) => `[${prefix}] ${message}`;
+    return {
+        debug(message) {
+            if (shouldLog('debug', threshold)) {
+                console.debug(format(message));
+            }
+        },
+        info(message) {
+            if (shouldLog('info', threshold)) {
+                console.log(format(message));
+            }
+        },
+        warn(message) {
+            if (shouldLog('warn', threshold)) {
+                console.warn(format(message));
+            }
+        },
+        error(message, error) {
+            if (shouldLog('error', threshold)) {
+                console.error(format(message));
+                if (error) {
+                    console.error(error);
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

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

package/dist/oauth-manual.d.ts

@@ -0,0 +1,9 @@
+export interface ParsedManualOAuthCallback {
+    readonly code?: string;
+    readonly state?: string;
+    readonly error?: string;
+    readonly errorDescription?: string;
+    readonly callbackUrl?: string;
+}
+export declare function parseManualOAuthCallback(input: string): ParsedManualOAuthCallback;
+//# sourceMappingURL=oauth-manual.d.ts.map

package/dist/oauth-manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-manual.d.ts","sourceRoot":"","sources":["../src/oauth-manual.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,yBAAyB,CAmBjF"}

package/dist/oauth-manual.js

@@ -0,0 +1,84 @@
+import { URL } from 'node:url';
+export function parseManualOAuthCallback(input) {
+    const normalized = normalizeManualInput(input);
+    const candidates = extractUrlCandidates(normalized);
+    for (const candidate of candidates) {
+        const parsed = tryParseUrlPayload(candidate);
+        if (parsed) {
+            return parsed;
+        }
+    }
+    const inline = tryParseQueryPayload(normalized);
+    if (inline) {
+        return inline;
+    }
+    throw new Error('Could not extract OAuth callback details. Paste the full redirected URL, the raw query string, or browser text containing the URL.');
+}
+function normalizeManualInput(input) {
+    return input
+        .trim()
+        .replace(/^['"`<([]+/, '')
+        .replace(/['"`>\])\s.,;:!?]+$/, '')
+        .replace(/&amp;/gi, '&');
+}
+function extractUrlCandidates(input) {
+    const matches = input.match(/https?:\/\/[^\s"'<>]+/gi) ?? [];
+    if (matches.length > 0) {
+        return matches.map((match) => sanitizeUrlCandidate(match));
+    }
+    if (input.startsWith('http://') || input.startsWith('https://')) {
+        return [sanitizeUrlCandidate(input)];
+    }
+    return [];
+}
+function sanitizeUrlCandidate(value) {
+    return value.replace(/[),.;]+$/, '').replace(/&amp;/gi, '&');
+}
+function tryParseUrlPayload(value) {
+    try {
+        const url = new URL(value);
+        return extractPayload(url, value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function tryParseQueryPayload(value) {
+    const query = value.startsWith('?') ? value.slice(1) : value;
+    if (!query.includes('=')) {
+        return undefined;
+    }
+    const params = new URLSearchParams(query);
+    const payload = extractParams(params);
+    return payload ? { ...payload } : undefined;
+}
+function extractPayload(url, callbackUrl) {
+    const direct = extractParams(url.searchParams);
+    if (direct) {
+        return { ...direct, callbackUrl };
+    }
+    if (url.hash.startsWith('#')) {
+        const hashParams = new URLSearchParams(url.hash.slice(1));
+        const hashed = extractParams(hashParams);
+        if (hashed) {
+            return { ...hashed, callbackUrl };
+        }
+    }
+    return undefined;
+}
+function extractParams(params) {
+    const code = params.get('code') ?? undefined;
+    const state = params.get('state') ?? undefined;
+    const error = params.get('error') ?? undefined;
+    const errorDescription = params.get('error_description') ?? undefined;
+    if (!code && !error) {
+        return undefined;
+    }
+    return {
+        code: code?.trim() || undefined,
+        state: state?.trim() || undefined,
+        error: error?.trim() || undefined,
+        errorDescription: errorDescription?.trim() || undefined,
+    };
+}
+//# sourceMappingURL=oauth-manual.js.map

package/dist/oauth-manual.js.map

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

package/dist/oauth-persistence.d.ts

@@ -0,0 +1,20 @@
+import type { OAuthClientInformationMixed, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+import type { ServerDefinition } from './config.js';
+import type { Logger } from './logging.js';
+export type OAuthClearScope = 'all' | 'client' | 'tokens' | 'verifier' | 'state';
+export interface OAuthPersistence {
+    describe(): string;
+    readTokens(): Promise<OAuthTokens | undefined>;
+    saveTokens(tokens: OAuthTokens): Promise<void>;
+    readClientInfo(): Promise<OAuthClientInformationMixed | undefined>;
+    saveClientInfo(info: OAuthClientInformationMixed): Promise<void>;
+    readCodeVerifier(): Promise<string | undefined>;
+    saveCodeVerifier(value: string): Promise<void>;
+    readState(): Promise<string | undefined>;
+    saveState(value: string): Promise<void>;
+    clear(scope: OAuthClearScope): Promise<void>;
+}
+export declare function buildOAuthPersistence(definition: ServerDefinition, logger?: Logger): Promise<OAuthPersistence>;
+export declare function clearOAuthCaches(definition: ServerDefinition, logger?: Logger, scope?: OAuthClearScope): Promise<void>;
+export declare function readCachedAccessToken(definition: ServerDefinition, logger?: Logger): Promise<string | undefined>;
+//# sourceMappingURL=oauth-persistence.d.ts.map

package/dist/oauth-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-persistence.d.ts","sourceRoot":"","sources":["../src/oauth-persistence.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAEjF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,IAAI,MAAM,CAAC;IACnB,UAAU,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC/C,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,cAAc,IAAI,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAAC;IACnE,cAAc,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAkND,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkCpH;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,GAAE,eAAuB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO7B"}