@easbot/mcp 0.2.21

package/dist/index.d.cts

@@ -0,0 +1,408 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import z from 'zod';
+
+interface McpLocalConfig {
+    type: 'local';
+    command: string[];
+    environment?: Record<string, string>;
+    enabled?: boolean;
+    timeout?: number;
+}
+interface McpOAuthConfig {
+    clientId?: string;
+    clientSecret?: string;
+    scope?: string;
+}
+interface McpRemoteConfig {
+    type: 'remote';
+    url: string;
+    enabled?: boolean;
+    headers?: Record<string, string>;
+    oauth?: McpOAuthConfig | false;
+    timeout?: number;
+}
+type McpConfig = McpLocalConfig | McpRemoteConfig;
+declare const ServerTransportType: {
+    readonly STDIO: "stdio";
+    readonly HTTP: "http";
+};
+type ServerTransportType = (typeof ServerTransportType)[keyof typeof ServerTransportType];
+declare const ServerStatus: {
+    readonly STOPPED: "stopped";
+    readonly STARTING: "starting";
+    readonly RUNNING: "running";
+    readonly STOPPING: "stopping";
+    readonly ERROR: "error";
+};
+type ServerStatus = (typeof ServerStatus)[keyof typeof ServerStatus];
+interface ServerInfo {
+    id: string;
+    name: string;
+    version: string;
+    transportType: ServerTransportType;
+    status: ServerStatus;
+    createdAt: number;
+    lastActivityAt: number;
+    enabled?: boolean;
+}
+interface StdioServerConfig {
+    id: string;
+    name: string;
+    version: string;
+    transportType: typeof ServerTransportType.STDIO;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    enabled?: boolean;
+    timeout?: number;
+}
+interface HttpServerConfig {
+    id: string;
+    name: string;
+    version: string;
+    transportType: typeof ServerTransportType.HTTP;
+    url: string;
+    headers?: Record<string, string>;
+    enabled?: boolean;
+    timeout?: number;
+}
+interface ServerInstance$2 {
+    info: ServerInfo;
+    get server(): McpServer | null;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+
+interface ServerInstance$1 {
+    info: ServerInfo;
+    get server(): McpServer | null;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+declare class StdioServerAdapter {
+    private config;
+    private server;
+    private info;
+    private isStarting;
+    private isStopping;
+    private toolEventCleanup;
+    constructor(config: StdioServerConfig);
+    getInfo(): ServerInfo;
+    getConfig(): StdioServerConfig;
+    createInstance(): ServerInstance$1;
+    private loadTools;
+    private subscribeToolEvents;
+    private handleToolRegistered;
+    private adaptToolHandler;
+    private unsubscribeToolEvents;
+    private convertToZodSchema;
+    private jsonSchemaToZod;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+declare function createStdioServer(config: StdioServerConfig): StdioServerAdapter;
+declare function createAndStartStdioServer(config: StdioServerConfig): Promise<ServerInstance$1>;
+
+interface ServerInstance {
+    info: ServerInfo;
+    get server(): McpServer | null;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+declare class HttpServerAdapter {
+    private config;
+    private server;
+    private transport;
+    private httpServer;
+    private info;
+    private isStarting;
+    private isStopping;
+    private toolCleanup;
+    constructor(config: HttpServerConfig);
+    getInfo(): ServerInfo;
+    getConfig(): HttpServerConfig;
+    createInstance(): ServerInstance;
+    private loadTools;
+    private subscribeTools;
+    private handleTool;
+    private convertToZodSchema;
+    private jsonSchemaToZod;
+    private adaptToolHandler;
+    private unsubscribeTools;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+declare function createHttpServer(config: HttpServerConfig): HttpServerAdapter;
+declare function createAndStartHttpServer(config: HttpServerConfig): Promise<ServerInstance>;
+
+interface OAuthConfig {
+    clientId?: string;
+    clientSecret?: string;
+    scope?: string;
+    metadataUrl?: string;
+}
+interface LocalMCPConfig {
+    type: 'local';
+    command: string[];
+    environment?: Record<string, string>;
+    timeout?: number;
+}
+interface RemoteMCPConfig {
+    type: 'remote';
+    url: string;
+    headers?: Record<string, string>;
+    transport?: 'streamable-http' | 'sse';
+    oauth?: OAuthConfig | false;
+    timeout?: number;
+}
+type MCPConfig = LocalMCPConfig | RemoteMCPConfig;
+declare const Status: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"connected">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"disconnected">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    error: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"needs_auth">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"needs_client_registration">;
+    error: z.ZodString;
+}, z.core.$strip>], "status">;
+type Status = z.infer<typeof Status>;
+interface ToolMetadata {
+    name: string;
+    description?: string;
+    inputSchema: unknown;
+}
+interface ResourceMetadata {
+    name: string;
+    uri: string;
+    description?: string;
+    mimeType?: string;
+}
+interface PromptMetadata {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+interface ClientInfo {
+    id: string;
+    name: string;
+    status: Status;
+    connectedAt?: number;
+    serverVersion?: string;
+    protocolVersion?: string;
+    tools: ToolMetadata[];
+    resources: ResourceMetadata[];
+    prompts: PromptMetadata[];
+    error?: string;
+}
+interface ToolCallResult {
+    toolName: string;
+    args: Record<string, unknown>;
+    result: unknown;
+    success: boolean;
+    error?: string;
+    duration: number;
+}
+interface AuthResult {
+    authorizationUrl: string;
+    state?: string;
+}
+declare class MCPClient {
+    private id;
+    private client;
+    private _info;
+    private notificationCleanup;
+    private pendingTransport;
+    private oauthState;
+    private toolListChangedHandler;
+    constructor();
+    get info(): ClientInfo;
+    get status(): Status;
+    get tools(): ToolMetadata[];
+    connect(id: string, config: MCPConfig): Promise<void>;
+    startAuth(): Promise<AuthResult>;
+    finishAuth(authorizationCode?: string): Promise<void>;
+    disconnect(): Promise<void>;
+    listTools(): Promise<Record<string, unknown>>;
+    callTool(toolName: string, args: Record<string, unknown>, timeout?: number): Promise<ToolCallResult>;
+    listResources(): Promise<ResourceMetadata[]>;
+    readResource(uri: string): Promise<{
+        [x: string]: unknown;
+        contents: ({
+            uri: string;
+            text: string;
+            mimeType?: string | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        } | {
+            uri: string;
+            blob: string;
+            mimeType?: string | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined>;
+    listPrompts(): Promise<PromptMetadata[]>;
+    getPrompt(name: string, args?: Record<string, string>): Promise<{
+        [x: string]: unknown;
+        messages: {
+            role: "user" | "assistant";
+            content: {
+                type: "text";
+                text: string;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                type: "image";
+                data: string;
+                mimeType: string;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                type: "audio";
+                data: string;
+                mimeType: string;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                type: "resource";
+                resource: {
+                    uri: string;
+                    text: string;
+                    mimeType?: string | undefined;
+                    _meta?: Record<string, unknown> | undefined;
+                } | {
+                    uri: string;
+                    blob: string;
+                    mimeType?: string | undefined;
+                    _meta?: Record<string, unknown> | undefined;
+                };
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                uri: string;
+                name: string;
+                type: "resource_link";
+                description?: string | undefined;
+                mimeType?: string | undefined;
+                size?: number | undefined;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                icons?: {
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string[] | undefined;
+                    theme?: "light" | "dark" | undefined;
+                }[] | undefined;
+                title?: string | undefined;
+            };
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        description?: string | undefined;
+    } | undefined>;
+    refreshTools(): Promise<void>;
+    private createClient;
+    private fetchCapabilities;
+    private createLocalClient;
+    private createRemoteClient;
+    private connectWithTransport;
+    registerToolListChangedHandler(handler: () => void | Promise<void>): void;
+    private registerNotificationHandler;
+    private createInitialInfo;
+}
+declare function createMCPClient(): MCPClient;
+
+declare namespace Log {
+    const Level: z.ZodEnum<{
+        DEBUG: "DEBUG";
+        INFO: "INFO";
+        WARN: "WARN";
+        ERROR: "ERROR";
+    }>;
+    type Level = z.infer<typeof Level>;
+    function getLevel(): Level;
+    type Logger = {
+        debug(message?: any, extra?: Record<string, any>): void;
+        info(message?: any, extra?: Record<string, any>): void;
+        error(message?: any, extra?: Record<string, any>): void;
+        warn(message?: any, extra?: Record<string, any>): void;
+        tag(key: string, value: string): Logger;
+        clone(): Logger;
+        time(message: string, extra?: Record<string, any>): {
+            stop(): void;
+            [Symbol.dispose](): void;
+        };
+    };
+    const Default: Logger;
+    interface Options {
+        print: boolean;
+        logDir: string;
+        logFile?: string;
+        dev?: boolean;
+        level?: Level;
+    }
+    function file(): string;
+    function init(options: Options): Promise<void>;
+    function close(): Promise<void>;
+    function create(tags?: Record<string, any>): Logger;
+}
+
+declare function getVersion(): string;
+
+declare const VERSION = "0.2.20";
+declare const NAME = "@easbot/mcp";
+declare function initLog(options: {
+    print: boolean;
+    logDir?: string;
+    logFile?: string;
+    dev?: boolean;
+    level?: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+}): Promise<void>;
+
+export { type AuthResult, type ClientInfo, HttpServerAdapter, type HttpServerConfig, type LocalMCPConfig, Log, MCPClient, type MCPConfig, type McpConfig, type McpLocalConfig, type McpOAuthConfig, type McpRemoteConfig, NAME, type OAuthConfig, type PromptMetadata, type RemoteMCPConfig, type ResourceMetadata, type ServerInfo, type ServerInstance$2 as ServerInstance, ServerStatus, ServerTransportType, Status, StdioServerAdapter, type StdioServerConfig, type ToolCallResult, type ToolMetadata, VERSION, createAndStartHttpServer, createAndStartStdioServer, createHttpServer, createMCPClient, createStdioServer, getVersion, initLog };