@xiuchang-midscene/shared 2.0.2

package/dist/types/img/canvas-fallback.d.ts.bak

@@ -0,0 +1,105 @@
+/**
+ * Canvas-based fallback for image processing when Photon WASM fails to load.
+ * Provides a compatible API with Photon for browser environments.
+ */
+/**
+ * Canvas-based image class that mimics PhotonImage API
+ */
+export declare class CanvasImage {
+    private canvas;
+    private ctx;
+    private _width;
+    private _height;
+    constructor(canvas: HTMLCanvasElement);
+    get_width(): number;
+    get_height(): number;
+    get_raw_pixels(): Uint8Array;
+    get_bytes_jpeg(quality: number): Uint8Array;
+    free(): void;
+    _getCanvas(): HTMLCanvasElement;
+    _getContext(): CanvasRenderingContext2D;
+    /**
+     * Create a CanvasImage from a base64 string
+     */
+    static new_from_base64(base64Body: string): Promise<CanvasImage>;
+    /**
+     * Create a CanvasImage from a byte array (async version)
+     */
+    static new_from_byteslice(bytes: Uint8Array): Promise<CanvasImage>;
+}
+/**
+ * Sampling filter enum (compatible with Photon)
+ */
+export declare const CanvasSamplingFilter: {
+    readonly Nearest: "nearest";
+    readonly Triangle: "triangle";
+    readonly CatmullRom: "catmullrom";
+    readonly Gaussian: "gaussian";
+    readonly Lanczos3: "lanczos3";
+};
+/**
+ * RGBA color class (compatible with Photon)
+ */
+export declare class CanvasRgba {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+    constructor(r: number, g: number, b: number, a: number);
+}
+/**
+ * Resize an image
+ */
+export declare function canvasResize(image: CanvasImage, newWidth: number, newHeight: number, _filter: string): CanvasImage;
+/**
+ * Crop an image
+ */
+export declare function canvasCrop(image: CanvasImage, x1: number, y1: number, x2: number, y2: number): CanvasImage;
+/**
+ * Add padding to the right of an image
+ */
+export declare function canvasPaddingRight(image: CanvasImage, padding: number, color: CanvasRgba): CanvasImage;
+/**
+ * Add padding to the bottom of an image
+ */
+export declare function canvasPaddingBottom(image: CanvasImage, padding: number, color: CanvasRgba): CanvasImage;
+/**
+ * Add uniform padding to an image
+ */
+export declare function canvasPaddingUniform(image: CanvasImage, padding: number, color: CanvasRgba): CanvasImage;
+/**
+ * Add padding to the left of an image
+ */
+export declare function canvasPaddingLeft(image: CanvasImage, padding: number, color: CanvasRgba): CanvasImage;
+/**
+ * Add padding to the top of an image
+ */
+export declare function canvasPaddingTop(image: CanvasImage, padding: number, color: CanvasRgba): CanvasImage;
+/**
+ * Watermark an image (overlay one image on another)
+ */
+export declare function canvasWatermark(base: CanvasImage, overlay: CanvasImage, x: number, y: number): CanvasImage;
+/**
+ * Create and return the canvas fallback module with Photon-compatible API
+ */
+export declare function createCanvasFallbackModule(): {
+    PhotonImage: typeof CanvasImage;
+    SamplingFilter: {
+        readonly Nearest: "nearest";
+        readonly Triangle: "triangle";
+        readonly CatmullRom: "catmullrom";
+        readonly Gaussian: "gaussian";
+        readonly Lanczos3: "lanczos3";
+    };
+    resize: typeof canvasResize;
+    crop: typeof canvasCrop;
+    open_image: () => never;
+    base64_to_image: typeof CanvasImage.new_from_base64;
+    padding_uniform: typeof canvasPaddingUniform;
+    padding_left: typeof canvasPaddingLeft;
+    padding_right: typeof canvasPaddingRight;
+    padding_top: typeof canvasPaddingTop;
+    padding_bottom: typeof canvasPaddingBottom;
+    watermark: typeof canvasWatermark;
+    Rgba: typeof CanvasRgba;
+};

package/dist/types/img/get-photon.d.ts

@@ -0,0 +1,19 @@
+export default function getPhoton(): Promise<{
+    PhotonImage: typeof import('@silvia-odwyer/photon-node').PhotonImage;
+    SamplingFilter: typeof import('@silvia-odwyer/photon-node').SamplingFilter;
+    resize: typeof import('@silvia-odwyer/photon-node').resize;
+    crop: typeof import('@silvia-odwyer/photon-node').crop;
+    open_image: typeof import('@silvia-odwyer/photon-node').open_image;
+    base64_to_image: typeof import('@silvia-odwyer/photon-node').base64_to_image;
+    padding_uniform: typeof import('@silvia-odwyer/photon-node').padding_uniform;
+    padding_left: typeof import('@silvia-odwyer/photon-node').padding_left;
+    padding_right: typeof import('@silvia-odwyer/photon-node').padding_right;
+    padding_top: typeof import('@silvia-odwyer/photon-node').padding_top;
+    padding_bottom: typeof import('@silvia-odwyer/photon-node').padding_bottom;
+    watermark: typeof import('@silvia-odwyer/photon-node').watermark;
+    Rgba: typeof import('@silvia-odwyer/photon-node').Rgba;
+}>;
+/**
+ * Check if we're using the Canvas fallback instead of Photon
+ */
+export declare function isUsingCanvasFallback(): boolean;

package/dist/types/img/get-photon.d.ts.bak

@@ -0,0 +1,19 @@
+export default function getPhoton(): Promise<{
+    PhotonImage: typeof import('@silvia-odwyer/photon-node').PhotonImage;
+    SamplingFilter: typeof import('@silvia-odwyer/photon-node').SamplingFilter;
+    resize: typeof import('@silvia-odwyer/photon-node').resize;
+    crop: typeof import('@silvia-odwyer/photon-node').crop;
+    open_image: typeof import('@silvia-odwyer/photon-node').open_image;
+    base64_to_image: typeof import('@silvia-odwyer/photon-node').base64_to_image;
+    padding_uniform: typeof import('@silvia-odwyer/photon-node').padding_uniform;
+    padding_left: typeof import('@silvia-odwyer/photon-node').padding_left;
+    padding_right: typeof import('@silvia-odwyer/photon-node').padding_right;
+    padding_top: typeof import('@silvia-odwyer/photon-node').padding_top;
+    padding_bottom: typeof import('@silvia-odwyer/photon-node').padding_bottom;
+    watermark: typeof import('@silvia-odwyer/photon-node').watermark;
+    Rgba: typeof import('@silvia-odwyer/photon-node').Rgba;
+}>;
+/**
+ * Check if we're using the Canvas fallback instead of Photon
+ */
+export declare function isUsingCanvasFallback(): boolean;

package/dist/types/img/get-sharp.d.ts

@@ -0,0 +1,3 @@
+type TSharpModule = typeof import('sharp');
+export default function getSharp(): Promise<TSharpModule>;
+export {};

package/dist/types/img/get-sharp.d.ts.bak

@@ -0,0 +1,3 @@
+type TSharpModule = typeof import('sharp');
+export default function getSharp(): Promise<TSharpModule>;
+export {};

package/dist/types/img/index.d.ts

@@ -0,0 +1,3 @@
+export { imageInfoOfBase64, isValidPNGImageBuffer, isValidJPEGImageBuffer, isValidImageBuffer, } from './info';
+export { resizeAndConvertImgBuffer, resizeImgBase64, convertToJpegBase64, zoomForGPT4o, saveBase64Image, paddingToMatchBlockByBase64, cropByRect, scaleImage, localImg2Base64, httpImg2Base64, preProcessImageUrl, parseBase64, createImgBase64ByFormat, } from './transform';
+export { processImageElementInfo, compositeElementInfoImg, annotateRects, } from './box-select';

package/dist/types/img/index.d.ts.bak

@@ -0,0 +1,3 @@
+export { imageInfoOfBase64, isValidPNGImageBuffer, isValidJPEGImageBuffer, isValidImageBuffer, } from './info';
+export { resizeAndConvertImgBuffer, resizeImgBase64, convertToJpegBase64, zoomForGPT4o, saveBase64Image, paddingToMatchBlockByBase64, cropByRect, scaleImage, localImg2Base64, httpImg2Base64, preProcessImageUrl, parseBase64, createImgBase64ByFormat, } from './transform';
+export { processImageElementInfo, compositeElementInfoImg, annotateRects, } from './box-select';

package/dist/types/img/info.d.ts

@@ -0,0 +1,29 @@
+import type { Size } from '../types';
+export interface ImageInfo extends Size {
+}
+/**
+ * Retrieves the dimensions of an image from a base64-encoded string
+ *
+ * @param imageBase64 - The base64-encoded image data
+ * @returns A Promise that resolves to an object containing the width and height of the image
+ * @throws Error if the image data is invalid
+ */
+export declare function imageInfoOfBase64(imageBase64: string): Promise<ImageInfo>;
+/**
+ * Check if the Buffer is a valid PNG image
+ * @param buffer The Buffer to check
+ * @returns true if the Buffer is a valid PNG image, otherwise false
+ */
+export declare function isValidPNGImageBuffer(buffer: Buffer): boolean;
+/**
+ * Check if the Buffer is a valid JPEG image
+ * @param buffer The Buffer to check
+ * @returns true if the Buffer is a valid JPEG image, otherwise false
+ */
+export declare function isValidJPEGImageBuffer(buffer: Buffer): boolean;
+/**
+ * Check if the Buffer is a valid image (PNG or JPEG)
+ * @param buffer The Buffer to check
+ * @returns true if the Buffer is a valid PNG or JPEG image, otherwise false
+ */
+export declare function isValidImageBuffer(buffer: Buffer): boolean;

package/dist/types/img/info.d.ts.bak

@@ -0,0 +1,29 @@
+import type { Size } from '../types';
+export interface ImageInfo extends Size {
+}
+/**
+ * Retrieves the dimensions of an image from a base64-encoded string
+ *
+ * @param imageBase64 - The base64-encoded image data
+ * @returns A Promise that resolves to an object containing the width and height of the image
+ * @throws Error if the image data is invalid
+ */
+export declare function imageInfoOfBase64(imageBase64: string): Promise<ImageInfo>;
+/**
+ * Check if the Buffer is a valid PNG image
+ * @param buffer The Buffer to check
+ * @returns true if the Buffer is a valid PNG image, otherwise false
+ */
+export declare function isValidPNGImageBuffer(buffer: Buffer): boolean;
+/**
+ * Check if the Buffer is a valid JPEG image
+ * @param buffer The Buffer to check
+ * @returns true if the Buffer is a valid JPEG image, otherwise false
+ */
+export declare function isValidJPEGImageBuffer(buffer: Buffer): boolean;
+/**
+ * Check if the Buffer is a valid image (PNG or JPEG)
+ * @param buffer The Buffer to check
+ * @returns true if the Buffer is a valid PNG or JPEG image, otherwise false
+ */
+export declare function isValidImageBuffer(buffer: Buffer): boolean;

package/dist/types/img/transform.d.ts

@@ -0,0 +1,107 @@
+import { Buffer } from 'node:buffer';
+import type { PhotonImage as PhotonImageType } from '@silvia-odwyer/photon-node';
+import type { Rect } from '../types';
+/**
+ * Saves a Base64-encoded image to a file
+ *
+ * @param options - An object containing the Base64-encoded image data and the output file path
+ * @param options.base64Data - The Base64-encoded image data
+ * @param options.outputPath - The path where the image will be saved
+ * @throws Error if there is an error during the saving process
+ */
+export declare function saveBase64Image(options: {
+    base64Data: string;
+    outputPath: string;
+}): Promise<void>;
+/**
+ * Resizes an image from Buffer, maybe return a new format
+ * - If the image is Resized, the returned format will be jpg.
+ * - If the image is not Resized, it will return to its original format.
+ * @returns { buffer: resized buffer, format: the new format}
+ */
+export declare function resizeAndConvertImgBuffer(inputFormat: string, inputData: Buffer, newSize: {
+    width: number;
+    height: number;
+}): Promise<{
+    buffer: Buffer;
+    format: string;
+}>;
+export declare const createImgBase64ByFormat: (format: string, body: string) => string;
+export declare function resizeImgBase64(inputBase64: string, newSize: {
+    width: number;
+    height: number;
+}): Promise<string>;
+/**
+ * Calculates new dimensions for an image while maintaining its aspect ratio.
+ *
+ * This function is designed to resize an image to fit within a specified maximum width and height
+ * while maintaining the original aspect ratio. If the original width or height exceeds the maximum
+ * dimensions, the image will be scaled down to fit.
+ *
+ * @param {number} originalWidth - The original width of the image.
+ * @param {number} originalHeight - The original height of the image.
+ * @returns {Object} An object containing the new width and height.
+ * @throws {Error} Throws an error if the width or height is not a positive number.
+ */
+export declare function zoomForGPT4o(originalWidth: number, originalHeight: number): {
+    width: number;
+    height: number;
+};
+export declare function photonFromBase64(base64: string): Promise<PhotonImageType>;
+export declare function paddingToMatchBlock(image: PhotonImageType, blockSize?: number): Promise<{
+    width: number;
+    height: number;
+    image: PhotonImageType;
+}>;
+export declare function paddingToMatchBlockByBase64(imageBase64: string, blockSize?: number): Promise<{
+    width: number;
+    height: number;
+    imageBase64: string;
+}>;
+export declare function cropByRect(imageBase64: string, rect: Rect, paddingImage: boolean): Promise<{
+    width: number;
+    height: number;
+    imageBase64: string;
+}>;
+export declare function photonToBase64(image: PhotonImageType, quality?: number): Promise<string>;
+export declare const httpImg2Base64: (url: string) => Promise<string>;
+/**
+ * Convert image file to base64 string
+ * Because this method is synchronous, the npm package `sharp` cannot be used to detect the file type.
+ * TODO: convert to webp to reduce base64 size.
+ */
+export declare const localImg2Base64: (imgPath: string, withoutHeader?: boolean) => string;
+/**
+ * PreProcess image url to ensure image is accessible to LLM.
+ * @param url - The url of the image, it can be a http url or a base64 string or a file path
+ * @param convertHttpImage2Base64 - Whether to convert http image to base64, if true, the http image will be converted to base64, otherwise, the http image will be returned as is
+ * @returns The base64 string of the image (when convertHttpImage2Base64 is true or url is a file path) or the http image url
+ */
+export declare const preProcessImageUrl: (url: string, convertHttpImage2Base64: boolean) => Promise<string>;
+/**
+ * parse base64 string to get mimeType and body
+ */
+export declare const parseBase64: (fullBase64String: string) => {
+    mimeType: string;
+    body: string;
+};
+/**
+ * Convert a base64 image to JPEG with specified quality (no resize).
+ * If the image is already JPEG, re-encodes at the given quality.
+ *
+ * @param inputBase64 - Full data-URI base64 string (e.g. "data:image/png;base64,...")
+ * @param quality - JPEG quality 1-100
+ * @returns JPEG data-URI base64 string
+ */
+export declare function convertToJpegBase64(inputBase64: string, quality: number): Promise<string>;
+/**
+ * Scales an image by a specified factor using Sharp or Photon
+ * @param imageBase64 - Base64 encoded image
+ * @param scale - Scale factor (e.g., 2 for 2x, 1.5 for 1.5x)
+ * @returns Scaled image with new dimensions
+ */
+export declare function scaleImage(imageBase64: string, scale: number): Promise<{
+    width: number;
+    height: number;
+    imageBase64: string;
+}>;

package/dist/types/img/transform.d.ts.bak

@@ -0,0 +1,107 @@
+import { Buffer } from 'node:buffer';
+import type { PhotonImage as PhotonImageType } from '@silvia-odwyer/photon-node';
+import type { Rect } from '../types';
+/**
+ * Saves a Base64-encoded image to a file
+ *
+ * @param options - An object containing the Base64-encoded image data and the output file path
+ * @param options.base64Data - The Base64-encoded image data
+ * @param options.outputPath - The path where the image will be saved
+ * @throws Error if there is an error during the saving process
+ */
+export declare function saveBase64Image(options: {
+    base64Data: string;
+    outputPath: string;
+}): Promise<void>;
+/**
+ * Resizes an image from Buffer, maybe return a new format
+ * - If the image is Resized, the returned format will be jpg.
+ * - If the image is not Resized, it will return to its original format.
+ * @returns { buffer: resized buffer, format: the new format}
+ */
+export declare function resizeAndConvertImgBuffer(inputFormat: string, inputData: Buffer, newSize: {
+    width: number;
+    height: number;
+}): Promise<{
+    buffer: Buffer;
+    format: string;
+}>;
+export declare const createImgBase64ByFormat: (format: string, body: string) => string;
+export declare function resizeImgBase64(inputBase64: string, newSize: {
+    width: number;
+    height: number;
+}): Promise<string>;
+/**
+ * Calculates new dimensions for an image while maintaining its aspect ratio.
+ *
+ * This function is designed to resize an image to fit within a specified maximum width and height
+ * while maintaining the original aspect ratio. If the original width or height exceeds the maximum
+ * dimensions, the image will be scaled down to fit.
+ *
+ * @param {number} originalWidth - The original width of the image.
+ * @param {number} originalHeight - The original height of the image.
+ * @returns {Object} An object containing the new width and height.
+ * @throws {Error} Throws an error if the width or height is not a positive number.
+ */
+export declare function zoomForGPT4o(originalWidth: number, originalHeight: number): {
+    width: number;
+    height: number;
+};
+export declare function photonFromBase64(base64: string): Promise<PhotonImageType>;
+export declare function paddingToMatchBlock(image: PhotonImageType, blockSize?: number): Promise<{
+    width: number;
+    height: number;
+    image: PhotonImageType;
+}>;
+export declare function paddingToMatchBlockByBase64(imageBase64: string, blockSize?: number): Promise<{
+    width: number;
+    height: number;
+    imageBase64: string;
+}>;
+export declare function cropByRect(imageBase64: string, rect: Rect, paddingImage: boolean): Promise<{
+    width: number;
+    height: number;
+    imageBase64: string;
+}>;
+export declare function photonToBase64(image: PhotonImageType, quality?: number): Promise<string>;
+export declare const httpImg2Base64: (url: string) => Promise<string>;
+/**
+ * Convert image file to base64 string
+ * Because this method is synchronous, the npm package `sharp` cannot be used to detect the file type.
+ * TODO: convert to webp to reduce base64 size.
+ */
+export declare const localImg2Base64: (imgPath: string, withoutHeader?: boolean) => string;
+/**
+ * PreProcess image url to ensure image is accessible to LLM.
+ * @param url - The url of the image, it can be a http url or a base64 string or a file path
+ * @param convertHttpImage2Base64 - Whether to convert http image to base64, if true, the http image will be converted to base64, otherwise, the http image will be returned as is
+ * @returns The base64 string of the image (when convertHttpImage2Base64 is true or url is a file path) or the http image url
+ */
+export declare const preProcessImageUrl: (url: string, convertHttpImage2Base64: boolean) => Promise<string>;
+/**
+ * parse base64 string to get mimeType and body
+ */
+export declare const parseBase64: (fullBase64String: string) => {
+    mimeType: string;
+    body: string;
+};
+/**
+ * Convert a base64 image to JPEG with specified quality (no resize).
+ * If the image is already JPEG, re-encodes at the given quality.
+ *
+ * @param inputBase64 - Full data-URI base64 string (e.g. "data:image/png;base64,...")
+ * @param quality - JPEG quality 1-100
+ * @returns JPEG data-URI base64 string
+ */
+export declare function convertToJpegBase64(inputBase64: string, quality: number): Promise<string>;
+/**
+ * Scales an image by a specified factor using Sharp or Photon
+ * @param imageBase64 - Base64 encoded image
+ * @param scale - Scale factor (e.g., 2 for 2x, 1.5 for 1.5x)
+ * @returns Scaled image with new dimensions
+ */
+export declare function scaleImage(imageBase64: string, scale: number): Promise<{
+    width: number;
+    height: number;
+    imageBase64: string;
+}>;

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export { createCopyStaticPlugin, createPlaygroundCopyPlugin, } from './build/copy-static';
+export { commonIgnoreWarnings } from './build/rspack-config';
+declare const _default: {};
+export default _default;

package/dist/types/index.d.ts.bak

@@ -0,0 +1,4 @@
+export { createCopyStaticPlugin, createPlaygroundCopyPlugin, } from './build/copy-static';
+export { commonIgnoreWarnings } from './build/rspack-config';
+declare const _default: {};
+export default _default;

package/dist/types/logger.d.ts

@@ -0,0 +1,5 @@
+export type DebugFunction = (...args: unknown[]) => void;
+export declare function getDebug(topic: string, options?: {
+    console?: boolean;
+}): DebugFunction;
+export declare function enableDebug(topic: string): void;

package/dist/types/logger.d.ts.bak

@@ -0,0 +1,5 @@
+export type DebugFunction = (...args: unknown[]) => void;
+export declare function getDebug(topic: string, options?: {
+    console?: boolean;
+}): DebugFunction;
+export declare function enableDebug(topic: string): void;

package/dist/types/mcp/base-server.d.ts

@@ -0,0 +1,93 @@
+import type { ParseArgsConfig } from 'node:util';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { IMidsceneTools } from './types';
+export interface BaseMCPServerConfig {
+    name: string;
+    version: string;
+    description: string;
+}
+export interface HttpLaunchOptions {
+    port: number;
+    host?: string;
+}
+export interface LaunchMCPServerResult {
+    /**
+     * The MCP server port (for HTTP mode)
+     */
+    port?: number;
+    /**
+     * The server host (for HTTP mode)
+     */
+    host?: string;
+    /**
+     * Function to gracefully shutdown the MCP server
+     */
+    close: () => Promise<void>;
+}
+/**
+ * CLI argument configuration for MCP servers
+ */
+export declare const CLI_ARGS_CONFIG: ParseArgsConfig['options'];
+export interface CLIArgs {
+    mode?: string;
+    port?: string;
+    host?: string;
+}
+/**
+ * Launch an MCP server based on CLI arguments
+ * Shared helper to reduce duplication across platform CLI entry points
+ */
+export declare function launchMCPServer(server: BaseMCPServer, args: CLIArgs): Promise<LaunchMCPServerResult>;
+/**
+ * Base MCP Server class with programmatic launch() API
+ * Each platform extends this to provide their own tools manager
+ */
+export declare abstract class BaseMCPServer {
+    protected mcpServer: McpServer;
+    protected toolsManager?: IMidsceneTools;
+    protected config: BaseMCPServerConfig;
+    protected providedToolsManager?: IMidsceneTools;
+    constructor(config: BaseMCPServerConfig, toolsManager?: IMidsceneTools);
+    /**
+     * Platform-specific: create tools manager instance
+     * This is only called if no tools manager was provided in constructor
+     */
+    protected abstract createToolsManager(): IMidsceneTools;
+    /**
+     * Initialize tools manager and attach to MCP server
+     */
+    private initializeToolsManager;
+    /**
+     * Perform cleanup on shutdown
+     */
+    private performCleanup;
+    /**
+     * Initialize and launch the MCP server with stdio transport
+     */
+    launch(): Promise<LaunchMCPServerResult>;
+    /**
+     * Launch MCP server with HTTP transport
+     * Supports stateful sessions for web applications and service integration
+     */
+    launchHttp(options: HttpLaunchOptions): Promise<LaunchMCPServerResult>;
+    /**
+     * Create a new HTTP session with transport
+     */
+    private createHttpSession;
+    /**
+     * Start periodic session cleanup for inactive sessions
+     */
+    private startSessionCleanup;
+    /**
+     * Setup shutdown handlers for HTTP server
+     */
+    private setupHttpShutdownHandlers;
+    /**
+     * Get the underlying MCP server instance
+     */
+    getServer(): McpServer;
+    /**
+     * Get the tools manager instance
+     */
+    getToolsManager(): IMidsceneTools | undefined;
+}

package/dist/types/mcp/base-server.d.ts.bak

@@ -0,0 +1,93 @@
+import type { ParseArgsConfig } from 'node:util';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { IMidsceneTools } from './types';
+export interface BaseMCPServerConfig {
+    name: string;
+    version: string;
+    description: string;
+}
+export interface HttpLaunchOptions {
+    port: number;
+    host?: string;
+}
+export interface LaunchMCPServerResult {
+    /**
+     * The MCP server port (for HTTP mode)
+     */
+    port?: number;
+    /**
+     * The server host (for HTTP mode)
+     */
+    host?: string;
+    /**
+     * Function to gracefully shutdown the MCP server
+     */
+    close: () => Promise<void>;
+}
+/**
+ * CLI argument configuration for MCP servers
+ */
+export declare const CLI_ARGS_CONFIG: ParseArgsConfig['options'];
+export interface CLIArgs {
+    mode?: string;
+    port?: string;
+    host?: string;
+}
+/**
+ * Launch an MCP server based on CLI arguments
+ * Shared helper to reduce duplication across platform CLI entry points
+ */
+export declare function launchMCPServer(server: BaseMCPServer, args: CLIArgs): Promise<LaunchMCPServerResult>;
+/**
+ * Base MCP Server class with programmatic launch() API
+ * Each platform extends this to provide their own tools manager
+ */
+export declare abstract class BaseMCPServer {
+    protected mcpServer: McpServer;
+    protected toolsManager?: IMidsceneTools;
+    protected config: BaseMCPServerConfig;
+    protected providedToolsManager?: IMidsceneTools;
+    constructor(config: BaseMCPServerConfig, toolsManager?: IMidsceneTools);
+    /**
+     * Platform-specific: create tools manager instance
+     * This is only called if no tools manager was provided in constructor
+     */
+    protected abstract createToolsManager(): IMidsceneTools;
+    /**
+     * Initialize tools manager and attach to MCP server
+     */
+    private initializeToolsManager;
+    /**
+     * Perform cleanup on shutdown
+     */
+    private performCleanup;
+    /**
+     * Initialize and launch the MCP server with stdio transport
+     */
+    launch(): Promise<LaunchMCPServerResult>;
+    /**
+     * Launch MCP server with HTTP transport
+     * Supports stateful sessions for web applications and service integration
+     */
+    launchHttp(options: HttpLaunchOptions): Promise<LaunchMCPServerResult>;
+    /**
+     * Create a new HTTP session with transport
+     */
+    private createHttpSession;
+    /**
+     * Start periodic session cleanup for inactive sessions
+     */
+    private startSessionCleanup;
+    /**
+     * Setup shutdown handlers for HTTP server
+     */
+    private setupHttpShutdownHandlers;
+    /**
+     * Get the underlying MCP server instance
+     */
+    getServer(): McpServer;
+    /**
+     * Get the tools manager instance
+     */
+    getToolsManager(): IMidsceneTools | undefined;
+}