@frontmcp/sdk 0.7.2 → 0.8.0

package/direct/client.types.d.ts

@@ -0,0 +1,447 @@
+/**
+ * Direct Client Types
+ *
+ * Types for connecting to FrontMCP servers as an MCP client with LLM-aware responses.
+ */
+import type { ServerCapabilities, Implementation, ClientCapabilities, ListResourcesResult, ReadResourceResult, ListResourceTemplatesResult, ListPromptsResult, GetPromptResult, CompleteResult, LoggingLevel } from '@modelcontextprotocol/sdk/types.js';
+import type { FormattedTools, FormattedToolResult } from './llm-platform';
+export type { FormattedTools, FormattedToolResult };
+/**
+ * Supported LLM platforms for tool/result formatting.
+ *
+ * - `openai`: OpenAI function calling format
+ * - `claude`: Anthropic Claude tool format
+ * - `langchain`: LangChain tool schema format
+ * - `vercel-ai`: Vercel AI SDK tool format
+ * - `raw`: Raw MCP protocol format (no transformation)
+ */
+export type LLMPlatform = 'openai' | 'claude' | 'langchain' | 'vercel-ai' | 'raw';
+/**
+ * Options for searching skills.
+ */
+export interface SearchSkillsOptions {
+    /** Filter by specific tags */
+    tags?: string[];
+    /** Filter by specific tools (skills must reference these tools) */
+    tools?: string[];
+    /** Maximum number of results (1-50, default: 10) */
+    limit?: number;
+    /** Require all specified tools to be available */
+    requireAllTools?: boolean;
+}
+/**
+ * A single skill search result item.
+ */
+export interface SkillSearchResultItem {
+    /** Unique skill identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description of what the skill does */
+    description: string;
+    /** Relevance score (0-1) */
+    score: number;
+    /** Tags associated with the skill */
+    tags?: string[];
+    /** Tools referenced by this skill with availability info */
+    tools: Array<{
+        name: string;
+        available: boolean;
+    }>;
+    /** Source of the skill */
+    source: 'local' | 'external';
+}
+/**
+ * Result of searching for skills.
+ */
+export interface SearchSkillsResult {
+    /** List of matching skills */
+    skills: SkillSearchResultItem[];
+    /** Total number of matching skills */
+    total: number;
+    /** Whether there are more results beyond this page */
+    hasMore: boolean;
+    /** Guidance message for using the results */
+    guidance: string;
+}
+/**
+ * Options for loading skills.
+ */
+export interface LoadSkillsOptions {
+    /** Format of the returned content */
+    format?: 'full' | 'instructions-only';
+    /** Whether to activate a skill session */
+    activateSession?: boolean;
+    /** Policy mode for the skill session */
+    policyMode?: 'strict' | 'approval' | 'permissive';
+}
+/**
+ * A single loaded skill item.
+ */
+export interface LoadedSkillItem {
+    /** Unique skill identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description of what the skill does */
+    description: string;
+    /** Instructions for using the skill */
+    instructions: string;
+    /** Tools used by this skill with their schemas */
+    tools: Array<{
+        name: string;
+        purpose?: string;
+        available: boolean;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+    }>;
+    /** Parameters that can be passed to the skill */
+    parameters?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+        type?: string;
+    }>;
+    /** Names of tools that are available */
+    availableTools: string[];
+    /** Names of tools that are missing */
+    missingTools: string[];
+    /** Whether all required tools are available */
+    isComplete: boolean;
+    /** Formatted content for LLM consumption */
+    formattedContent: string;
+    /** Session info if activateSession was true */
+    session?: {
+        activated: boolean;
+        sessionId?: string;
+        policyMode?: string;
+        allowedTools?: string[];
+    };
+}
+/**
+ * Result of loading skills.
+ */
+export interface LoadSkillsResult {
+    /** Loaded skills */
+    skills: LoadedSkillItem[];
+    /** Summary of the load operation */
+    summary: {
+        totalSkills: number;
+        totalTools: number;
+        allToolsAvailable: boolean;
+        combinedWarnings?: string[];
+    };
+    /** Guidance for next steps */
+    nextSteps: string;
+}
+/**
+ * Options for listing skills.
+ */
+export interface ListSkillsOptions {
+    /** Number of skills to skip (for pagination) */
+    offset?: number;
+    /** Maximum number of skills to return */
+    limit?: number;
+    /** Filter by specific tags */
+    tags?: string[];
+    /** Field to sort by */
+    sortBy?: 'name' | 'priority' | 'createdAt';
+    /** Sort order */
+    sortOrder?: 'asc' | 'desc';
+    /** Include hidden skills */
+    includeHidden?: boolean;
+}
+/**
+ * Result of listing skills.
+ */
+export interface ListSkillsResult {
+    /** List of skills */
+    skills: Array<{
+        id: string;
+        name: string;
+        description: string;
+        tags?: string[];
+        priority?: number;
+    }>;
+    /** Total number of skills matching the filter */
+    total: number;
+    /** Whether there are more skills beyond this page */
+    hasMore: boolean;
+}
+/**
+ * An elicitation request from the server.
+ */
+export interface ElicitationRequest {
+    /** Unique identifier for this elicitation */
+    elicitId: string;
+    /** Message to display to the user */
+    message: string;
+    /** JSON Schema for the expected response */
+    requestedSchema: Record<string, unknown>;
+    /** Mode of elicitation */
+    mode: 'form' | 'url';
+    /** Timestamp when the elicitation expires */
+    expiresAt: number;
+}
+/**
+ * Response to an elicitation request.
+ */
+export interface ElicitationResponse {
+    /** User's action */
+    action: 'accept' | 'cancel' | 'decline';
+    /** Content if action is 'accept' */
+    content?: unknown;
+}
+/**
+ * Handler function for elicitation requests.
+ */
+export type ElicitationHandler = (request: ElicitationRequest) => ElicitationResponse | Promise<ElicitationResponse>;
+/**
+ * Options for argument completion.
+ */
+export interface CompleteOptions {
+    /** Reference to the prompt or resource */
+    ref: {
+        type: 'ref/prompt';
+        name: string;
+    } | {
+        type: 'ref/resource';
+        uri: string;
+    };
+    /** The argument to complete */
+    argument: {
+        name: string;
+        value: string;
+    };
+}
+export type { CompleteResult };
+/**
+ * MCP logging levels per spec.
+ * Re-export from MCP SDK for convenience.
+ */
+export type McpLogLevel = LoggingLevel;
+/**
+ * Client info for MCP protocol handshake.
+ * Used to identify the client and detect LLM platform.
+ */
+export interface ClientInfo {
+    /** Client name (e.g., 'openai', 'my-agent') */
+    name: string;
+    /** Client version */
+    version: string;
+}
+/**
+ * Session options for connection.
+ */
+export interface SessionOptions {
+    /** Session ID (auto-generated if not provided) */
+    id?: string;
+    /** User information for auth context */
+    user?: {
+        /** User subject identifier */
+        sub?: string;
+        /** User display name */
+        name?: string;
+        /** User email */
+        email?: string;
+        /** Additional user claims */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Full connect options for generic `connect()` function.
+ *
+ * @example
+ * ```typescript
+ * const client = await connect(MyServer, {
+ *   clientInfo: { name: 'my-agent', version: '1.0.0' },
+ *   session: { id: 'session-123', user: { sub: 'user-1' } },
+ *   authToken: 'jwt-token',
+ *   capabilities: { tools: true },
+ * });
+ * ```
+ */
+export interface ConnectOptions {
+    /** MCP client info for handshake (used for platform detection) */
+    clientInfo?: ClientInfo;
+    /** Session configuration */
+    session?: SessionOptions;
+    /** Direct auth token injection (e.g., JWT) */
+    authToken?: string;
+    /** Optional client capabilities override */
+    capabilities?: Partial<ClientCapabilities>;
+}
+/**
+ * Simplified connect options for LLM-specific helpers.
+ *
+ * @example
+ * ```typescript
+ * const client = await connectOpenAI(MyServer, {
+ *   session: { id: 'session-123' },
+ *   authToken: 'jwt-token',
+ * });
+ * ```
+ */
+export interface LLMConnectOptions {
+    /** Session configuration */
+    session?: SessionOptions;
+    /** Direct auth token injection (e.g., JWT) */
+    authToken?: string;
+    /** Optional client capabilities override */
+    capabilities?: Partial<ClientCapabilities>;
+}
+/**
+ * Connected client interface for interacting with FrontMCP servers.
+ *
+ * The client provides MCP operations with responses formatted for the detected LLM platform.
+ * Tools are automatically formatted for OpenAI, Claude, LangChain, or Vercel AI SDK.
+ *
+ * @example
+ * ```typescript
+ * import { connectOpenAI } from '@frontmcp/sdk';
+ *
+ * const client = await connectOpenAI(MyServer, { authToken: 'token' });
+ *
+ * // Tools are already in OpenAI format
+ * const tools = await client.listTools();
+ *
+ * // Call and get formatted result
+ * const result = await client.callTool('weather', { city: 'NYC' });
+ *
+ * await client.close();
+ * ```
+ */
+export interface DirectClient {
+    /**
+     * List all available tools, formatted for the detected LLM platform.
+     *
+     * Return format depends on platform:
+     * - OpenAI: `[{ type: 'function', function: { name, description, parameters, strict } }]`
+     * - Claude: `[{ name, description, input_schema }]`
+     * - LangChain: `[{ name, description, schema }]`
+     * - Vercel AI: `{ [name]: { description, parameters } }`
+     * - Raw: MCP `Tool[]` format
+     */
+    listTools(): Promise<FormattedTools>;
+    /**
+     * Call a tool and get the result, formatted for the detected LLM platform.
+     *
+     * @param name - Tool name
+     * @param args - Tool arguments
+     */
+    callTool(name: string, args?: Record<string, unknown>): Promise<FormattedToolResult>;
+    /**
+     * List all available resources.
+     */
+    listResources(): Promise<ListResourcesResult>;
+    /**
+     * Read a resource by URI.
+     *
+     * @param uri - Resource URI
+     */
+    readResource(uri: string): Promise<ReadResourceResult>;
+    /**
+     * List all available resource templates.
+     */
+    listResourceTemplates(): Promise<ListResourceTemplatesResult>;
+    /**
+     * List all available prompts.
+     */
+    listPrompts(): Promise<ListPromptsResult>;
+    /**
+     * Get a prompt with arguments.
+     *
+     * @param name - Prompt name
+     * @param args - Prompt arguments
+     */
+    getPrompt(name: string, args?: Record<string, string>): Promise<GetPromptResult>;
+    /** Get the session ID for this connection */
+    getSessionId(): string;
+    /** Get the client info used for the connection */
+    getClientInfo(): ClientInfo;
+    /** Get the server info from the MCP handshake */
+    getServerInfo(): Implementation;
+    /** Get the server capabilities from the MCP handshake */
+    getCapabilities(): ServerCapabilities;
+    /** Get the detected LLM platform (based on clientInfo) */
+    getDetectedPlatform(): LLMPlatform;
+    /**
+     * Close the connection and cleanup resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Search for skills matching a query.
+     *
+     * @param query - Search query string
+     * @param options - Search options
+     * @returns Matching skills with relevance scores
+     */
+    searchSkills(query: string, options?: SearchSkillsOptions): Promise<SearchSkillsResult>;
+    /**
+     * Load one or more skills by ID.
+     *
+     * @param skillIds - Array of skill IDs to load
+     * @param options - Load options
+     * @returns Loaded skills with their content and tool info
+     */
+    loadSkills(skillIds: string[], options?: LoadSkillsOptions): Promise<LoadSkillsResult>;
+    /**
+     * List all available skills.
+     *
+     * @param options - List options (pagination, filtering)
+     * @returns Paginated list of skills
+     */
+    listSkills(options?: ListSkillsOptions): Promise<ListSkillsResult>;
+    /**
+     * Register a handler for elicitation requests.
+     *
+     * When a tool calls `this.elicit()`, the handler will be invoked with the
+     * elicitation details. Return the user's response.
+     *
+     * @param handler - Function to handle elicitation requests
+     * @returns Unsubscribe function
+     */
+    onElicitation(handler: ElicitationHandler): () => void;
+    /**
+     * Submit an elicitation result manually.
+     *
+     * Use this when handling elicitation asynchronously or through a separate channel.
+     *
+     * @param elicitId - The elicitation ID
+     * @param response - The user's response
+     */
+    submitElicitationResult(elicitId: string, response: ElicitationResponse): Promise<void>;
+    /**
+     * Request argument completion for a prompt or resource.
+     *
+     * @param options - Completion options (ref and argument)
+     * @returns Completion suggestions
+     */
+    complete(options: CompleteOptions): Promise<CompleteResult>;
+    /**
+     * Subscribe to updates for a resource.
+     *
+     * @param uri - Resource URI to subscribe to
+     */
+    subscribeResource(uri: string): Promise<void>;
+    /**
+     * Unsubscribe from updates for a resource.
+     *
+     * @param uri - Resource URI to unsubscribe from
+     */
+    unsubscribeResource(uri: string): Promise<void>;
+    /**
+     * Register a handler for resource update notifications.
+     *
+     * @param handler - Function called when a subscribed resource is updated
+     * @returns Unsubscribe function
+     */
+    onResourceUpdated(handler: (uri: string) => void): () => void;
+    /**
+     * Set the logging level for the server.
+     *
+     * @param level - The logging level
+     */
+    setLogLevel(level: McpLogLevel): Promise<void>;
+}
+//# sourceMappingURL=client.types.d.ts.map

package/direct/client.types.d.ts.map

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

package/direct/connect.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Connect Utilities
+ *
+ * Factory functions for creating DirectClient connections to FrontMCP servers.
+ * These utilities are separate from the decorator to keep @FrontMcp lean.
+ */
+import type { FrontMcpConfigInput } from '../common';
+import type { DirectClient, ConnectOptions, LLMConnectOptions } from './client.types';
+/**
+ * Connect to a FrontMCP server with full options.
+ *
+ * Creates a DirectClient that connects via in-memory transport.
+ * The client provides MCP operations with LLM-aware response formatting.
+ *
+ * @param config - FrontMCP configuration (same as @FrontMcp decorator)
+ * @param options - Connection options including clientInfo, session, and authToken
+ * @returns Connected DirectClient instance
+ *
+ * @example Basic connection
+ * ```typescript
+ * import { connect } from '@frontmcp/sdk';
+ *
+ * const client = await connect(MyServerConfig);
+ * const tools = await client.listTools();  // Raw MCP format
+ * await client.close();
+ * ```
+ *
+ * @example With auth token
+ * ```typescript
+ * const client = await connect(MyServerConfig, {
+ *   clientInfo: { name: 'my-agent', version: '1.0.0' },
+ *   session: { id: 'session-123', user: { sub: 'user-1' } },
+ *   authToken: 'jwt-token',
+ * });
+ * ```
+ *
+ * @example With custom client info (for platform detection)
+ * ```typescript
+ * const client = await connect(MyServerConfig, {
+ *   clientInfo: { name: 'openai-agent', version: '1.0.0' },
+ * });
+ * // Tools will be formatted for OpenAI
+ * const tools = await client.listTools();
+ * ```
+ */
+export declare function connect(config: FrontMcpConfigInput, options?: ConnectOptions): Promise<DirectClient>;
+/**
+ * Connect to a FrontMCP server as an OpenAI client.
+ *
+ * Tools are automatically formatted for OpenAI function calling:
+ * ```json
+ * [{
+ *   "type": "function",
+ *   "function": {
+ *     "name": "tool_name",
+ *     "description": "Tool description",
+ *     "parameters": { ... },
+ *     "strict": true
+ *   }
+ * }]
+ * ```
+ *
+ * @param config - FrontMCP configuration
+ * @param options - Connection options (session, authToken)
+ * @returns Connected DirectClient with OpenAI formatting
+ *
+ * @example
+ * ```typescript
+ * import { connectOpenAI } from '@frontmcp/sdk';
+ * import OpenAI from 'openai';
+ *
+ * const client = await connectOpenAI(MyServerConfig, {
+ *   authToken: 'user-jwt-token',
+ *   session: { id: 'user-123' },
+ * });
+ *
+ * const openai = new OpenAI();
+ * const tools = await client.listTools();  // Already OpenAI format!
+ *
+ * const response = await openai.chat.completions.create({
+ *   model: 'gpt-4-turbo',
+ *   tools,
+ *   messages: [{ role: 'user', content: 'What is the weather?' }],
+ * });
+ *
+ * await client.close();
+ * ```
+ */
+export declare function connectOpenAI(config: FrontMcpConfigInput, options?: LLMConnectOptions): Promise<DirectClient>;
+/**
+ * Connect to a FrontMCP server as a Claude client.
+ *
+ * Tools are automatically formatted for Anthropic Claude:
+ * ```json
+ * [{
+ *   "name": "tool_name",
+ *   "description": "Tool description",
+ *   "input_schema": { ... }
+ * }]
+ * ```
+ *
+ * @param config - FrontMCP configuration
+ * @param options - Connection options (session, authToken)
+ * @returns Connected DirectClient with Claude formatting
+ *
+ * @example
+ * ```typescript
+ * import { connectClaude } from '@frontmcp/sdk';
+ * import Anthropic from '@anthropic-ai/sdk';
+ *
+ * const client = await connectClaude(MyServerConfig, { authToken: 'token' });
+ * const tools = await client.listTools();  // Claude format
+ *
+ * const anthropic = new Anthropic();
+ * const response = await anthropic.messages.create({
+ *   model: 'claude-3-opus-20240229',
+ *   tools,
+ *   messages: [{ role: 'user', content: 'What is the weather?' }],
+ * });
+ *
+ * await client.close();
+ * ```
+ */
+export declare function connectClaude(config: FrontMcpConfigInput, options?: LLMConnectOptions): Promise<DirectClient>;
+/**
+ * Connect to a FrontMCP server as a LangChain client.
+ *
+ * Tools are automatically formatted for LangChain:
+ * ```json
+ * [{
+ *   "name": "tool_name",
+ *   "description": "Tool description",
+ *   "schema": { ... }
+ * }]
+ * ```
+ *
+ * @param config - FrontMCP configuration
+ * @param options - Connection options (session, authToken)
+ * @returns Connected DirectClient with LangChain formatting
+ *
+ * @example
+ * ```typescript
+ * import { connectLangChain } from '@frontmcp/sdk';
+ *
+ * const client = await connectLangChain(MyServerConfig);
+ * const tools = await client.listTools();  // LangChain format
+ *
+ * // Use with LangChain agent
+ * await client.close();
+ * ```
+ */
+export declare function connectLangChain(config: FrontMcpConfigInput, options?: LLMConnectOptions): Promise<DirectClient>;
+/**
+ * Connect to a FrontMCP server as a Vercel AI SDK client.
+ *
+ * Tools are automatically formatted for Vercel AI SDK:
+ * ```json
+ * {
+ *   "tool_name": {
+ *     "description": "Tool description",
+ *     "parameters": { ... }
+ *   }
+ * }
+ * ```
+ *
+ * @param config - FrontMCP configuration
+ * @param options - Connection options (session, authToken)
+ * @returns Connected DirectClient with Vercel AI SDK formatting
+ *
+ * @example
+ * ```typescript
+ * import { connectVercelAI } from '@frontmcp/sdk';
+ * import { generateText } from 'ai';
+ *
+ * const client = await connectVercelAI(MyServerConfig);
+ * const tools = await client.listTools();  // Vercel AI SDK format
+ *
+ * const { text } = await generateText({
+ *   model: openai('gpt-4-turbo'),
+ *   tools,
+ *   prompt: 'What is the weather?',
+ * });
+ *
+ * await client.close();
+ * ```
+ */
+export declare function connectVercelAI(config: FrontMcpConfigInput, options?: LLMConnectOptions): Promise<DirectClient>;
+//# sourceMappingURL=connect.d.ts.map

package/direct/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/direct/connect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA+CtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAI1G;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKnH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKnH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKrH"}

package/direct/direct-client.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Direct Client Implementation
+ *
+ * Connects to a FrontMCP server as an MCP client with LLM-aware response formatting.
+ */
+export {};
+//# sourceMappingURL=direct-client.d.ts.map

package/direct/direct-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-client.d.ts","sourceRoot":"","sources":["../../src/direct/direct-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}