@frontmcp/sdk 0.7.2 → 0.8.0

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/sdk",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "FrontMCP SDK",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -52,13 +52,18 @@
     },
     "./esm": null
   },
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "peerDependencies": {
     "zod": "^4.0.0",
+    "zod-from-json-schema": "^0.5.2",
     "express": "^4.18.0 || ^5.0.0",
     "cors": "^2.8.5",
     "raw-body": "^3.0.0",
     "content-type": "^1.0.5",
-    "@vercel/kv": "^2.0.0 || ^3.0.0"
+    "vectoriadb": "^2.0.2",
+    "@vercel/kv": "^3.0.0"
   },
   "peerDependenciesMeta": {
     "@vercel/kv": {
@@ -66,14 +71,16 @@
     }
   },
   "dependencies": {
-    "@frontmcp/utils": "0.7.2",
-    "@frontmcp/di": "0.7.2",
-    "@frontmcp/uipack": "0.7.2",
-    "@modelcontextprotocol/sdk": "1.25.1",
+    "@frontmcp/utils": "0.8.0",
+    "@frontmcp/di": "0.8.0",
+    "@frontmcp/uipack": "0.8.0",
+    "@frontmcp/auth": "0.8.0",
+    "@modelcontextprotocol/sdk": "1.25.3",
     "@langchain/core": "^1.1.8",
     "@langchain/openai": "^1.2.0",
     "@langchain/anthropic": "^1.3.3",
     "ioredis": "^5.8.0",
+    "js-yaml": "^4.1.1",
     "jose": "^6.1.3",
     "reflect-metadata": "^0.2.2"
   },
@@ -83,7 +90,6 @@
     "@langchain/groq": "^1.0.2"
   },
   "devDependencies": {
-    "@vercel/kv": "^3.0.0",
     "typescript": "^5.9.3"
   }
 }

package/ext-apps/ext-apps.handler.d.ts

@@ -0,0 +1,177 @@
+/**
+ * MCP Apps (ext-apps) Message Handler
+ *
+ * Server-side handler for bidirectional communication with ext-apps widgets.
+ * Processes JSON-RPC requests from widgets and routes them to appropriate handlers.
+ *
+ * @see https://github.com/modelcontextprotocol/ext-apps
+ * @packageDocumentation
+ */
+import type { FrontMcpLogger } from '../common';
+import type { ExtAppsJsonRpcRequest, ExtAppsJsonRpcResponse, ExtAppsHostCapabilities } from './ext-apps.types';
+/**
+ * Context for handling ext-apps messages.
+ * Provides access to scope services for routing requests.
+ */
+export interface ExtAppsHandlerContext {
+    /** Session ID for this widget connection */
+    sessionId: string;
+    /** Logger instance */
+    logger: FrontMcpLogger;
+    /** Call a tool by name */
+    callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    /** Update model context (optional - host may not support) */
+    updateModelContext?: (context: unknown, merge: boolean) => Promise<void>;
+    /** Open a link (optional - host may not support) */
+    openLink?: (url: string) => Promise<void>;
+    /** Request display mode change (optional - host may not support) */
+    setDisplayMode?: (mode: string) => Promise<void>;
+    /** Close the widget (optional - host may not support) */
+    close?: (reason?: string) => Promise<void>;
+    /** Register a widget-defined tool (optional - host may not support) */
+    registerTool?: (name: string, description: string, inputSchema: Record<string, unknown>) => Promise<void>;
+    /** Unregister a widget-defined tool (optional - host may not support) */
+    unregisterTool?: (name: string) => Promise<void>;
+}
+/**
+ * Options for creating an ExtAppsMessageHandler.
+ */
+export interface ExtAppsMessageHandlerOptions {
+    /** Handler context with routing capabilities */
+    context: ExtAppsHandlerContext;
+    /** Host capabilities to advertise */
+    hostCapabilities?: ExtAppsHostCapabilities;
+}
+/**
+ * Message handler for ext-apps widget-to-host JSON-RPC communication.
+ *
+ * Handles all JSON-RPC methods defined in the MCP Apps specification:
+ * - ui/callServerTool - Proxy tool calls to the MCP server
+ * - ui/updateModelContext - Update the model context with widget state
+ * - ui/openLink - Request to open a URL
+ * - ui/setDisplayMode - Request display mode change
+ * - ui/close - Close the widget
+ * - ui/log - Forward logs to server logger
+ * - ui/registerTool - Register a widget-defined tool
+ * - ui/unregisterTool - Unregister a widget-defined tool
+ *
+ * @example
+ * ```typescript
+ * import { ExtAppsMessageHandler } from '@frontmcp/sdk/ext-apps';
+ *
+ * const handler = new ExtAppsMessageHandler({
+ *   context: {
+ *     sessionId: 'session-123',
+ *     logger: scopeLogger,
+ *     callTool: async (name, args) => {
+ *       // Route to tool call flow
+ *       return scope.flows.run('tools:call-tool', { name, args });
+ *     },
+ *   },
+ *   hostCapabilities: {
+ *     serverToolProxy: true,
+ *     logging: true,
+ *   },
+ * });
+ *
+ * // Handle incoming request
+ * const response = await handler.handleRequest(request);
+ * ```
+ */
+export declare class ExtAppsMessageHandler {
+    private readonly context;
+    private readonly hostCapabilities;
+    private readonly logger;
+    constructor(options: ExtAppsMessageHandlerOptions);
+    /**
+     * Get the host capabilities for this handler.
+     */
+    getHostCapabilities(): ExtAppsHostCapabilities;
+    /**
+     * Handle a JSON-RPC request from a widget.
+     *
+     * @param request - The JSON-RPC request
+     * @returns The JSON-RPC response
+     */
+    handleRequest(request: ExtAppsJsonRpcRequest): Promise<ExtAppsJsonRpcResponse>;
+    /**
+     * Route a method to its handler.
+     */
+    private routeMethod;
+    /**
+     * Handle ui/initialize - Protocol handshake with widget.
+     * Returns host capabilities and initial context.
+     */
+    private handleInitialize;
+    /**
+     * Handle ui/callServerTool - Route tool call to MCP server.
+     */
+    private handleCallServerTool;
+    /**
+     * Handle ui/updateModelContext - Update model context with widget state.
+     */
+    private handleUpdateModelContext;
+    /**
+     * Handle ui/openLink - Request to open a URL.
+     */
+    private handleOpenLink;
+    /**
+     * Handle ui/setDisplayMode - Request display mode change.
+     */
+    private handleSetDisplayMode;
+    /**
+     * Handle ui/close - Close the widget.
+     */
+    private handleClose;
+    /**
+     * Handle ui/log - Forward logs to server logger.
+     */
+    private handleLog;
+    /**
+     * Handle ui/registerTool - Register a widget-defined tool.
+     */
+    private handleRegisterTool;
+    /**
+     * Handle ui/unregisterTool - Unregister a widget-defined tool.
+     */
+    private handleUnregisterTool;
+    /**
+     * Get the appropriate error code for an error.
+     */
+    private getErrorCode;
+}
+/**
+ * Base class for ext-apps errors.
+ */
+export declare class ExtAppsError extends Error {
+    constructor(message: string);
+}
+/**
+ * Method not found error.
+ */
+export declare class ExtAppsMethodNotFoundError extends ExtAppsError {
+    constructor(message: string);
+}
+/**
+ * Invalid params error.
+ */
+export declare class ExtAppsInvalidParamsError extends ExtAppsError {
+    constructor(message: string);
+}
+/**
+ * Feature not supported error.
+ */
+export declare class ExtAppsNotSupportedError extends ExtAppsError {
+    constructor(message: string);
+}
+/**
+ * Tool not found error.
+ */
+export declare class ExtAppsToolNotFoundError extends ExtAppsError {
+    constructor(message: string);
+}
+/**
+ * Factory function for creating an ExtAppsMessageHandler.
+ */
+export declare function createExtAppsMessageHandler(options: ExtAppsMessageHandlerOptions): ExtAppsMessageHandler;
+//# sourceMappingURL=ext-apps.handler.d.ts.map

package/ext-apps/ext-apps.handler.d.ts.map

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

package/ext-apps/ext-apps.types.d.ts

@@ -0,0 +1,273 @@
+/**
+ * MCP Apps (ext-apps) Type Definitions
+ *
+ * Types for the MCP Apps Extension protocol (SEP-1865) bidirectional
+ * communication between embedded widgets and AI hosts.
+ *
+ * @see https://github.com/modelcontextprotocol/ext-apps
+ * @packageDocumentation
+ */
+/**
+ * Parameters for ui/callServerTool request.
+ * Widget requests the host to invoke a server tool.
+ */
+export interface ExtAppsCallServerToolParams {
+    /** Tool name to invoke */
+    name: string;
+    /** Tool arguments */
+    arguments?: Record<string, unknown>;
+}
+/**
+ * Parameters for ui/updateModelContext request.
+ * Widget updates the model context with new state.
+ */
+export interface ExtAppsUpdateModelContextParams {
+    /** Context data to update */
+    context: unknown;
+    /** Whether to merge with existing context (default: true) */
+    merge?: boolean;
+}
+/**
+ * Parameters for ui/openLink request.
+ * Widget requests the host to open a URL.
+ */
+export interface ExtAppsOpenLinkParams {
+    /** URL to open */
+    url: string;
+}
+/**
+ * Display mode options for ext-apps widgets.
+ */
+export type ExtAppsDisplayMode = 'inline' | 'fullscreen' | 'pip';
+/**
+ * Parameters for ui/setDisplayMode request.
+ * Widget requests a display mode change.
+ */
+export interface ExtAppsSetDisplayModeParams {
+    /** Desired display mode */
+    mode: ExtAppsDisplayMode;
+}
+/**
+ * Parameters for ui/close request.
+ * Widget requests to be closed.
+ */
+export interface ExtAppsCloseParams {
+    /** Optional reason for closing */
+    reason?: string;
+}
+/**
+ * Log levels for ext-apps logging.
+ */
+export type ExtAppsLogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Parameters for ui/log request.
+ * Widget sends a log message to the host.
+ */
+export interface ExtAppsLogParams {
+    /** Log level */
+    level: ExtAppsLogLevel;
+    /** Log message */
+    message: string;
+    /** Optional additional data */
+    data?: unknown;
+}
+/**
+ * Parameters for ui/registerTool request.
+ * Widget registers a tool it provides.
+ */
+export interface ExtAppsRegisterToolParams {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Tool input schema (JSON Schema format) */
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * Parameters for ui/unregisterTool request.
+ * Widget unregisters a tool it previously registered.
+ */
+export interface ExtAppsUnregisterToolParams {
+    /** Tool name to unregister */
+    name: string;
+}
+/**
+ * Host capabilities advertised during initialization.
+ * These capabilities are returned by the host in the ui/initialize response.
+ */
+export interface ExtAppsHostCapabilities {
+    /** Host supports proxying tool calls to the MCP server */
+    serverToolProxy?: boolean;
+    /** Host supports opening links */
+    openLink?: boolean;
+    /** Host supports model context updates */
+    modelContextUpdate?: boolean;
+    /** Host supports widget-defined tools */
+    widgetTools?: boolean;
+    /** Supported display modes */
+    displayModes?: ExtAppsDisplayMode[];
+    /** Host supports logging */
+    logging?: boolean;
+}
+/**
+ * Widget capabilities advertised during initialization.
+ * These capabilities are sent by the widget in the ui/initialize request.
+ */
+export interface ExtAppsWidgetCapabilities {
+    /** Widget tools configuration */
+    tools?: {
+        /** Widget can emit tool list changes (dynamic tool registration) */
+        listChanged?: boolean;
+    };
+    /** Widget supports partial input streaming */
+    supportsPartialInput?: boolean;
+}
+/**
+ * App info provided during initialization.
+ */
+export interface ExtAppsAppInfo {
+    /** Application name */
+    name: string;
+    /** Application version */
+    version: string;
+}
+/**
+ * Host context provided during initialization.
+ */
+export interface ExtAppsHostContext {
+    /** Current theme */
+    theme?: 'light' | 'dark' | 'system';
+    /** Current display mode */
+    displayMode?: ExtAppsDisplayMode;
+    /** Viewport dimensions */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** User locale */
+    locale?: string;
+    /** User timezone */
+    timezone?: string;
+}
+/**
+ * Parameters for ui/initialize request.
+ */
+export interface ExtAppsInitializeParams {
+    /** Widget app info */
+    appInfo: ExtAppsAppInfo;
+    /** Widget capabilities */
+    appCapabilities: ExtAppsWidgetCapabilities;
+    /** Protocol version */
+    protocolVersion: string;
+}
+/**
+ * Result of ui/initialize request.
+ */
+export interface ExtAppsInitializeResult {
+    /** Host capabilities */
+    hostCapabilities: ExtAppsHostCapabilities;
+    /** Initial host context */
+    hostContext?: ExtAppsHostContext;
+    /** Protocol version acknowledged */
+    protocolVersion: string;
+}
+/**
+ * Parameters for ui/notifications/tool-input notification.
+ */
+export interface ExtAppsToolInputNotification {
+    /** Tool input arguments */
+    arguments: Record<string, unknown>;
+}
+/**
+ * Parameters for ui/notifications/tool-result notification.
+ */
+export interface ExtAppsToolResultNotification {
+    /** Tool result content */
+    content: unknown;
+    /** Structured content for widget rendering */
+    structuredContent?: unknown;
+}
+/**
+ * Parameters for ui/notifications/host-context-changed notification.
+ */
+export interface ExtAppsHostContextChangedNotification {
+    /** Updated theme */
+    theme?: 'light' | 'dark' | 'system';
+    /** Updated display mode */
+    displayMode?: ExtAppsDisplayMode;
+    /** Updated viewport */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Updated locale */
+    locale?: string;
+    /** Updated timezone */
+    timezone?: string;
+}
+/**
+ * Parameters for ui/notifications/cancelled notification.
+ */
+export interface ExtAppsCancelledNotification {
+    /** Cancellation reason */
+    reason?: string;
+}
+/**
+ * JSON-RPC 2.0 request.
+ */
+export interface ExtAppsJsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: unknown;
+}
+/**
+ * JSON-RPC 2.0 response.
+ */
+export interface ExtAppsJsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * JSON-RPC 2.0 notification (no id, no response expected).
+ */
+export interface ExtAppsJsonRpcNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown;
+}
+/**
+ * Union type for all JSON-RPC messages.
+ */
+export type ExtAppsJsonRpcMessage = ExtAppsJsonRpcRequest | ExtAppsJsonRpcResponse | ExtAppsJsonRpcNotification;
+/**
+ * Standard JSON-RPC error codes for ext-apps.
+ */
+export declare const EXT_APPS_ERROR_CODES: {
+    /** Invalid JSON was received */
+    readonly PARSE_ERROR: -32700;
+    /** The JSON sent is not a valid Request object */
+    readonly INVALID_REQUEST: -32600;
+    /** The method does not exist or is not available */
+    readonly METHOD_NOT_FOUND: -32601;
+    /** Invalid method parameter(s) */
+    readonly INVALID_PARAMS: -32602;
+    /** Internal JSON-RPC error */
+    readonly INTERNAL_ERROR: -32603;
+    /** Tool not found */
+    readonly TOOL_NOT_FOUND: -32001;
+    /** Tool execution failed */
+    readonly TOOL_EXECUTION_FAILED: -32002;
+    /** Feature not supported */
+    readonly NOT_SUPPORTED: -32003;
+    /** Operation cancelled */
+    readonly CANCELLED: -32004;
+};
+export type ExtAppsErrorCode = (typeof EXT_APPS_ERROR_CODES)[keyof typeof EXT_APPS_ERROR_CODES];
+//# sourceMappingURL=ext-apps.types.d.ts.map

package/ext-apps/ext-apps.types.d.ts.map

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

package/ext-apps/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP Apps (ext-apps) Module
+ *
+ * Server-side support for the MCP Apps Extension protocol (SEP-1865).
+ * Provides types and handlers for bidirectional communication between
+ * embedded widgets and AI hosts.
+ *
+ * @packageDocumentation
+ */
+export type { ExtAppsCallServerToolParams, ExtAppsUpdateModelContextParams, ExtAppsOpenLinkParams, ExtAppsDisplayMode, ExtAppsSetDisplayModeParams, ExtAppsCloseParams, ExtAppsLogLevel, ExtAppsLogParams, ExtAppsRegisterToolParams, ExtAppsUnregisterToolParams, ExtAppsHostCapabilities, ExtAppsWidgetCapabilities, ExtAppsAppInfo, ExtAppsHostContext, ExtAppsInitializeParams, ExtAppsInitializeResult, ExtAppsToolInputNotification, ExtAppsToolResultNotification, ExtAppsHostContextChangedNotification, ExtAppsCancelledNotification, ExtAppsJsonRpcRequest, ExtAppsJsonRpcResponse, ExtAppsJsonRpcNotification, ExtAppsJsonRpcMessage, ExtAppsErrorCode, } from './ext-apps.types';
+export { EXT_APPS_ERROR_CODES } from './ext-apps.types';
+export { ExtAppsMessageHandler, createExtAppsMessageHandler, type ExtAppsHandlerContext, type ExtAppsMessageHandlerOptions, ExtAppsError, ExtAppsMethodNotFoundError, ExtAppsInvalidParamsError, ExtAppsNotSupportedError, ExtAppsToolNotFoundError, } from './ext-apps.handler';
+//# sourceMappingURL=index.d.ts.map

package/ext-apps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ext-apps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAEV,2BAA2B,EAC3B,+BAA+B,EAC/B,qBAAqB,EAErB,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAElB,eAAe,EACf,gBAAgB,EAEhB,yBAAyB,EACzB,2BAA2B,EAE3B,uBAAuB,EACvB,yBAAyB,EAEzB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EAEvB,4BAA4B,EAC5B,6BAA6B,EAC7B,qCAAqC,EACrC,4BAA4B,EAE5B,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAE3B,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EAEjC,YAAY,EACZ,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/flows/flow.instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow.instance.d.ts","sourceRoot":"","sources":["../../src/flows/flow.instance.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAIL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,EAEZ,UAAU,EAKV,SAAS,EACT,aAAa,EACb,KAAK,EACL,IAAI,EACL,MAAM,WAAW,CAAC;AACnB,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AA4BjC,qBAAa,YAAY,CAAC,IAAI,SAAS,QAAQ,CAAE,SAAQ,SAAS,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAe;gBAEhB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB;cAUrF,UAAU;IA4DpB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;OASG;YACW,cAAc;IAiCtB,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CAsTrG"}
+{"version":3,"file":"flow.instance.d.ts","sourceRoot":"","sources":["../../src/flows/flow.instance.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAIL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,EAEZ,UAAU,EAKV,SAAS,EACT,aAAa,EACb,KAAK,EACL,IAAI,EACL,MAAM,WAAW,CAAC;AACnB,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AA4BjC,qBAAa,YAAY,CAAC,IAAI,SAAS,QAAQ,CAAE,SAAQ,SAAS,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAe;gBAEhB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB;cAUrF,UAAU;IA4DpB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;OASG;YACW,cAAc;IAiCtB,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CA4TrG"}

package/front-mcp/front-mcp.d.ts

@@ -1,4 +1,5 @@
-import { FrontMcpConfigType, FrontMcpInterface, ScopeEntry } from '../common';
+import { FrontMcpConfigInput, FrontMcpConfigType, FrontMcpInterface, ScopeEntry } from '../common';
+import type { DirectMcpServer } from '../direct';
 export declare class FrontMcpInstance implements FrontMcpInterface {
     config: FrontMcpConfigType;
     readonly ready: Promise<void>;
@@ -39,6 +40,67 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
      * const instance = await FrontMcpInstance.createForGraph(config);
      * const scopes = instance.getScopes();
      */
-    static createForGraph(options: FrontMcpConfigType): Promise<FrontMcpInstance>;
+    static createForGraph(options: FrontMcpConfigInput): Promise<FrontMcpInstance>;
+    /**
+     * Creates a DirectMcpServer from a FrontMCP configuration.
+     * This provides direct programmatic access to MCP operations
+     * without requiring HTTP transport.
+     *
+     * Use cases:
+     * - Unit/integration testing tools, resources, prompts
+     * - Embedding MCP capabilities in other applications
+     * - CLI tools that need direct access
+     * - Agent backends with custom invocation
+     *
+     * @example
+     * ```typescript
+     * import { FrontMcpInstance } from '@frontmcp/sdk';
+     * import MyServer from './my-server';
+     *
+     * const server = await FrontMcpInstance.createDirect(MyServer);
+     *
+     * // List all tools
+     * const tools = await server.listTools();
+     *
+     * // Call a tool with auth context
+     * const result = await server.callTool('my-tool', { param: 'value' }, {
+     *   authContext: { sessionId: 'user-123', token: 'jwt-token' }
+     * });
+     *
+     * // Cleanup when done
+     * await server.dispose();
+     * ```
+     */
+    static createDirect(options: FrontMcpConfigInput): Promise<DirectMcpServer>;
+    /**
+     * Runs the FrontMCP server using stdio transport for use with Claude Code
+     * or other MCP clients that support stdio communication.
+     *
+     * This method connects the server to stdin/stdout and handles MCP protocol
+     * messages directly. It does not return until the connection is closed.
+     *
+     * @example
+     * ```typescript
+     * // In your CLI entrypoint
+     * import { FrontMcpInstance } from '@frontmcp/sdk';
+     * import MyServer from './my-server';
+     *
+     * FrontMcpInstance.runStdio(MyServer);
+     * ```
+     *
+     * @example
+     * ```bash
+     * # In Claude Desktop config:
+     * {
+     *   "mcpServers": {
+     *     "my-server": {
+     *       "command": "node",
+     *       "args": ["./dist/main.js", "--stdio"]
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    static runStdio(options: FrontMcpConfigInput): Promise<void>;
 }
 //# sourceMappingURL=front-mcp.d.ts.map

package/front-mcp/front-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.d.ts","sourceRoot":"","sources":["../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAkB,UAAU,EAAE,MAAM,WAAW,CAAC;AAM9F,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,kBAAkB;IAKhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,KAAK;IAQL;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;;OAGG;IACH,SAAS,IAAI,UAAU,EAAE;WAIL,SAAS,CAAC,OAAO,EAAE,kBAAkB;IAOzD;;;;;;;;;;OAUG;WACiB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAahF;;;;;;;;OAQG;WACiB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAK3F"}
+{"version":3,"file":"front-mcp.d.ts","sourceRoot":"","sources":["../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EAEjB,UAAU,EAEX,MAAM,WAAW,CAAC;AAMnB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAKjD,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,kBAAkB;IAKhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,KAAK;IAQL;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;;OAGG;IACH,SAAS,IAAI,UAAU,EAAE;WAIL,SAAS,CAAC,OAAO,EAAE,kBAAkB;IAOzD;;;;;;;;;;OAUG;WACiB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAahF;;;;;;;;OAQG;WACiB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoBxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACiB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CA0G1E"}