mcp-orbit 0.1.0

package/dist/clients/mcp-stdio.js

@@ -0,0 +1,164 @@
+/**
+ * Stdio MCP Client
+ *
+ * Client for connecting to MCP servers via stdio (local child process)
+ * Features:
+ * - Client caching & connection pooling
+ * - Type-safe tool execution
+ * - Resource & Prompt management
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+export class StdioMCPClient {
+    clientCache = new Map();
+    connectionPromises = new Map();
+    serverConfig;
+    // Event handlers (exposed from underlying MCP SDK Client)
+    onerror;
+    onclose;
+    constructor(serverConfig) {
+        this.serverConfig = serverConfig;
+    }
+    // ============================================================================
+    // TOOLS
+    // ============================================================================
+    async listTools(timeoutMs = 15000) {
+        const client = await this.getOrCreateClient(this.serverConfig, timeoutMs);
+        const resp = (await client.listTools({}, { timeout: timeoutMs }));
+        const tools = Array.isArray(resp?.tools)
+            ? resp.tools.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+                input_schema: tool.input_schema ?? tool.inputSchema ?? { type: "object", properties: {} },
+                tags: tool.tags ?? tool._meta?.tags,
+            }))
+            : [];
+        return { tools };
+    }
+    async callTool(toolName, args, timeoutMs = 15000) {
+        const client = await this.getOrCreateClient(this.serverConfig, timeoutMs);
+        const response = (await client.callTool({
+            name: toolName,
+            arguments: args,
+        }, undefined, { timeout: timeoutMs }));
+        return {
+            content: Array.isArray(response?.content) ? response.content : [],
+            isError: response?.isError ?? false,
+            structuredContent: response?.structuredContent,
+            _meta: response?._meta,
+        };
+    }
+    // ============================================================================
+    // RESOURCES
+    // ============================================================================
+    async listResources(timeoutMs = 15000) {
+        const client = await this.getOrCreateClient(this.serverConfig, timeoutMs);
+        const response = (await client.listResources({}, { timeout: timeoutMs }));
+        return {
+            resources: response.resources || [],
+        };
+    }
+    async readResource(uri, timeoutMs = 15000) {
+        const client = await this.getOrCreateClient(this.serverConfig, timeoutMs);
+        const response = (await client.readResource({ uri }, { timeout: timeoutMs }));
+        return {
+            contents: response.contents || [],
+        };
+    }
+    // ============================================================================
+    // PROMPTS
+    // ============================================================================
+    async listPrompts(timeoutMs = 15000) {
+        const client = await this.getOrCreateClient(this.serverConfig, timeoutMs);
+        const response = (await client.listPrompts({}, { timeout: timeoutMs }));
+        return {
+            prompts: response.prompts || [],
+        };
+    }
+    async getPrompt(name, args, timeoutMs = 15000) {
+        const client = await this.getOrCreateClient(this.serverConfig, timeoutMs);
+        const response = (await client.getPrompt({ name, arguments: args }, { timeout: timeoutMs }));
+        return {
+            messages: response.messages || [],
+        };
+    }
+    // ============================================================================
+    // PRIVATE HELPERS
+    // ============================================================================
+    /**
+     * Resolve environment variable placeholders like ${VAR_NAME}
+     * @param value - String that may contain placeholders
+     * @param env - Current environment variables to resolve from
+     * @returns Resolved string with placeholders replaced
+     */
+    resolveEnvPlaceholders(value, env) {
+        return value.replace(/\$\{([^}]+)\}/g, (match, varName) => {
+            return env[varName] || match; // Replace with env value or keep placeholder if not found
+        });
+    }
+    async createClient(server, timeoutMs) {
+        const client = new Client({ name: "mcp-orbit-client", version: "1.0.0" });
+        // Wire up event handlers from SDK Client to our wrapper
+        client.onerror = (error) => {
+            this.onerror?.(error);
+        };
+        client.onclose = () => {
+            this.onclose?.();
+        };
+        // Build env: start with current process.env, then overlay server.env
+        const env = {};
+        for (const [key, value] of Object.entries(process.env)) {
+            if (value !== undefined) {
+                env[key] = value;
+            }
+        }
+        // Resolve placeholders in server.env values
+        if (server.env) {
+            for (const [key, value] of Object.entries(server.env)) {
+                env[key] = this.resolveEnvPlaceholders(value, env);
+            }
+        }
+        const transport = new StdioClientTransport({
+            command: server.command,
+            args: server.args,
+            env,
+            cwd: server.cwd,
+            stderr: "pipe", // Use "pipe" instead of "inherit" for proper error event handling
+        });
+        await client.connect(transport, { timeout: timeoutMs });
+        return client;
+    }
+    async getOrCreateClient(server, timeoutMs) {
+        const key = this.getServerKey(server);
+        const existing = this.clientCache.get(key);
+        if (existing) {
+            return existing;
+        }
+        const pending = this.connectionPromises.get(key);
+        if (pending !== undefined) {
+            return pending;
+        }
+        const connectPromise = this.createClient(server, timeoutMs)
+            .then((client) => {
+            this.connectionPromises.delete(key);
+            this.clientCache.set(key, client);
+            return client;
+        })
+            .catch((error) => {
+            this.connectionPromises.delete(key);
+            throw error;
+        });
+        this.connectionPromises.set(key, connectPromise);
+        return connectPromise;
+    }
+    getServerKey(config) {
+        return `stdio:${config.command}:${config.args?.join(",")}`;
+    }
+    async close() {
+        const closePromises = Array.from(this.clientCache.values()).map((client) => client.close().catch(() => undefined));
+        this.clientCache.clear();
+        this.connectionPromises.clear();
+        await Promise.all(closePromises);
+    }
+}
+//# sourceMappingURL=mcp-stdio.js.map

package/dist/clients/mcp-stdio.js.map

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

package/dist/clients/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * MCP Client Types & Interfaces
+ *
+ * Shared types for mcp-orbit clients
+ * Used by both real clients and mock clients
+ */
+export interface McpStdioServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+}
+export interface McpHttpServerConfig {
+    url: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+export type McpServerConfig = McpStdioServerConfig | McpHttpServerConfig;
+export interface MCPToolSchema {
+    name: string;
+    description?: string;
+    input_schema: {
+        type: "object";
+        properties?: Record<string, any>;
+        required?: string[];
+        [key: string]: any;
+    };
+    tags?: string[];
+}
+export interface MCPToolResponse {
+    content: MCPContent[];
+    isError?: boolean;
+    structuredContent?: unknown;
+    _meta?: {
+        resourceUri?: string;
+        cached?: boolean;
+        size?: number;
+        cacheExpiry?: number;
+        toolName?: string;
+    };
+}
+export interface MCPContent {
+    type: "text" | "image" | "resource";
+    text?: string;
+    data?: string;
+    mimeType?: string;
+}
+export interface MCPResource {
+    uri: string;
+    name: string;
+    description?: string;
+    title?: string;
+    mimeType?: string;
+    toolset?: string;
+    scope?: string;
+}
+export interface MCPResourceList {
+    resources: MCPResource[];
+}
+export interface MCPResourceContent {
+    contents: Array<{
+        uri: string;
+        text?: string;
+        blob?: string;
+    }>;
+}
+export interface MCPPromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+    type?: "string" | "number" | "boolean" | "array" | "object";
+}
+export interface MCPPrompt {
+    name: string;
+    description?: string;
+    arguments?: MCPPromptArgument[];
+}
+export interface MCPPromptList {
+    prompts: MCPPrompt[];
+}
+export interface MCPPromptMessage {
+    role: "user" | "assistant";
+    content: {
+        type: "text" | "image" | "resource";
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    };
+}
+export interface MCPPromptResponse {
+    messages: MCPPromptMessage[];
+}
+export interface IMcpClient {
+    listTools(timeoutMs?: number): Promise<{
+        tools: MCPToolSchema[];
+    }>;
+    callTool(toolName: string, args: Record<string, any>, timeoutMs?: number): Promise<MCPToolResponse>;
+    listResources(timeoutMs?: number): Promise<MCPResourceList>;
+    readResource(uri: string, timeoutMs?: number): Promise<MCPResourceContent>;
+    listPrompts(timeoutMs?: number): Promise<MCPPromptList>;
+    getPrompt(name: string, args?: Record<string, any>, timeoutMs?: number): Promise<MCPPromptResponse>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/clients/types.d.ts.map

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

package/dist/clients/types.js

@@ -0,0 +1,8 @@
+/**
+ * MCP Client Types & Interfaces
+ *
+ * Shared types for mcp-orbit clients
+ * Used by both real clients and mock clients
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/clients/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/clients/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/prompt-registry.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Prompt Registry - Simplified
+ *
+ * Auto-registration pattern with direct array access.
+ *
+ * Prompts = Templated messages & workflows for users
+ * - Chat templates with variables
+ * - Workflow assistants
+ * - Guided interactions
+ */
+import type { MCPPromptDefinition, PromptProvider, PromptMessage } from "./types.js";
+/**
+ * Create and register a prompt provider
+ *
+ * Usage:
+ *   const prompt = createAndRegisterPrompt({ name, description, render: async () => ({ messages }) });
+ *
+ * This function is called during prompt module imports (auto-registration pattern)
+ */
+export declare function createAndRegisterPrompt(prompt: PromptProvider): PromptProvider;
+/**
+ * Get all prompt definitions (for MCP ListPrompts response)
+ */
+export declare function getPromptDefinitions(): MCPPromptDefinition[];
+/**
+ * Get a prompt by name
+ */
+export declare function getPrompt(name: string): PromptProvider | undefined;
+/**
+ * Get a prompt with rendered messages (prompts/get)
+ *
+ * Handles:
+ * - Prompt lookup
+ * - Arguments validation via Zod schema
+ * - Template rendering
+ */
+export declare function renderPrompt(name: string, args?: Record<string, any>): Promise<{
+    messages: PromptMessage[];
+}>;
+/**
+ * Get count of registered prompts
+ */
+export declare function getPromptCount(): number;
+/**
+ * Check if a prompt exists
+ */
+export declare function hasPrompt(name: string): boolean;
+/** Singleton registry object — convenience wrapper over the named exports. */
+export declare const promptRegistry: {
+    register: typeof createAndRegisterPrompt;
+    listDefinitions: typeof getPromptDefinitions;
+    get: typeof renderPrompt;
+    readonly count: number;
+    has: typeof hasPrompt;
+};
+//# sourceMappingURL=prompt-registry.d.ts.map

package/dist/core/prompt-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-registry.d.ts","sourceRoot":"","sources":["../../src/core/prompt-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAC,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAQnF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAQ9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,EAAE,CAW5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAElE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAC,CAAC,CAoBjH;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,8EAA8E;AAC9E,eAAO,MAAM,cAAc;;;;oBAIZ,MAAM;;CAIpB,CAAC"}

package/dist/core/prompt-registry.js

@@ -0,0 +1,100 @@
+/**
+ * Prompt Registry - Simplified
+ *
+ * Auto-registration pattern with direct array access.
+ *
+ * Prompts = Templated messages & workflows for users
+ * - Chat templates with variables
+ * - Workflow assistants
+ * - Guided interactions
+ */
+import logger from "../utils/logger.js";
+const promptLogger = logger.child("prompts");
+// Global prompts array - single source of truth
+const prompts = [];
+/**
+ * Create and register a prompt provider
+ *
+ * Usage:
+ *   const prompt = createAndRegisterPrompt({ name, description, render: async () => ({ messages }) });
+ *
+ * This function is called during prompt module imports (auto-registration pattern)
+ */
+export function createAndRegisterPrompt(prompt) {
+    if (prompts.some((p) => p.name === prompt.name)) {
+        promptLogger.warn(`Prompt '${prompt.name}' already registered, overwriting...`);
+    }
+    prompts.push(prompt);
+    promptLogger.info(`Prompt registered: ${prompt.name}`);
+    return prompt;
+}
+/**
+ * Get all prompt definitions (for MCP ListPrompts response)
+ */
+export function getPromptDefinitions() {
+    return prompts.map((provider) => ({
+        name: provider.name,
+        description: provider.description,
+        arguments: provider.arguments,
+        toolset: provider.toolset,
+        tags: provider.tags,
+        category: provider.category,
+        usage: provider.usage,
+        maxTokens: provider.maxTokens,
+    }));
+}
+/**
+ * Get a prompt by name
+ */
+export function getPrompt(name) {
+    return prompts.find((p) => p.name === name);
+}
+/**
+ * Get a prompt with rendered messages (prompts/get)
+ *
+ * Handles:
+ * - Prompt lookup
+ * - Arguments validation via Zod schema
+ * - Template rendering
+ */
+export async function renderPrompt(name, args) {
+    const prompt = getPrompt(name);
+    if (!prompt) {
+        throw new Error(`Prompt not found: ${name}`);
+    }
+    // Validate arguments if schema is provided
+    if (prompt.argumentsSchema && args) {
+        try {
+            prompt.argumentsSchema.parse(args);
+        }
+        catch (error) {
+            throw new Error(`Invalid prompt arguments: ${String(error)}`);
+        }
+    }
+    // Execute prompt provider (render template)
+    const messages = await prompt.render(args);
+    return { messages };
+}
+/**
+ * Get count of registered prompts
+ */
+export function getPromptCount() {
+    return prompts.length;
+}
+/**
+ * Check if a prompt exists
+ */
+export function hasPrompt(name) {
+    return prompts.some((p) => p.name === name);
+}
+/** Singleton registry object — convenience wrapper over the named exports. */
+export const promptRegistry = {
+    register: createAndRegisterPrompt,
+    listDefinitions: getPromptDefinitions,
+    get: renderPrompt,
+    get count() {
+        return getPromptCount();
+    },
+    has: hasPrompt,
+};
+//# sourceMappingURL=prompt-registry.js.map

package/dist/core/prompt-registry.js.map

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

package/dist/core/resource-registry.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Resource Registry - Simplified with RFC 6570 Templates
+ *
+ * Auto-registration pattern with:
+ * - Direct array access for static resources
+ * - RFC 6570 URI template support for dynamic resources
+ */
+import type { MCPResource, ResourceProvider } from "./types.js";
+import { TemplateRegistry } from "./resource-uri-templates.js";
+type RegistryContentBlock = {
+    uri: string;
+    name?: string;
+    title?: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+    annotations?: MCPResource["annotations"];
+    size?: number;
+    schema?: MCPResource["schema"];
+};
+/**
+ * Create and register a resource provider
+ *
+ * Usage:
+ *   const resource = createAndRegisterResource({ uri, name, read: async () => ({ text }) });
+ *
+ * Supports both static URIs and RFC 6570 URI templates:
+ *   - Static: "cache://users/123"
+ *   - Template: "cache://users/{id}"
+ *
+ * This function is called during resource module imports (auto-registration pattern)
+ */
+export declare function createAndRegisterResource(resource: ResourceProvider): ResourceProvider;
+/**
+ * Unregister a resource by URI (used when TTL expires)
+ */
+export declare function unregisterResource(uri: string): void;
+/**
+ * Get all resource definitions (for MCP ListResources response)
+ */
+export declare function getResourceDefinitions(): MCPResource[];
+/**
+ * Get a resource by URI
+ */
+export declare function getResource(uri: string): ResourceProvider | undefined;
+/**
+ * Read a resource (resources/read)
+ */
+export declare function readResource(uri: string): Promise<{
+    contents: RegistryContentBlock[];
+}>;
+/**
+ * Get count of registered resources
+ */
+export declare function getResourceCount(): number;
+/**
+ * Check if a resource exists
+ */
+export declare function hasResource(uri: string): boolean;
+/**
+ * Get all registered RFC 6570 URI template patterns
+ */
+export declare function getTemplatePatterns(): string[];
+/**
+ * Get template registry (for advanced template operations)
+ */
+export declare function getTemplateRegistry(): TemplateRegistry;
+export declare const resourceRegistry: {
+    register: typeof createAndRegisterResource;
+    unregister: typeof unregisterResource;
+    listDefinitions: typeof getResourceDefinitions;
+    read: typeof readResource;
+    readonly count: number;
+    has: typeof hasResource;
+    getTemplates: typeof getTemplatePatterns;
+    getTemplateRegistry: typeof getTemplateRegistry;
+};
+export {};
+//# sourceMappingURL=resource-registry.d.ts.map

package/dist/core/resource-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../../src/core/resource-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAmB,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAC;AAK7D,KAAK,oBAAoB,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;CAChC,CAAC;AAQF;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,CAetF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,EAAE,CActD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAErE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAA;CAAC,CAAC,CAuB3F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD;AAED,eAAO,MAAM,gBAAgB;;;;;oBAKd,MAAM;;;;CAMpB,CAAC"}